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
+

-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:
+
+
+
+
+
+
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+
+
+
+
+
+
+
+
+
-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
+
+ |
+
+
+
+
+
+---
+
+
+
+---
+
+⚡ Быстрый старт
+
+> После установки в конце появится вход:
+>
+> ```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 на роутере открывать не нужно.
+
+---
+
+🖼️ Скриншоты интерфейса
+
+
+
+
+
+
+
+
+
+
+Hub-панель
+
+Карточки роутеров, статусы Online/Offline, LuCI, SSH, OpenWrt config и Client JSON.
+
+ |
+
+
+
+
+
+
+
+
+
+
+Вход в Hub
+
+Логин, пароль и простая капча для защиты панели.
+
+ |
+
+
+
+
+
+Доступ и сессии
+
+Смена логина/пароля и управление активными сессиями.
+
+ |
+
+
+
+
+
+
+
+Настройки роутера
+
+Router ID, Hub URL, токены, Xray, reverse tags и SSH параметры.
+
+ |
+
+
+
+
+
+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**.
+
+Можно использовать, копировать, изменять, публиковать и распространять проект при сохранении текста лицензии.
+
+
+
+
+
+
+
+
+
+---
+
+
+
+

+
+
+
+
OpenWrt Remote Hub — свой VPS, свой доступ, свои роутеры под контролем.
+
+

+
+