---
Что это такое
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
|
---
---
---
Сообщество NetHaven VPN Обсуждение
Есть вопросы, идеи или нужна помощь с настройкой?
Присоединяйтесь к чату пользователей **OpenWrt Remote Hub**, где можно:
задать вопрос по установке
обсудить настройку VPS и OpenWrt
сообщить об ошибке
предложить новые функции
поделиться своим опытом использования
Чат и обсуждения проекта
---
Быстрый старт
После установки в конце появится вход:
```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 на роутере открывать не нужно.
---
Скриншоты интерфейса
Hub-панель
Карточки роутеров, статусы Online/Offline, LuCI, SSH, OpenWrt config и Client JSON.
|
Вход по паролю + 2FA
Основной экран входа в Hub: логин, пароль, 6-значный TOTP-код и reCAPTCHA.
|
Быстрый вход
Passkey, SSH ED25519 подпись и вход через привязанные GitHub / VK ID аккаунты.
|
Безопасность и доступ
Пароль, 2FA, Passkey, SSH ED25519, привязанные сервисы, ограниченные пользователи и уведомления.
|
VPS Terminal
Веб-терминал VPS с быстрыми командами для обслуживания Hub, Xray, HTTPS и диагностики сервиса.
|
Клиенты Traffic
Список клиентов роутера с SSH-опросом и счетчиками входящего/исходящего трафика прямо в Hub.
|
Wake-on-LAN
Пробуждение устройств по MAC-адресу прямо из карточки роутера без отдельной админки.
|
Эффекты Hub
Набор визуальных эффектов интерфейса: снег, дождь, орбиты, туманность, лучи и другие режимы.
|
Карточки роутеров
Живые карточки со статусом, моделью, памятью, температурой, SSH, LuCI и быстрыми действиями.
|
---
---
Обзор панели и настройка
Обзор панели и настройка
Открытие Hub с ПК: статус роутера, LuCI и SSH Web Terminal.
---
Видео-демо
Видео дизайн обзор
Открытие 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.
Можно использовать, копировать, изменять, публиковать и распространять проект при сохранении текста лицензии.
---
OpenWrt Remote Hub — свой VPS, свой доступ, свои роутеры под контролем.