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

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

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

После установки в конце появится вход: ```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 ``` В панели самого роутера рядом с NetHaven VPN есть кнопка **Глобал логи**: при открытии блока сразу загружаются сохранённые записи. Журнал можно скачать, включить просмотр с обновлением каждые 3 секунды или очистить. Записываются действия панели, изменения связи Heartbeat/WAN, предупреждения и ошибки Xray. Успешные Heartbeat без изменения состояния и повторяющиеся события не заполняют журнал; подробности каждого соединения Xray отключены. В просмотре успех отмечается зелёным, предупреждение — жёлтым, ошибка — красным. Постоянный журнал и курсоры доставки хранятся на проверенном доступном для записи Flash-разделе: обычно `/overlay/owrt-remote/logs/`. `/overlay` используется только если это настоящая точка монтирования JFFS2/UBIFS/ext4/f2fs; tmpfs и корневой OverlayFS не считаются постоянным хранилищем. На системах с непосредственно записываемым постоянным корнем используется `/etc/owrt-remote/logs/`. Предел — 2 МиБ данных и 256 неизменяемых фрагментов до 16 КиБ каждый. Доставленные фрагменты удаляются через 24 часа или раньше при нехватке места. Неподтверждённые записи не удаляются автоматически: при заполненной очереди новые события сверх лимита пропускаются, после восстановления пишется их число. В `/tmp/owrt-remote-log-runtime/` остаются только буфер записи до 16 КиБ, небольшой кеш повторов, блокировки, FIFO и ограниченные пакеты HTTP. Буфер сбрасывается раз в 60 секунд; обычная остановка сборщика сбрасывает его перед выходом. После внезапного отключения питания возможна потеря последней минуты в RAM; завершённые фрагменты имеют контрольную сумму и сохраняются после перезагрузки. Состояние меняется атомарно на том же разделе, а sync выполняется только при фиксации пакета, не после каждой строки. Если Flash недоступна, используется ограниченный журнал в RAM до 64 КиБ плюс буфер 16 КиБ с предупреждением. При ошибке записи Flash сохранённая очередь остаётся на месте; возвращение к ней — после восстановления хранилища и перезагрузки роутера. Менее 2 МиБ свободного Flash останавливает новые записи на неё. Системный logd, WAN, DNS, Podkop, Xray и конфигурация сети не меняются. Сбор работает отдельно от туннеля. Ключи и пароли скрываются. Контрольная сумма фрагментов вычисляется доступным `sha256sum`, `md5sum` или `cksum`; пустая/ошибочная сумма не позволяет зафиксировать новый фрагмент. Фрагменты без суммы, оставленные ранним локальным исправлением, восстанавливаются из сохранённых файлов в отдельный журнал и повторно отправляются на VPS. Пустой пакет состояния больше не подтверждает неполученные байты журнала. Старые предупреждения о ротации остаются историей; уже потерянные файлы восстановить нельзя. Новая контрольная сумма проверяет дальнейшую целостность, но не доказывает целостность фрагментов, у которых раньше не было суммы. Подробности устройства хранения и проверки: [tests/PERSISTENT_LOGS.md](tests/PERSISTENT_LOGS.md). В карточке роутера на VPS есть **Глобал логи**, открывающиеся в новой вкладке. Архив хранится в постоянной SQLite-базе `/var/lib/owrt-remote/hub.db` (или по явно настроенному пути БД), до 2 МиБ на роутер. Тип файловой системы и путь показаны в окне логов; для tmpfs/ramfs выводится предупреждение. Локальный установщик VPS проверяет постоянный записываемый диск перед заменой Hub и не меняет путь БД или конфигурацию сервера. Там доступны те же скачивание, просмотр с обновлением каждые 3 секунды и очистка, а также зелёные, жёлтые и красные записи. Роутер доставляет новые записи на VPS отдельно от Heartbeat: повторная отправка после обрыва не создаёт дубликатов. Новые события обычно поступают после пакетной записи на Flash — до 60 секунд; проверка очереди и обновление просмотра выполняются каждые 3 секунды. Остановка Remote кнопкой «Остановить» не прекращает доставку журнала: пока работает интернет, записи об остановке и дальнейшие действия поступают на VPS. Над журналом Hub показывает полученное состояние: Remote выключен, Xray остановлен или Heartbeat поступает. Если точная причина обрыва не доставлена, Hub сообщает об этом прямо; последнее предупреждение не выдаётся за доказанную причину отключения. Обновить для этого нужно и VPS, и каждый роутер, журнал которого нужен в Hub. Кнопка доступна и при оффлайн: Hub хранит последние доставленные записи в своей базе, до 2 МБ на роутер. Архив сохраняется после перезагрузки роутера и Hub; ротация локального журнала не удаляет копию на VPS. Hub записывает факт истечения ожидания Heartbeat. Записи, созданные после полной потери связи, появятся только при её восстановлении, если сохранены в ограниченной очереди роутера. Очистка из Hub сразу удаляет архив VPS, а очистка журнала оффлайн-роутера применится при следующей доставке. Доступ к журналу требует полного доступа к этому роутеру; удаление роутера удаляет его архив. Проверка на роутере: ```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.
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 подробно
Если хочешь поставить повторно, но не сбрасывать текущий пароль:
```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 ```
---
---

Лицензия

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

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

Footer