14 KiB
OpenWrt Remote Hub
Удаленный доступ к OpenWrt через свой VPS: карточки роутеров, online/offline, LuCI-админка, SSH web-terminal и Xray VLESS reverse-туннели.
Что это
Схема работы:
Браузер -> VPS Hub -> Xray reverse -> OpenWrt LuCI / SSH
Роутер сам подключается к VPS изнутри сети. Наружу LuCI и SSH на роутере открывать не нужно.
В панели VPS можно:
- видеть все роутеры красивыми карточками;
- смотреть online/offline, модель, OpenWrt, Xray, uptime, RAM, flash, температуру и load;
- открывать LuCI кнопкой
Админка; - открывать SSH прямо в браузере кнопкой
SSH; - получать готовые OpenWrt config-команды для каждого роутера;
- обновлять и перезапускать Xray на VPS кнопками в панели.
Первый вход в Hub:
логин: admin
пароль: admin
Пароль можно поменять в панели Hub.
Быстрая установка VPS
Подходит для Ubuntu/Debian VPS. Команды выполнять под root или через sudo.
Самый простой вариант - одна команда. Она поставит зависимости, скачает Hub, запустит сервис, откроет порты в ufw и в конце покажет ссылку панели и вход admin/admin.
curl -fsSL https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh | sudo sh
После успешной установки в конце будет примерно так:
OpenWrt Remote Hub установлен
Панель:
http://YOUR_VPS_IP/
http://YOUR_VPS_IP:8088/
Вход:
login: admin
password: admin
Если хочешь явно указать IP или домен:
curl -fsSL https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh | sudo sh -s -- YOUR_VPS_IP
Если ставишь повторно и хочешь снова сбросить вход на admin/admin, ничего дополнительно делать не надо: установщик по умолчанию выставляет admin/admin.
Если не хочешь сбрасывать текущий пароль:
curl -fsSL https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh | sudo env RESET_LOGIN=0 sh
Ручная установка, если нужна:
VPS_HOST="YOUR_VPS_IP"
sudo apt update
sudo apt install -y curl wget unzip python3 openssh-client ca-certificates ufw
sudo mkdir -p /opt/owrt-remote /var/lib/owrt-remote /etc/xray
sudo wget -O /opt/owrt-remote/owrt-remote-hub.py \
"https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/owrt-remote-hub.py"
sudo wget -O /etc/systemd/system/owrt-remote.service \
"https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/owrt-remote.service"
sudo chmod +x /opt/owrt-remote/owrt-remote-hub.py
sudo /opt/owrt-remote/owrt-remote-hub.py init
sudo /opt/owrt-remote/owrt-remote-hub.py set-login --username admin --password admin
sudo systemctl daemon-reload
sudo systemctl enable --now owrt-remote
sudo systemctl restart owrt-remote
sudo ufw allow 80/tcp
sudo ufw allow 8088/tcp
sudo ufw allow 8443/tcp
Проверь, что панель поднялась:
sudo systemctl status owrt-remote --no-pager -l
sudo ss -lntp | grep -E ':(80|8088)\b'
curl -sS http://127.0.0.1:8088/health
Нормальный ответ health:
{"ok":true}
Открыть панель:
http://YOUR_VPS_IP/
http://YOUR_VPS_IP:8088/
Если с домашнего интернета открывается, а с мобильного нет, чаще всего мобильный оператор или firewall VPS режет порт. Открой в личном кабинете VPS-провайдера:
80/tcp
8088/tcp
8443/tcp
Важно: ufw allow открывает firewall внутри Ubuntu, но у многих VPS есть еще отдельный firewall в личном кабинете.
Если после ручной установки панель не открывается и видно owrt-remote.service inactive (dead), запусти:
sudo systemctl enable --now owrt-remote
sudo systemctl restart owrt-remote
sudo systemctl status owrt-remote --no-pager -l
curl -sS http://127.0.0.1:8088/health
Установка Xray на VPS
sudo bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ install
xray version || /usr/local/bin/xray version
Создай systemd-сервис для Xray reverse:
XRAY_BIN="$(command -v xray || command -v /usr/local/bin/xray || command -v /usr/bin/xray)"
sudo tee /etc/systemd/system/owrt-remote-xray.service >/dev/null <<EOF
[Unit]
Description=OpenWrt Remote Xray Reverse
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
ExecStart=$XRAY_BIN run -config /etc/xray/owrt-remote.json
Restart=on-failure
RestartSec=3
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now owrt-remote-xray
Добавить первый роутер
На VPS:
VPS_HOST="YOUR_VPS_IP"
sudo /opt/owrt-remote/owrt-remote-hub.py add-router \
--id main \
--name "Главный роутер" \
--role main \
--entry-port 18080 \
--vps-host "$VPS_HOST"
sudo /opt/owrt-remote/owrt-remote-hub.py render-xray --out /etc/xray/owrt-remote.json
sudo systemctl restart owrt-remote-xray
Потом открой Hub, нажми у роутера OpenWrt config, скопируй команды и вставь их в SSH роутера.
Либо вывести команды прямо на VPS:
sudo /opt/owrt-remote/owrt-remote-hub.py print-openwrt-config \
--id main \
--hub-url "http://$VPS_HOST:8088" \
--vps-host "$VPS_HOST"
Установка агента на OpenWrt
На роутере:
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/install.sh?v=$(date +%s)" | sh
После установки:
owrt-remote doctor
owrt-remote status
Если Xray не помещается в память через opkg, можно поставить временный Xray в /tmp кнопкой Поставить Xray в /tmp в панели роутера. После ребута агент сам восстановит Xray в /tmp, если он пропал.
Если вставил OpenWrt config с VPS:
owrt-remote render-client
/etc/init.d/owrt-remote enable
/etc/init.d/owrt-remote restart
owrt-remote heartbeat
В Hub карточка роутера должна стать online.
Добавить второй и следующие роутеры
Каждому роутеру нужен свой id и свой entry-port.
Пример второго роутера:
VPS_HOST="YOUR_VPS_IP"
sudo /opt/owrt-remote/owrt-remote-hub.py add-router \
--id node-2 \
--name "Второй роутер" \
--role node \
--entry-port 18090 \
--vps-host "$VPS_HOST"
sudo /opt/owrt-remote/owrt-remote-hub.py render-xray --out /etc/xray/owrt-remote.json
sudo systemctl restart owrt-remote-xray
Порты:
| Что | Пример | Для чего |
|---|---|---|
entry-port |
18080, 18090, 18100 |
LuCI каждого роутера через VPS |
ssh-entry-port |
19080, 19090, 19100 |
SSH web-terminal, создается как entry-port + 1000 |
vps-port |
8443 |
Xray VLESS reverse на VPS |
admin-port |
80 |
LuCI внутри OpenWrt |
ssh-port |
22 |
Dropbear/SSH внутри OpenWrt |
Наружу открывать надо только:
80/tcp - Hub с телефона и браузера
8088/tcp - Hub напрямую
8443/tcp - Xray reverse
Порты 18080, 18090, 19080, 19090 должны слушать только 127.0.0.1 на VPS. Их наружу открывать не надо.
Проверка после установки
На VPS:
sudo systemctl status owrt-remote --no-pager -l
sudo systemctl status owrt-remote-xray --no-pager -l
sudo ss -lntp | grep -E ':(80|8088|8443|18080|18090|19080|19090)\b'
curl -sS http://127.0.0.1:8088/health
Должно быть:
owrt-remoteactive/running;owrt-remote-xrayactive/running;*:80или0.0.0.0:80;*:8088или0.0.0.0:8088;*:8443;127.0.0.1:18080для LuCI первого роутера;127.0.0.1:19080для SSH первого роутера.
На OpenWrt:
owrt-remote doctor
owrt-remote status
owrt-remote heartbeat
Частые проблемы
Панель VPS не открывается
Проверь сервис:
sudo systemctl status owrt-remote --no-pager -l
sudo journalctl -u owrt-remote -n 100 --no-pager
Проверь, слушает ли Hub:
sudo ss -lntp | grep -E ':(80|8088)\b'
curl -sS http://127.0.0.1:8088/health
Если curl на VPS отвечает {"ok":true}, но снаружи сайт не открывается, проблема почти всегда в firewall:
sudo ufw allow 80/tcp
sudo ufw allow 8088/tcp
sudo ufw allow 8443/tcp
sudo ufw status
И обязательно проверь firewall в личном кабинете VPS-провайдера.
Порт 80 не поднялся
Проверь, кто занял порт:
sudo ss -lntp | grep ':80'
sudo journalctl -u owrt-remote -n 100 --no-pager
Если порт 80 занят nginx/apache, открывай Hub через:
http://YOUR_VPS_IP:8088/
или настрой nginx/Caddy reverse proxy на 127.0.0.1:8088.
Вход не принимает пароль
Сбросить логин и пароль:
sudo /opt/owrt-remote/owrt-remote-hub.py set-login --username admin --password admin
sudo systemctl restart owrt-remote
Роутер offline
На роутере:
owrt-remote doctor
owrt-remote heartbeat
На VPS:
sudo systemctl status owrt-remote --no-pager -l
sudo systemctl status owrt-remote-xray --no-pager -l
Админка пишет proxy error: [Errno 111] Connection refused
Xray на VPS не слушает entry-port этого роутера. Пересобери Xray config:
sudo /opt/owrt-remote/owrt-remote-hub.py render-xray --out /etc/xray/owrt-remote.json
sudo systemctl restart owrt-remote-xray
sudo ss -lntp | grep -E ':(18080|18090|19080|19090)\b'
SSH web-terminal просит пароль и молчит
Проверь, включен ли Dropbear на OpenWrt:
/etc/init.d/dropbear status
owrt-remote heartbeat
В телефоне используй поле снизу терминала:
Вставить- вставить текст;Enter- отправить Enter;Отправить- отправить команду или пароль.
С мобильного интернета не открывается
Пробуй:
http://YOUR_VPS_IP/
http://YOUR_VPS_IP:8088/
Если по Wi-Fi работает, а через мобильный интернет нет:
- открой
80/tcp,8088/tcp,8443/tcpв firewall VPS-провайдера; - проверь
sudo ss -lntp | grep -E ':(80|8088)'; - лучше привязать домен и сделать HTTPS/443 через Caddy или nginx.
Важно: нормальный доверенный SSL на голый IP обычно не выпускается. Для красивого https:// нужен домен.
Обновление
Обновить VPS:
sudo wget -O /opt/owrt-remote/owrt-remote-hub.py \
"https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/owrt-remote-hub.py"
sudo wget -O /etc/systemd/system/owrt-remote.service \
"https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/owrt-remote.service"
sudo chmod +x /opt/owrt-remote/owrt-remote-hub.py
sudo systemctl daemon-reload
sudo systemctl restart owrt-remote
Обновить OpenWrt:
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/install.sh?v=$(date +%s)" | sh
/etc/init.d/owrt-remote restart
owrt-remote heartbeat
После добавления или удаления роутеров всегда обновляй Xray на VPS:
sudo /opt/owrt-remote/owrt-remote-hub.py render-xray --out /etc/xray/owrt-remote.json
sudo systemctl restart owrt-remote-xray
Полезные команды
Список роутеров:
sudo /opt/owrt-remote/owrt-remote-hub.py list-routers
Показать OpenWrt config для роутера:
sudo /opt/owrt-remote/owrt-remote-hub.py print-openwrt-config \
--id main \
--hub-url http://YOUR_VPS_IP:8088 \
--vps-host YOUR_VPS_IP
Поменять entry-port без смены UUID:
sudo /opt/owrt-remote/owrt-remote-hub.py set-entry-port --id main --entry-port 18080
sudo /opt/owrt-remote/owrt-remote-hub.py render-xray --out /etc/xray/owrt-remote.json
sudo systemctl restart owrt-remote-xray
Сменить логин и пароль Hub:
sudo /opt/owrt-remote/owrt-remote-hub.py set-login --username admin --password admin
sudo systemctl restart owrt-remote