OpenWrt Remote Hub
Удаленный доступ к OpenWrt через свой VPS
Карточки роутеров · Online/Offline · LuCI · SSH Web Terminal · Xray Reverse · HTTPS
Быстрый старт
VPS: поставить Hub, Xray, firewall и HTTPS одной командой
curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" | sudo sh
После установки в конце будет вход:
login: admin
password: admin
Если нужен домен, передай его установщику:
curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" | sudo sh -s -- hub.example.com
Если HTTPS не нужен:
curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" | sudo env AUTO_HTTPS=0 sh
OpenWrt: поставить Remote Hub на роутер
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/install.sh?v=$(date +%s)" | sh
Проверка на роутере:
owrt-remote doctor
owrt-remote status
Схема
Роутер сам подключается к VPS изнутри сети. Наружу LuCI и SSH на роутере открывать не нужно.
Раскрыть разделы
Установка VPS подробно
Если хочешь поставить повторно, но не сбрасывать текущий пароль:
curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" | sudo env RESET_LOGIN=0 sh
Если HTTPS не включился автоматически, HTTP-панель все равно остается рабочей. После проверки firewall можно запустить:
curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/enable-https.sh?v=$(date +%s)" | sudo sh -s -- YOUR_VPS_IP
HTTPS / SSL
Установщик пытается включить HTTPS сам. Для этого должны быть открыты порты:
80/tcp - проверка Let's Encrypt
443/tcp - HTTPS-панель
Включить HTTPS вручную на IP:
curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/enable-https.sh?v=$(date +%s)" | sudo sh -s -- YOUR_VPS_IP
Включить HTTPS вручную на домен:
curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/enable-https.sh?v=$(date +%s)" | sudo EMAIL="you@example.com" sh -s -- hub.example.com
Проверка на VPS:
sudo ss -lntp | grep -E ':(80|443|8088)\b'
curl -k https://127.0.0.1/health
Важно: IP-сертификаты Let's Encrypt короткие. Certbot ставит auto-renew, а скрипт добавляет hook для перезапуска Hub после обновления сертификата.
Добавить первый роутер
На 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 "https://$VPS_HOST" \
--vps-host "$VPS_HOST"
После вставки команд на OpenWrt:
owrt-remote render-client
/etc/init.d/owrt-remote enable
/etc/init.d/owrt-remote restart
owrt-remote heartbeat
Добавить второй и следующие роутеры
Каждому роутеру нужен свой 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
443/tcp
8088/tcp
8443/tcp
Порты 18080, 18090, 19080, 19090 должны слушать только 127.0.0.1 на VPS. Их наружу открывать не надо.
Установка агента на 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, если он пропал.
Проверка после установки
На VPS:
sudo systemctl status owrt-remote --no-pager -l
sudo systemctl status owrt-remote-xray --no-pager -l
sudo ss -lntp | grep -E ':(80|443|8088|8443|18080|18090|19080|19090)\b'
curl -sS http://127.0.0.1:8088/health
curl -k https://127.0.0.1/health
Должно быть:
owrt-remoteactive/running;owrt-remote-xrayactive/running;*:80,*:443,*: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
sudo ss -lntp | grep -E ':(80|443|8088)\b'
curl -sS http://127.0.0.1:8088/health
Если на VPS curl отвечает {"ok":true}, но снаружи сайт не открывается, проблема почти всегда в firewall VPS-провайдера.
Открой в личном кабинете VPS:
80/tcp
443/tcp
8088/tcp
8443/tcp
Админка пишет proxy error: [Errno 111] Connection refused
Пересобери 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;Отправить- отправить команду или пароль.
С мобильного интернета не открывается
Пробуй:
https://YOUR_VPS_IP/
http://YOUR_VPS_IP/
http://YOUR_VPS_IP:8088/
Если по Wi-Fi работает, а через мобильный интернет нет, открой порты в firewall VPS-провайдера и проверь:
sudo ss -lntp | grep -E ':(80|443|8088)'
Удаление
Удалить Hub с VPS полностью
curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/uninstall-vps.sh?v=$(date +%s)" | sudo sh
Удалится:
owrt-remote;owrt-remote-xray;/opt/owrt-remote;/etc/xray/owrt-remote.json;/var/lib/owrt-remote;- HTTPS systemd override и renewal hook;
- правила
ufwдля80/tcp,443/tcp,8088/tcp,8443/tcp.
Удалить Hub, но оставить базу роутеров:
curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/uninstall-vps.sh?v=$(date +%s)" | sudo env PURGE=0 sh
Удалить дополнительно сам Xray binary:
curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/uninstall-vps.sh?v=$(date +%s)" | sudo env REMOVE_XRAY=1 sh
Удалить агент с OpenWrt полностью
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/uninstall.sh?v=$(date +%s)" | PURGE=1 sh
Удалится:
/usr/sbin/owrt-remote;/etc/init.d/owrt-remote;/www/cgi-bin/owrt-remote;- пункт меню LuCI;
- rpcd ACL;
/etc/config/owrtremote;/etc/owrt-remote/web.key;/etc/xray/owrt-remote-client.json.
Удалить только файлы панели, но оставить конфиг:
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/uninstall.sh?v=$(date +%s)" | sh
Дерево проекта
Открыть дерево файлов
.
├── install.sh
│ └── установка агента на OpenWrt
├── uninstall.sh
│ └── удаление агента с OpenWrt
├── files/
│ ├── usr/sbin/owrt-remote
│ │ └── CLI-агент, heartbeat, render-client, doctor
│ ├── etc/init.d/owrt-remote
│ │ └── procd-сервис OpenWrt
│ ├── www/cgi-bin/owrt-remote
│ │ └── веб-панель на роутере
│ ├── usr/share/luci/menu.d/luci-app-owrt-remote.json
│ │ └── пункт меню LuCI: Службы -> OpenWrt Remote
│ └── usr/share/rpcd/acl.d/luci-app-owrt-remote.json
│ └── права LuCI/rpcd
└── vps/
├── install-vps.sh
│ └── установка Hub, Xray, firewall и HTTPS
├── enable-https.sh
│ └── включение HTTPS/443 вручную
├── uninstall-vps.sh
│ └── удаление Hub с VPS
├── owrt-remote-hub.py
│ └── веб-панель VPS, карточки, proxy, SSH terminal
└── owrt-remote.service
└── systemd-сервис Hub