From bb925b7e860ab62d9e0790532d7af43025829a1c Mon Sep 17 00:00:00 2001 From: kzolotarev95 <158571179+kzolotarev95@users.noreply.github.com> Date: Thu, 2 Jul 2026 08:29:40 +0400 Subject: [PATCH] Update LICENSE --- LICENSE | 593 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 576 insertions(+), 17 deletions(-) diff --git a/LICENSE b/LICENSE index 14fac91..9dfb3d1 100644 --- a/LICENSE +++ b/LICENSE @@ -1,21 +1,580 @@ -MIT License +
-Copyright (c) 2026 +OpenWrt Remote Hub -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: +

+ Quick start + Reverse access + HTTPS + Troubleshooting +

-The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. +

+ OpenWrt + LuCI + VPS + Xray + Nginx + Build + License +

-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. +

Удалённый доступ к 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 +> ``` +> +> Пароль лучше поменять сразу после первого входа. + +### 1️⃣ 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 сервера. + +### 2️⃣ 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 прямо в браузере, удобно даже с телефона. + +
+ +
+ + +--- + +

🎛️ Возможности

+ +
+ +| Возможность | Описание | +|:---:|:---:| +| 🧭 **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: + +```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 + +