2026-06-30 17:09:04 +04:00
2026-06-29 02:14:50 +04:00
2026-06-29 05:35:35 +04:00
2026-06-28 16:09:05 +04:00
2026-06-30 12:23:53 +04:00
2026-06-29 02:14:50 +04:00

OpenWrt Remote Hub

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

Карточки роутеров · Online/Offline · LuCI · SSH Web Terminal · Xray Reverse · HTTPS

OpenWrt LuCI VPS Xray HTTPS Build

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

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

После установки в конце будет вход:

login:    admin
password: admin

Панель будет доступна так:

https://YOUR_VPS_IP/
http://YOUR_VPS_IP/
http://YOUR_VPS_IP:8088/

Если нужен домен, передай его установщику:

curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" | sudo sh -s -- hub.example.com

Если HTTPS не нужен:

curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" | sudo env AUTO_HTTPS=0 sh

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

Схема

ChatGPT Image 30 июн  2026 г , 11_31_11

Роутер сам подключается к VPS изнутри сети. Наружу LuCI и SSH на роутере открывать не нужно.

Что умеет

  • красивые карточки роутеров на VPS;
  • online/offline индикация;
  • модель, OpenWrt, Xray, uptime, RAM, flash, температура и load;
  • вход в LuCI кнопкой Админка;
  • SSH прямо в браузере кнопкой SSH;
  • готовые OpenWrt config-команды для каждого роутера;
  • кнопки обновления и рестарта Xray на VPS;
  • автоматический HTTPS на 443/tcp, если firewall VPS открыт.

Раскрыть разделы

Установка VPS подробно

Команда установки:

curl -fsSL "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh?v=$(date +%s)" | sudo sh

Что делает установщик:

  • ставит зависимости;
  • скачивает Hub в /opt/owrt-remote;
  • создает systemd-сервис owrt-remote;
  • ставит Xray, если его нет;
  • создает systemd-сервис owrt-remote-xray;
  • открывает 80/tcp, 443/tcp, 8088/tcp, 8443/tcp в ufw;
  • создает логин admin и пароль admin;
  • пробует сразу включить HTTPS.

В свежем установщике в начале вывода должно быть:

Installer: 2026-06-30-auto-https-v4
Жду запуск Hub...

Если хочешь поставить повторно, но не сбрасывать текущий пароль:

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 сам. Для этого должны быть открыты порты:

80/tcp   - проверка Let's Encrypt
443/tcp  - HTTPS-панель

Включить 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 -k https://127.0.0.1/health

Важно: IP-сертификаты Let's Encrypt короткие. Certbot ставит auto-renew, а скрипт добавляет hook для перезапуска Hub после обновления сертификата.

Добавить первый роутер

На VPS:

VPS_HOST="YOUR_VPS_IP"

sudo /opt/owrt-remote/owrt-remote-hub.py add-router \
  --id main \
  --name "Главный роутер" \
  --role main \
  --entry-port 18080 \
  --vps-host "$VPS_HOST"

sudo /opt/owrt-remote/owrt-remote-hub.py render-xray --out /etc/xray/owrt-remote.json
sudo systemctl restart owrt-remote-xray

Потом открой Hub, нажми у роутера OpenWrt config, скопируй команды и вставь их в SSH роутера.

Вывести команды прямо на VPS:

sudo /opt/owrt-remote/owrt-remote-hub.py print-openwrt-config \
  --id main \
  --hub-url "https://$VPS_HOST" \
  --vps-host "$VPS_HOST"

После вставки команд на OpenWrt:

owrt-remote render-client
/etc/init.d/owrt-remote enable
/etc/init.d/owrt-remote restart
owrt-remote heartbeat
Добавить второй и следующие роутеры

Каждому роутеру нужен свой id и свой entry-port.

Пример второго роутера:

VPS_HOST="YOUR_VPS_IP"

sudo /opt/owrt-remote/owrt-remote-hub.py add-router \
  --id node-2 \
  --name "Второй роутер" \
  --role node \
  --entry-port 18090 \
  --vps-host "$VPS_HOST"

sudo /opt/owrt-remote/owrt-remote-hub.py render-xray --out /etc/xray/owrt-remote.json
sudo systemctl restart owrt-remote-xray

Порты:

Что Пример Для чего
entry-port 18080, 18090, 18100 LuCI каждого роутера через VPS
ssh-entry-port 19080, 19090, 19100 SSH web-terminal, создается как entry-port + 1000
vps-port 8443 Xray VLESS reverse на VPS
admin-port 80 LuCI внутри OpenWrt
ssh-port 22 Dropbear/SSH внутри OpenWrt

Наружу открывать надо только:

80/tcp
443/tcp
8088/tcp
8443/tcp

Порты 18080, 18090, 19080, 19090 должны слушать только 127.0.0.1 на VPS. Их наружу открывать не надо.

Установка агента на OpenWrt

На роутере:

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 не помещается в память через opkg, можно поставить временный Xray в /tmp кнопкой Поставить Xray в /tmp в панели роутера. После ребута агент сам восстановит Xray в /tmp, если он пропал.

Проверка после установки

На 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;
  • HTTPS systemd override и renewal hook;
  • правила 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
    ├── enable-https.sh
    │   └── включение HTTPS/443 вручную
    ├── uninstall-vps.sh
    │   └── удаление Hub с VPS
    ├── owrt-remote-hub.py
    │   └── веб-панель VPS, карточки, proxy, SSH terminal
    └── owrt-remote.service
        └── systemd-сервис Hub
S
Description
No description provided
Readme MIT
8.9 MiB
0 Stars 1 Watchers 0 Forks
Languages
Python 70.3%
PowerShell 11.8%
Shell 11.6%
JavaScript 6.2%