# OpenWrt Remote Hub Удаленный доступ к OpenWrt через свой VPS: карточки роутеров, online/offline, LuCI-админка, SSH web-terminal и Xray VLESS reverse-туннели. [Telegram](https://t.me/kzolotarev95) · [GitHub](https://github.com/kzolotarev95) · [NetHaven VPN](https://t.me/+LZDsQJhUfcNhYWEy)
## Что это `OpenWrt Remote Hub` - это легкая панель для удаленного доступа к OpenWrt через свой VPS. Роутер сам подключается к VPS изнутри сети, поэтому наружу LuCI и SSH на роутере открывать не нужно. ## Схема работы ```mermaid flowchart LR browser["Браузер / телефон"] --> hub["VPS
OpenWrt Remote Hub
80 / 8088"] hub --> luciEntry["127.0.0.1:18080
LuCI entry-port"] hub --> sshEntry["127.0.0.1:19080
SSH entry-port"] luciEntry --> xray["Xray VLESS reverse
8443"] sshEntry --> xray xray --> router["OpenWrt роутер"] router --> luci["LuCI
127.0.0.1:80"] router --> ssh["Dropbear SSH
127.0.0.1:22"] ``` В панели VPS можно: - видеть все роутеры красивыми карточками; - смотреть online/offline, модель, OpenWrt, Xray, uptime, RAM, flash, температуру и load; - открывать LuCI кнопкой `Админка`; - открывать SSH прямо в браузере кнопкой `SSH`; - получать готовые OpenWrt config-команды для каждого роутера; - обновлять и перезапускать Xray на VPS кнопками в панели. Первый вход в Hub: ```text логин: admin пароль: admin ``` Пароль можно поменять в панели Hub. ## Дерево проекта ```text . ├── 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 на VPS одной командой ├── uninstall-vps.sh │ └── удаление Hub с VPS одной командой ├── enable-https.sh │ └── включение HTTPS/443 для Hub ├── owrt-remote-hub.py │ └── веб-панель VPS, карточки роутеров, proxy, SSH terminal └── owrt-remote.service └── systemd-сервис Hub ``` ## Быстрые команды | Задача | Где запускать | Команда | | --- | --- | --- | | Поставить Hub | VPS | `curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" \| sudo sh` | | Включить HTTPS | VPS | `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` | | Поставить агент | OpenWrt | `wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/install.sh?v=$(date +%s)" \| sh` | | Удалить Hub полностью | VPS | `curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/uninstall-vps.sh?v=$(date +%s)" \| sudo sh` | | Удалить агент полностью | OpenWrt | `wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/uninstall.sh?v=$(date +%s)" \| PURGE=1 sh` | ## Быстрая установка VPS Подходит для Ubuntu/Debian VPS. Команды выполнять под `root` или через `sudo`. Самый простой вариант - одна команда. Она поставит зависимости, скачает Hub, запустит сервис, откроет порты в `ufw` и в конце покажет ссылку панели и вход `admin/admin`. ```sh curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" | sudo sh ``` После успешной установки в конце будет примерно так: ```text OpenWrt Remote Hub установлен Панель: http://YOUR_VPS_IP/ http://YOUR_VPS_IP:8088/ Вход: login: admin password: admin ``` В свежем установщике в начале вывода должно быть: ```text Installer: 2026-06-30-health-wait-v2 Жду запуск Hub... ``` Если этих строк нет, значит GitHub raw/CDN отдал старый кеш. Запусти команду установки именно с `?v=$(date +%s)`, как в примере выше. Если хочешь явно указать IP или домен: ```sh curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" | sudo sh -s -- YOUR_VPS_IP ``` Если ставишь повторно и хочешь снова сбросить вход на `admin/admin`, ничего дополнительно делать не надо: установщик по умолчанию выставляет `admin/admin`. Если не хочешь сбрасывать текущий пароль: ```sh 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 ``` Ручная установка, если нужна: ```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 ``` Проверь, что панель поднялась: ```sh 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: ```json {"ok":true} ``` Открыть панель: ```text http://YOUR_VPS_IP/ http://YOUR_VPS_IP:8088/ ``` Если с домашнего интернета открывается, а с мобильного нет, чаще всего мобильный оператор или firewall VPS режет порт. Открой в личном кабинете VPS-провайдера: ```text 80/tcp 8088/tcp 8443/tcp ``` Важно: `ufw allow` открывает firewall внутри Ubuntu, но у многих VPS есть еще отдельный firewall в личном кабинете. Если после ручной установки панель не открывается и видно `owrt-remote.service inactive (dead)`, запусти: ```sh 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 ``` ## HTTPS / SSL По умолчанию Hub сразу открывается по HTTP: ```text http://YOUR_VPS_IP/ http://YOUR_VPS_IP:8088/ ``` HTTPS включается отдельной командой после установки. Так проще и надежнее: сначала поднимается панель, потом выпускается сертификат и включается порт `443/tcp`. ### HTTPS на IP VPS ```sh 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 ``` Пример: ```sh curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/enable-https.sh?v=$(date +%s)" | sudo sh -s -- 45.9.73.74 ``` После этого панель будет тут: ```text https://YOUR_VPS_IP/ ``` Важно: IP-сертификаты Let's Encrypt короткие. Certbot сам ставит renew timer, а скрипт добавляет hook для перезапуска Hub после обновления сертификата. ### HTTPS на домен Сначала направь DNS `A`-запись домена на IP VPS. Потом: ```sh 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 ``` После этого панель будет тут: ```text https://hub.example.com/ ``` Проверка на VPS: ```sh sudo ss -lntp | grep -E ':(80|443|8088)\b' curl -k https://127.0.0.1/health ``` Если HTTPS не включился, проверь, что снаружи открыт порт `80/tcp` для проверки Let's Encrypt и `443/tcp` для самой панели. ## Установка Xray на VPS ```sh 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: ```sh 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 <