OpenWrt Remote Hub

Quick start Reverse access HTTPS Troubleshooting

OpenWrt LuCI VPS Xray Nginx Build License

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

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

---

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

> После установки в конце появится вход: > > ```text > login: admin > password: admin > ``` > > Пароль лучше поменять сразу после первого входа. ### VPS: поставить Hub, Xray, firewall и HTTPS одной командой ```sh curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" | sudo sh ``` Установщик спросит: ```text IP/домен VPS: ``` Можно вставить домен, например: ```text hub.example.com ``` Или просто нажать **Enter**, чтобы взять найденный IP сервера. ### OpenWrt: поставить Remote Hub на роутер ```sh wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/install.sh?v=$(date +%s)" | sh ``` Проверка на роутере: ```sh owrt-remote doctor owrt-remote status ``` ---

Схема работы

```mermaid 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.
Login screen with captcha
Вход в Hub
Логин, пароль и простая капча для защиты панели.
Access settings and sessions
Доступ и сессии
Смена логина/пароля и управление активными сессиями.
OpenWrt router settings
Настройки роутера
Router ID, Hub URL, токены, Xray, reverse tags и SSH параметры.
SSH web terminal
SSH Web Terminal
Терминал OpenWrt прямо в браузере, удобно даже с телефона.
---

Видео-демо

Видео-демо
Открытие 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 подробно Если хочешь поставить повторно, но не сбрасывать текущий пароль: ```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 ``` Если HTTPS не включился автоматически, HTTP-панель всё равно остаётся рабочей. После проверки firewall можно запустить: ```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 ```
HTTPS / SSL Установщик пытается включить HTTPS сам. Схема такая: ```text Internet -> 443/nginx -> Hub -> Xray reverse -> OpenWrt ``` Hub работает внутри на `80` и `8088`, а HTTPS на `443` принимает nginx и прокидывает запросы в Hub. Для установки должны быть открыты порты: ```text 80/tcp - HTTP-панель и проверка Let's Encrypt 443/tcp - HTTPS-панель через nginx 8088/tcp - прямой HTTP-порт Hub, можно закрыть позже в firewall провайдера 8443/tcp - Xray / reverse endpoint ``` Включить HTTPS вручную на IP: ```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 ``` Включить HTTPS вручную на домен: ```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 ``` Проверка на VPS: ```sh 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: ```sh 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: ```sh owrt-remote doctor owrt-remote status owrt-remote heartbeat ```
---

Частые проблемы

Панель VPS не открывается Проверь сервисы и порты: ```sh 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: ```text 80/tcp 443/tcp 8088/tcp 8443/tcp ```
Админка пишет proxy error: [Errno 111] Connection refused Пересобери Xray config: ```sh 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: ```sh /etc/init.d/dropbear status owrt-remote heartbeat ``` В телефоне используй поле снизу терминала: - **Вставить** — вставить текст; - **Enter** — отправить Enter; - **Отправить** — отправить команду или пароль.
С мобильного интернета не открывается Пробуй: ```text https://YOUR_VPS_IP/ http://YOUR_VPS_IP/ http://YOUR_VPS_IP:8088/ ``` Если по Wi-Fi работает, а через мобильный интернет нет, открой порты в firewall VPS-провайдера и проверь: ```sh sudo ss -lntp | grep -E ':(80|443|8088)' ```
---

Удаление

Удалить Hub с VPS полностью ```sh 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, но оставить базу роутеров: ```sh 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: ```sh 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 полностью ```sh 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`. Удалить только файлы панели, но оставить конфиг: ```sh wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/uninstall.sh?v=$(date +%s)" | sh ```
---

Дерево проекта

Открыть дерево файлов ```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, 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 ```
---

Мини-шпаргалка команд

| Где | Команда | Что делает | |:---:|:---:|:---:| | VPS | `systemctl status owrt-remote` | статус Hub | | VPS | `systemctl status owrt-remote-xray` | статус Xray reverse | | VPS | `curl -sS http://127.0.0.1:8088/health` | healthcheck Hub | | VPS | `sudo nginx -t` | проверка nginx-конфига | | OpenWrt | `owrt-remote doctor` | диагностика агента | | OpenWrt | `owrt-remote status` | текущий статус | | OpenWrt | `owrt-remote heartbeat` | отправить heartbeat |
---

Лицензия

Этот проект распространяется под лицензией **MIT**. Можно использовать, копировать, изменять, публиковать и распространять проект при сохранении текста лицензии.
MIT License
---
Typing SVG
OpenWrt Remote Hub — свой VPS, свой доступ, свои роутеры под контролем. Footer