26 KiB
Удалённый доступ к 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.
Remote управление Xray: запуск, остановка и перезапуск Xray выбранного роутера через Heartbeat, с проверкой результата и журналом действий. Работает при остановленном Xray и недоступном SSH-туннеле, если агент продолжает связываться с Hub. Нужны обновлённые Hub и агент. Описание и проверка.
Журналы VPS: ежедневная ротация в 03:20, ограничение journald, фильтрация успешных частых HTTP-запросов и проверка заполнения диска. Устанавливается также через кнопку «Обновление панели». Установка, проверка и откат.
Tachyon: автоматическое обнаружение пакета на каждом роутере, версия и Online/Offline, открытие отдельного веб-интерфейса или старого LuCI через авторизованный туннель Hub. Локальная установка, проверка и откат.
Для чегоудалённо открыть LuCI |
Из чего состоитVPS Hub-панель |
Сообщество NetHaven VPN Обсуждение
Есть вопросы, идеи или нужна помощь с настройкой?
Присоединяйтесь к чату пользователей OpenWrt Remote Hub, где можно:
задать вопрос по установке
обсудить настройку VPS и OpenWrt
сообщить об ошибке
предложить новые функции
поделиться своим опытом использования
Чат и обсуждения проекта
Быстрый старт
После установки в конце появится вход:
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.
Схема работы
Скриншоты интерфейса
Hub-панель Карточки роутеров, статусы Online/Offline, LuCI, SSH, OpenWrt config и Client JSON. |
Обзор панели и настройка
Обзор панели и настройка
Открытие 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







