Update LICENSE

This commit is contained in:
kzolotarev95 authored and GitHub committed 2026-07-02 08:29:40 +04:00
1 parent 43896508da
commit bb925b7e86
1 file changed
+576 -17
+576 -17
View File
@@ -1,21 +1,580 @@
MIT License
<div align="center">
Copyright (c) 2026
<img src="https://capsule-render.vercel.app/api?type=waving&color=0:00A3E0,45:7C3AED,100:F97316&height=210&section=header&text=OpenWrt%20Remote%20Hub&fontSize=42&fontColor=ffffff&animation=fadeIn&fontAlignY=36&desc=Remote%20LuCI%20%2B%20SSH%20access%20through%20your%20own%20VPS&descAlignY=58&descSize=16" alt="OpenWrt Remote Hub" width="100%" />
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:
<p>
<a href="#-быстрый-старт"><img alt="Quick start" src="https://img.shields.io/badge/QUICK%20START-ONE%20COMMAND-22C55E?style=for-the-badge&labelColor=111827"></a>
<a href="#-схема-работы"><img alt="Reverse access" src="https://img.shields.io/badge/REVERSE-ACCESS-7C3AED?style=for-the-badge&labelColor=111827"></a>
<a href="#-https--ssl"><img alt="HTTPS" src="https://img.shields.io/badge/HTTPS-NGINX-00A3E0?style=for-the-badge&labelColor=111827"></a>
<a href="#-частые-проблемы"><img alt="Troubleshooting" src="https://img.shields.io/badge/TROUBLESHOOTING-READY-F97316?style=for-the-badge&labelColor=111827"></a>
</p>
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
<p>
<img alt="OpenWrt" src="https://img.shields.io/badge/OpenWrt-24.10.x-00A3E0?style=flat-square&logo=openwrt&logoColor=white">
<img alt="LuCI" src="https://img.shields.io/badge/LuCI-supported-44CC11?style=flat-square">
<img alt="VPS" src="https://img.shields.io/badge/VPS-hub-7C3AED?style=flat-square">
<img alt="Xray" src="https://img.shields.io/badge/Xray-reverse-F97316?style=flat-square">
<img alt="Nginx" src="https://img.shields.io/badge/Nginx-HTTPS-22C55E?style=flat-square&logo=nginx&logoColor=white">
<img alt="Build" src="https://img.shields.io/badge/Build-v275-A855F7?style=flat-square">
<img alt="License" src="https://img.shields.io/badge/License-MIT-22C55E?style=flat-square">
</p>
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.
<h3>Удалённый доступ к OpenWrt через свой VPS</h3>
<p>
Карточки роутеров · Online/Offline · LuCI · SSH Web Terminal · Xray Reverse · HTTPS через nginx
</p>
</div>
---
<div align="center">
## Что это такое
**OpenWrt Remote Hub** — это связка из VPS-панели и OpenWrt-агента, которая даёт удобный удалённый доступ к роутерам без проброса LuCI и SSH наружу.
Роутер сам подключается к VPS изнутри сети, а ты заходишь в Hub-панель и открываешь нужный роутер, LuCI или SSH Web Terminal.
<table>
<tr>
<td width="50%" align="center">
### Для чего
удалённо открыть LuCI
зайти в SSH через браузер
видеть Online/Offline роутеров
держать всё за HTTPS
не светить домашнюю сеть наружу
</td>
<td width="50%" align="center">
### Из чего состоит
VPS Hub-панель
OpenWrt агент
Xray reverse-туннели
nginx HTTPS proxy
firewall automation
web terminal
</td>
</tr>
</table>
</div>
---
<div align="center">
## Tech Stack
### Router / Network / OpenWrt
<p align="center">
<img alt="OpenWrt" src="https://img.shields.io/badge/OpenWrt-00A3E0?style=for-the-badge&logo=openwrt&logoColor=white">
<img alt="LuCI" src="https://img.shields.io/badge/LuCI-44CC11?style=for-the-badge&logo=lua&logoColor=white">
<img alt="Dropbear" src="https://img.shields.io/badge/Dropbear-SSH-64748B?style=for-the-badge">
<img alt="CGI" src="https://img.shields.io/badge/CGI-Web%20Panel-A855F7?style=for-the-badge">
</p>
### VPS / Reverse / HTTPS
<p align="center">
<img alt="Linux" src="https://img.shields.io/badge/Linux-VPS-FCC624?style=for-the-badge&logo=linux&logoColor=111111">
<img alt="Python" src="https://img.shields.io/badge/Python-Hub-3776AB?style=for-the-badge&logo=python&logoColor=white">
<img alt="Shell" src="https://img.shields.io/badge/Shell-Installer-4EAA25?style=for-the-badge&logo=gnu-bash&logoColor=white">
<img alt="Xray" src="https://img.shields.io/badge/Xray-Reverse-F97316?style=for-the-badge">
<img alt="nginx" src="https://img.shields.io/badge/nginx-HTTPS-009639?style=for-the-badge&logo=nginx&logoColor=white">
</p>
</div>
---
<h2 align="center">⚡ Быстрый старт</h2>
> После установки в конце появится вход:
>
> ```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
```
---
<h2 align="center">🛰️ Схема работы</h2>
```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 на роутере открывать не нужно.
---
<h2 align="center">🖼️ Скриншоты интерфейса</h2>
<div align="center">
<table>
<tr>
<td align="center">
<img src="assets/screenshots/hub-dashboard.jpg" alt="OpenWrt Remote Hub dashboard" width="100%" />
<br>
<b>Hub-панель</b>
<br>
<sub>Карточки роутеров, статусы Online/Offline, LuCI, SSH, OpenWrt config и Client JSON.</sub>
</td>
</tr>
</table>
<table>
<tr>
<td width="50%" align="center">
<img src="assets/screenshots/login-screen.jpg" alt="Login screen with captcha" width="320" />
<br>
<b>Вход в Hub</b>
<br>
<sub>Логин, пароль и простая капча для защиты панели.</sub>
</td>
<td width="50%" align="center">
<img src="assets/screenshots/access-settings.png" alt="Access settings and sessions" width="420" />
<br>
<b>Доступ и сессии</b>
<br>
<sub>Смена логина/пароля и управление активными сессиями.</sub>
</td>
</tr>
<tr>
<td width="50%" align="center">
<img src="assets/screenshots/router-settings.png" alt="OpenWrt router settings" width="100%" />
<br>
<b>Настройки роутера</b>
<br>
<sub>Router ID, Hub URL, токены, Xray, reverse tags и SSH параметры.</sub>
</td>
<td width="50%" align="center">
<img src="assets/screenshots/ssh-web-terminal.jpg" alt="SSH web terminal" width="100%" />
<br>
<b>SSH Web Terminal</b>
<br>
<sub>Терминал OpenWrt прямо в браузере, удобно даже с телефона.</sub>
</td>
</tr>
</table>
</div>
---
<h2 align="center">🎛️ Возможности</h2>
<div align="center">
| Возможность | Описание |
|:---:|:---:|
| 🧭 **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 |
</div>
---
<h2 align="center">📦 Подробная установка</h2>
<details>
<summary><b>🖥️ Установка VPS подробно</b></summary>
Если хочешь поставить повторно, но не сбрасывать текущий пароль:
```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
```
</details>
<details>
<summary><b>🔐 HTTPS / SSL</b></summary>
Установщик пытается включить 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 после обновления сертификата.
</details>
<details>
<summary><b>✅ Проверка после установки</b></summary>
На 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
```
</details>
---
<h2 align="center">🧯 Частые проблемы</h2>
<details>
<summary><b>❌ Панель VPS не открывается</b></summary>
Проверь сервисы и порты:
```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
```
</details>
<details>
<summary><b>🔌 Админка пишет <code>proxy error: [Errno 111] Connection refused</code></b></summary>
Пересобери 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'
```
</details>
<details>
<summary><b>⌨️ SSH web-terminal просит пароль и молчит</b></summary>
Проверь Dropbear на OpenWrt:
```sh
/etc/init.d/dropbear status
owrt-remote heartbeat
```
В телефоне используй поле снизу терминала:
- **Вставить** — вставить текст;
- **Enter** — отправить Enter;
- **Отправить** — отправить команду или пароль.
</details>
<details>
<summary><b>📱 С мобильного интернета не открывается</b></summary>
Пробуй:
```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)'
```
</details>
---
<h2 align="center">🗑️ Удаление</h2>
<details>
<summary><b>🖥️ Удалить Hub с VPS полностью</b></summary>
```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
```
</details>
<details>
<summary><b>📡 Удалить агент с OpenWrt полностью</b></summary>
```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
```
</details>
---
<h2 align="center">🌳 Дерево проекта</h2>
<details>
<summary><b>Открыть дерево файлов</b></summary>
```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
```
</details>
---
<h2 align="center"> Мини-шпаргалка команд</h2>
<div align="center">
| Где | Команда | Что делает |
|:---:|:---:|:---:|
| 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 |
</div>
---
<h2 align="center"> Лицензия</h2>
<div align="center">
Этот проект распространяется под лицензией **MIT**.
Можно использовать, копировать, изменять, публиковать и распространять проект при сохранении текста лицензии.
<br>
<a href="LICENSE">
<img alt="MIT License" src="https://img.shields.io/badge/License-MIT-22C55E?style=for-the-badge&labelColor=111827">
</a>
</div>
---
<div align="center">
<img src="https://readme-typing-svg.demolab.com?font=JetBrains+Mono&weight=600&size=20&duration=2800&pause=800&color=00A3E0&center=true&vCenter=true&width=760&lines=OpenWrt+Remote+Hub;LuCI+%2B+SSH+through+your+own+VPS;No+direct+router+ports+exposed;Built+for+remote+router+control" alt="Typing SVG" />
<br>
<b>OpenWrt Remote Hub</b> — свой VPS, свой доступ, свои роутеры под контролем.
<img src="https://capsule-render.vercel.app/api?type=waving&color=0:F97316,45:7C3AED,100:00A3E0&height=120&section=footer" alt="Footer" width="100%" />
</div>