Files
2026-11-22 02:38:21 +04:00

25 KiB
Raw Permalink Blame History

OpenWrt Remote Hub

Quick start Reverse access HTTPS Troubleshooting

OpenWrt LuCI VPS Xray Nginx Build License

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

Сказать спасибо ❤️ : https://donate.zks95.ugnss.ru

Карточки роутеров · 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

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

owrt-remote doctor
owrt-remote status

Если загрузка Xray прерывается: общий загрузчик с переключением клиентов, диагностика DNS/TLS/HTTP, локальная установка исправления и откат описаны в docs/XRAY_DOWNLOAD_RECOVERY.md.

Готовые пакеты для OpenWrt

IPK для OpenWrt 23.05/24.10 и APK для 25.12. Пакеты архитектурно независимые (all/noarch): содержат тот же агент и LuCI-файлы, что и install.sh, сохраняют /etc/config/owrtremote и существующий Xray. Версия интерфейса — v122, исправленная пакетная ревизия — 122-r2. GitHub Actions проверяет SDK разных архитектур, установку/обновление/удаление в OpenWrt VM и при выпуске тега v* прикладывает пакеты к GitHub Release. Для APK в штатной LuCI нужен доверенный ключ подписи; неподписанный локальный APK ставится через SSH. Инструкция, подпись и локальная сборка: docs/OPENWRT_PACKAGES.md.


Схема работы

Схема работы OpenWrt Remote Hub


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

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




Интро

OpenWrt Remote Hub — Интро



Смотреть интро на YouTube

Возможности

Возможность Описание
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