Files
luci-app-owrt-remote/README.md
T
kzolotarev95 aa7970c98c Release v116 with VPS router logs and reliable log delivery
Add per-router VPS log archives available offline, live delivery and last reported service state. Keep router logs in RAM with bounded rotation and deduplication. Align log pages and mobile statistics, and bump application and deployment tools to v116.
2026-10-14 08:05:52 +04:00

27 KiB
Raw Blame History

OpenWrt Remote Hub

Quick start Reverse access HTTPS Troubleshooting

OpenWrt LuCI VPS Xray Nginx Build License

Удалённый доступ к OpenWrt через свой VPS

Сайт скрипта : https://hub.freedev.app

Карточки роутеров · Online/Offline · LuCI · SSH Web Terminal · Xray Reverse · HTTPS через nginx


Что это такое

OpenWrt Remote Hub — это связка из VPS-панели и OpenWrt-агента, которая даёт удобный удалённый доступ к роутерам без проброса LuCI и SSH наружу.
Роутер сам подключается к VPS изнутри сети, а ты заходишь в Hub-панель и открываешь нужный роутер, LuCI или SSH Web Terminal.

Для чего

удалённо открыть LuCI
зайти в SSH через браузер
видеть Online/Offline роутеров
держать всё за HTTPS
не светить домашнюю сеть наружу

Из чего состоит

VPS Hub-панель
OpenWrt агент
Xray reverse-туннели
nginx HTTPS proxy
firewall automation
web terminal


Tech Stack

Router / Network / OpenWrt

OpenWrt LuCI Dropbear CGI

VPS / Reverse / HTTPS

Linux Python Shell Xray nginx



Сообщество NetHaven VPN Обсуждение

Есть вопросы, идеи или нужна помощь с настройкой?

Присоединяйтесь к чату пользователей OpenWrt Remote Hub, где можно:

задать вопрос по установке
обсудить настройку VPS и OpenWrt
сообщить об ошибке
предложить новые функции
поделиться своим опытом использования


Telegram Community



Чат и обсуждения проекта


Быстрый старт

После установки в конце появится вход:

login:    admin
password: admin

Пароль лучше поменять сразу после первого входа.

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

Установщик спросит:

IP/домен VPS:

Можно вставить домен, например:

hub.example.com

Или просто нажать Enter, чтобы взять найденный IP сервера.

OpenWrt: поставить Remote Hub на роутер

wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/install.sh?v=$(date +%s)" | sh

В панели самого роутера рядом с NetHaven VPN есть кнопка Глобал логи: при открытии блока сразу загружаются сохранённые записи. Журнал можно скачать, включить просмотр с обновлением каждые 3 секунды или очистить. Записываются действия панели, изменения связи Heartbeat/WAN, предупреждения и ошибки Xray. Успешные Heartbeat без изменения состояния и повторяющиеся события не заполняют журнал; подробности каждого соединения Xray отключены. В просмотре успех отмечается зелёным, предупреждение — жёлтым, ошибка — красным. Журнал хранится в /tmp/owrt-remote-logs/, занимает около 2 МБ максимум, очищается каждые 24 часа и исчезает после перезагрузки. Сбор работает отдельно от туннеля; остановка Xray не останавливает журнал. Ключи и пароли скрываются. Перед записью проверяется tmpfs: журнал и его служебное состояние не размещаются на Flash. После очистки одинаковые факты могут быть записаны заново.

В карточке роутера на VPS есть Глобал логи, открывающиеся в новой вкладке. Там доступны те же скачивание, просмотр с обновлением каждые 3 секунды и очистка, а также зелёные, жёлтые и красные записи. Роутер доставляет новые записи на VPS отдельно от Heartbeat: повторная отправка после обрыва не создаёт дубликатов. Остановка Remote кнопкой «Остановить» не прекращает доставку журнала: пока работает интернет, записи об остановке и дальнейшие действия поступают на VPS. Над журналом Hub показывает полученное состояние: Remote выключен, Xray остановлен или Heartbeat поступает. Если точная причина обрыва не доставлена, Hub сообщает об этом прямо; последнее предупреждение не выдаётся за доказанную причину отключения. Обновить для этого нужно и VPS, и каждый роутер, журнал которого нужен в Hub.

Кнопка доступна и при оффлайн: Hub хранит последние доставленные записи в своей базе, до 2 МБ на роутер. Архив сохраняется после перезагрузки роутера и Hub; очистка ОЗУ роутера раз в сутки не удаляет копию на VPS. Hub записывает факт истечения ожидания Heartbeat. Записи, созданные после полной потери связи, появятся только при её восстановлении, если ещё сохранены в ОЗУ роутера. Очистка из Hub сразу удаляет архив VPS, а очистка журнала оффлайн-роутера применится при следующей доставке. Доступ к журналу требует полного доступа к этому роутеру; удаление роутера удаляет его архив.

Проверка на роутере:

owrt-remote doctor
owrt-remote status

Схема работы

flowchart LR
    U[User Browser] -->|HTTPS 443| N[nginx on VPS]
    N --> H[OpenWrt Remote Hub]
    H --> X[Xray Reverse]
    X --> R[OpenWrt Router]
    R --> L[LuCI]
    R --> S[SSH / Dropbear]

Главная идея: роутер сам подключается к VPS изнутри сети. Наружу LuCI и SSH на роутере открывать не нужно.


Скриншоты интерфейса

OpenWrt Remote Hub dashboard
Hub-панель
Карточки роутеров, статусы Online/Offline, LuCI, SSH, OpenWrt config и Client JSON.
Hub login with password and 2FA
Вход по паролю + 2FA
Основной экран входа в Hub: логин, пароль, 6-значный TOTP-код и reCAPTCHA.
Quick login methods in Hub
Быстрый вход
Passkey, SSH ED25519 подпись и вход через привязанные GitHub / VK ID аккаунты.
Hub access and security settings
Безопасность и доступ
Пароль, 2FA, Passkey, SSH ED25519, привязанные сервисы, ограниченные пользователи и уведомления.
VPS web terminal
VPS Terminal
Веб-терминал VPS с быстрыми командами для обслуживания Hub, Xray, HTTPS и диагностики сервиса.
Router traffic clients panel
Клиенты Traffic
Список клиентов роутера с SSH-опросом и счетчиками входящего/исходящего трафика прямо в Hub.
Wake-on-LAN panel in router card
Wake-on-LAN
Пробуждение устройств по MAC-адресу прямо из карточки роутера без отдельной админки.
Hub effects panel
Эффекты Hub
Набор визуальных эффектов интерфейса: снег, дождь, орбиты, туманность, лучи и другие режимы.
OpenWrt router dashboard cards
Карточки роутеров
Живые карточки со статусом, моделью, памятью, температурой, SSH, LuCI и быстрыми действиями.


Обзор панели и настройка

Обзор панели и настройка
Открытие Hub с ПК: статус роутера, LuCI и SSH Web Terminal.



OpenWrt Remote Hub Demo



Watch on YouTube




Видео-демо

Видео дизайн обзор
Открытие Hub с телефона: статус роутера, LuCI и SSH Web Terminal.




Возможности

Возможность Описание
Router Cards Карточки роутеров в Hub-панели
Online / Offline Быстрая проверка состояния роутеров
LuCI через VPS Доступ к LuCI без прямого проброса портов
SSH Web Terminal SSH в браузере, удобно даже с телефона
Xray Reverse Роутер подключается к VPS сам
HTTPS через nginx TLS-точка входа на 443/tcp
Firewall automation Скрипты помогают открыть нужные порты
Doctor / Status Команды диагностики на OpenWrt

Подробная установка

Установка 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 сам.



Схема такая:

Internet -> 443/nginx -> Hub -> Xray reverse -> OpenWrt

Hub работает внутри на 80 и 8088, а HTTPS на 443 принимает nginx и прокидывает запросы в Hub.



Для установки должны быть открыты порты:

80/tcp    - HTTP-панель и проверка Let's Encrypt
443/tcp   - HTTPS-панель через nginx
8088/tcp  - прямой HTTP-порт Hub, можно закрыть позже в firewall провайдера
8443/tcp  - Xray / reverse endpoint

Включить 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 -sS http://127.0.0.1:8088/health
curl -k https://127.0.0.1/health
sudo nginx -t

Нормальная картина:



443 слушает nginx
80 и 8088 слушает python3 Hub
certbot ставит auto-renew
скрипт добавляет hook для перезагрузки nginx после обновления сертификата

Уведомления и мини-лог VPS

В панели Hub открой кнопку с логином, блок Уведомления, и нажми Включить.



Что пишет Hub:



вход в панель: устройство, браузер и IP
запуск Hub
запуск VPS после перезагрузки
короткую причину прошлого выключения/ребута по журналу VPS



Важно: если VPS полностью выключился или пропал интернет, сам VPS не сможет отправить уведомление в момент падения. Событие появится после следующего запуска, когда Hub снова поднимется.

Проверка после установки

На 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-remote active/running
owrt-remote-xray active/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
nginx-конфиг HTTPS, certbot renewal hook и старые TLS override-файлы
правила 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 через nginx
    ├── enable-https.sh
    │   └── включение HTTPS/443 через nginx вручную
    ├── uninstall-vps.sh
    │   └── удаление Hub с VPS
    ├── owrt-remote-hub.py
    │   └── веб-панель VPS, карточки, proxy, SSH terminal
    └── owrt-remote.service
        └── systemd-сервис Hub


Лицензия

Этот проект распространяется под лицензией MIT.
Можно использовать, копировать, изменять, публиковать и распространять проект при сохранении текста лицензии.

MIT License

Typing SVG

OpenWrt Remote Hub — свой VPS, свой доступ, свои роутеры под контролем.



Footer