Add per-router VPS log archives available offline, live delivery and last reported service state. Keep router logs in RAM with bounded rotation and deduplication. Align log pages and mobile statistics, and bump application and deployment tools to v116.
908 lines
27 KiB
Markdown
908 lines
27 KiB
Markdown
<div align="center">
|
||
|
||
<img src="https://capsule-render.vercel.app/api?type=waving&color=0:00A3E0,45:7C3AED,100:F97316&height=210§ion=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%" />
|
||
|
||
<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>
|
||
|
||
<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>
|
||
|
||
<h3>Удалённый доступ к OpenWrt через свой VPS</h3> Сайт скрипта : https://hub.freedev.app
|
||
|
||
<p>
|
||
Карточки роутеров · Online/Offline · LuCI · SSH Web Terminal · Xray Reverse · HTTPS через nginx
|
||
</p>
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Что это такое</h2>
|
||
|
||
<p>
|
||
<b>OpenWrt Remote Hub</b> — это связка из VPS-панели и OpenWrt-агента, которая даёт удобный удалённый доступ к роутерам без проброса LuCI и SSH наружу.<br>
|
||
Роутер сам подключается к VPS изнутри сети, а ты заходишь в Hub-панель и открываешь нужный роутер, LuCI или SSH Web Terminal.
|
||
</p>
|
||
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%" align="center">
|
||
|
||
<h3> Для чего</h3>
|
||
|
||
удалённо открыть LuCI
|
||
зайти в SSH через браузер
|
||
видеть Online/Offline роутеров
|
||
держать всё за HTTPS
|
||
не светить домашнюю сеть наружу
|
||
|
||
</td>
|
||
<td width="50%" align="center">
|
||
|
||
<h3> Из чего состоит</h3>
|
||
|
||
VPS Hub-панель
|
||
OpenWrt агент
|
||
Xray reverse-туннели
|
||
nginx HTTPS proxy
|
||
firewall automation
|
||
web terminal
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Tech Stack</h2>
|
||
|
||
<h3> Router / Network / OpenWrt</h3>
|
||
|
||
<p>
|
||
<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>
|
||
|
||
<h3> VPS / Reverse / HTTPS</h3>
|
||
|
||
<p>
|
||
<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>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Сообщество NetHaven VPN Обсуждение </h2>
|
||
|
||
Есть вопросы, идеи или нужна помощь с настройкой?
|
||
|
||
Присоединяйтесь к чату пользователей **OpenWrt Remote Hub**, где можно:
|
||
|
||
задать вопрос по установке
|
||
обсудить настройку VPS и OpenWrt
|
||
сообщить об ошибке
|
||
предложить новые функции
|
||
поделиться своим опытом использования
|
||
|
||
<br>
|
||
|
||
<a href="https://t.me/+LZDsQJhUfcNhYWEy">
|
||
<img alt="Telegram Community"
|
||
src="https://img.shields.io/badge/Telegram-Community-229ED9?style=for-the-badge&logo=telegram&logoColor=white">
|
||
</a>
|
||
|
||
<br><br>
|
||
|
||
<b> Чат и обсуждения проекта</b>
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
<h2> Быстрый старт</h2>
|
||
|
||
После установки в конце появится вход:
|
||
|
||
```text
|
||
login: admin
|
||
password: admin
|
||
```
|
||
|
||
Пароль лучше поменять сразу после первого входа.
|
||
|
||
<h3> VPS: поставить Hub, Xray, firewall и HTTPS одной командой</h3>
|
||
|
||
```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
|
||
```
|
||
|
||
Или просто нажать <b>Enter</b>, чтобы взять найденный IP сервера.
|
||
|
||
<h3> OpenWrt: поставить Remote Hub на роутер</h3>
|
||
|
||
```sh
|
||
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/install.sh?v=$(date +%s)" | sh
|
||
```
|
||
|
||
В панели самого роутера рядом с NetHaven VPN есть кнопка **Глобал логи**:
|
||
при открытии блока сразу загружаются сохранённые записи. Журнал можно скачать,
|
||
включить просмотр с обновлением каждые 3 секунды или очистить.
|
||
Записываются действия панели, изменения связи Heartbeat/WAN, предупреждения
|
||
и ошибки Xray. Успешные Heartbeat без изменения состояния и повторяющиеся
|
||
события не заполняют журнал; подробности каждого соединения Xray отключены.
|
||
В просмотре успех отмечается зелёным, предупреждение — жёлтым, ошибка — красным.
|
||
Журнал хранится в `/tmp/owrt-remote-logs/`, занимает около 2 МБ максимум,
|
||
очищается каждые 24 часа и исчезает после перезагрузки. Сбор работает отдельно
|
||
от туннеля; остановка Xray не останавливает журнал. Ключи и пароли скрываются.
|
||
Перед записью проверяется tmpfs: журнал и его служебное состояние не размещаются
|
||
на Flash. После очистки одинаковые факты могут быть записаны заново.
|
||
|
||
В карточке роутера на VPS есть **Глобал логи**, открывающиеся в новой вкладке.
|
||
Там доступны те же скачивание, просмотр с обновлением каждые 3 секунды и очистка,
|
||
а также зелёные, жёлтые и красные записи. Роутер доставляет новые записи на VPS
|
||
отдельно от Heartbeat: повторная отправка после обрыва не создаёт дубликатов.
|
||
Остановка Remote кнопкой «Остановить» не прекращает доставку журнала: пока
|
||
работает интернет, записи об остановке и дальнейшие действия поступают на VPS.
|
||
Над журналом Hub показывает полученное состояние: Remote выключен, Xray
|
||
остановлен или Heartbeat поступает. Если точная причина обрыва не доставлена,
|
||
Hub сообщает об этом прямо; последнее предупреждение не выдаётся за доказанную
|
||
причину отключения.
|
||
Обновить для этого нужно и VPS, и каждый роутер, журнал которого нужен в Hub.
|
||
|
||
Кнопка доступна и при оффлайн: Hub хранит последние доставленные записи в своей
|
||
базе, до 2 МБ на роутер. Архив сохраняется после перезагрузки роутера и Hub;
|
||
очистка ОЗУ роутера раз в сутки не удаляет копию на VPS. Hub записывает факт
|
||
истечения ожидания Heartbeat. Записи, созданные после полной потери связи,
|
||
появятся только при её восстановлении, если ещё сохранены в ОЗУ роутера.
|
||
Очистка из Hub сразу удаляет архив VPS, а очистка журнала оффлайн-роутера
|
||
применится при следующей доставке. Доступ к журналу требует полного доступа
|
||
к этому роутеру; удаление роутера удаляет его архив.
|
||
|
||
Проверка на роутере:
|
||
|
||
```sh
|
||
owrt-remote doctor
|
||
owrt-remote status
|
||
```
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Схема работы</h2>
|
||
|
||
</div>
|
||
|
||
```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]
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
<b>Главная идея:</b> роутер сам подключается к VPS изнутри сети. Наружу LuCI и SSH на роутере открывать не нужно.
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Скриншоты интерфейса</h2>
|
||
|
||
<table>
|
||
<tr>
|
||
<td align="center">
|
||
|
||
<img src="assets/screenshots/hub-router-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/hub-login-password-2fa.jpg" alt="Hub login with password and 2FA" width="320" />
|
||
|
||
<br>
|
||
<b>Вход по паролю + 2FA</b>
|
||
<br>
|
||
<sub>Основной экран входа в Hub: логин, пароль, 6-значный TOTP-код и reCAPTCHA.</sub>
|
||
|
||
</td>
|
||
<td width="50%" align="center">
|
||
|
||
<img src="assets/screenshots/hub-quick-login.jpg" alt="Quick login methods in Hub" width="420" />
|
||
|
||
<br>
|
||
<b>Быстрый вход</b>
|
||
<br>
|
||
<sub>Passkey, SSH ED25519 подпись и вход через привязанные GitHub / VK ID аккаунты.</sub>
|
||
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" align="center">
|
||
|
||
<img src="assets/screenshots/hub-access-security.jpg" alt="Hub access and security settings" width="420" />
|
||
|
||
<br>
|
||
<b>Безопасность и доступ</b>
|
||
<br>
|
||
<sub>Пароль, 2FA, Passkey, SSH ED25519, привязанные сервисы, ограниченные пользователи и уведомления.</sub>
|
||
|
||
</td>
|
||
<td width="50%" align="center">
|
||
|
||
<img src="assets/screenshots/hub-vps-terminal.jpg" alt="VPS web terminal" width="100%" />
|
||
|
||
<br>
|
||
<b>VPS Terminal</b>
|
||
<br>
|
||
<sub>Веб-терминал VPS с быстрыми командами для обслуживания Hub, Xray, HTTPS и диагностики сервиса.</sub>
|
||
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" align="center">
|
||
|
||
<img src="assets/screenshots/router-traffic-clients.jpg" alt="Router traffic clients panel" width="360" />
|
||
|
||
<br>
|
||
<b>Клиенты Traffic</b>
|
||
<br>
|
||
<sub>Список клиентов роутера с SSH-опросом и счетчиками входящего/исходящего трафика прямо в Hub.</sub>
|
||
|
||
</td>
|
||
<td width="50%" align="center">
|
||
|
||
<img src="assets/screenshots/router-wake-on-lan.jpg" alt="Wake-on-LAN panel in router card" width="360" />
|
||
|
||
<br>
|
||
<b>Wake-on-LAN</b>
|
||
<br>
|
||
<sub>Пробуждение устройств по MAC-адресу прямо из карточки роутера без отдельной админки.</sub>
|
||
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" align="center">
|
||
|
||
<img src="assets/screenshots/hub-effects-panel.jpg" alt="Hub effects panel" width="360" />
|
||
|
||
<br>
|
||
<b>Эффекты Hub</b>
|
||
<br>
|
||
<sub>Набор визуальных эффектов интерфейса: снег, дождь, орбиты, туманность, лучи и другие режимы.</sub>
|
||
|
||
</td>
|
||
<td width="50%" align="center">
|
||
|
||
<img src="assets/screenshots/hub-router-dashboard.jpg" alt="OpenWrt router dashboard cards" width="360" />
|
||
|
||
<br>
|
||
<b>Карточки роутеров</b>
|
||
<br>
|
||
<sub>Живые карточки со статусом, моделью, памятью, температурой, SSH, LuCI и быстрыми действиями.</sub>
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Обзор панели и настройка</h2>
|
||
|
||
<b>Обзор панели и настройка</b><br>
|
||
<sub>Открытие Hub с ПК: статус роутера, LuCI и SSH Web Terminal.</sub>
|
||
|
||
<br><br>
|
||
|
||
<a href="https://youtu.be/BCVIQgHkbYA?si=BDRAt2uyqRwz8A2Y" target="_blank">
|
||
<img src="https://img.youtube.com/vi/BCVIQgHkbYA/maxresdefault.jpg"
|
||
alt="OpenWrt Remote Hub Demo"
|
||
width="720">
|
||
</a>
|
||
|
||
<br><br>
|
||
|
||
<a href="https://youtu.be/BCVIQgHkbYA?si=BDRAt2uyqRwz8A2Y">
|
||
<img alt="Watch on YouTube"
|
||
src="https://img.shields.io/badge/%20Watch%20Demo%20on-YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white">
|
||
</a>
|
||
|
||
<br><br>
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Видео-демо</h2>
|
||
|
||
<b>Видео дизайн обзор</b>
|
||
<br>
|
||
<sub>Открытие Hub с телефона: статус роутера, LuCI и SSH Web Terminal.</sub>
|
||
|
||
<br><br>
|
||
|
||
<video src="https://github.com/user-attachments/assets/f7990b3c-2cfe-4fbf-bb01-c846102e1c94" width="360" controls></video>
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Возможности</h2>
|
||
|
||
<table>
|
||
<tr>
|
||
<th align="center">Возможность</th>
|
||
<th align="center">Описание</th>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"> <b>Router Cards</b></td>
|
||
<td align="center">Карточки роутеров в Hub-панели</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"> <b>Online / Offline</b></td>
|
||
<td align="center">Быстрая проверка состояния роутеров</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"> <b>LuCI через VPS</b></td>
|
||
<td align="center">Доступ к LuCI без прямого проброса портов</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"> <b>SSH Web Terminal</b></td>
|
||
<td align="center">SSH в браузере, удобно даже с телефона</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"> <b>Xray Reverse</b></td>
|
||
<td align="center">Роутер подключается к VPS сам</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"> <b>HTTPS через nginx</b></td>
|
||
<td align="center">TLS-точка входа на <code>443/tcp</code></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"> <b>Firewall automation</b></td>
|
||
<td align="center">Скрипты помогают открыть нужные порты</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"> <b>Doctor / Status</b></td>
|
||
<td align="center">Команды диагностики на OpenWrt</td>
|
||
</tr>
|
||
</table>
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Подробная установка</h2>
|
||
|
||
</div>
|
||
|
||
<details>
|
||
<summary align="center"><b> Установка VPS подробно</b></summary>
|
||
|
||
<div align="center">
|
||
|
||
Если хочешь поставить повторно, но не сбрасывать текущий пароль:
|
||
|
||
</div>
|
||
|
||
```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
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Если HTTPS не включился автоматически, HTTP-панель всё равно остаётся рабочей. После проверки firewall можно запустить:
|
||
|
||
</div>
|
||
|
||
```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 align="center"><b> HTTPS / SSL</b></summary>
|
||
|
||
<div align="center">
|
||
|
||
Установщик пытается включить HTTPS сам.
|
||
|
||
<br><br>
|
||
|
||
Схема такая:
|
||
|
||
</div>
|
||
|
||
```text
|
||
Internet -> 443/nginx -> Hub -> Xray reverse -> OpenWrt
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Hub работает внутри на <code>80</code> и <code>8088</code>, а HTTPS на <code>443</code> принимает nginx и прокидывает запросы в Hub.
|
||
|
||
<br><br>
|
||
|
||
Для установки должны быть открыты порты:
|
||
|
||
</div>
|
||
|
||
```text
|
||
80/tcp - HTTP-панель и проверка Let's Encrypt
|
||
443/tcp - HTTPS-панель через nginx
|
||
8088/tcp - прямой HTTP-порт Hub, можно закрыть позже в firewall провайдера
|
||
8443/tcp - Xray / reverse endpoint
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Включить HTTPS вручную на IP:
|
||
|
||
</div>
|
||
|
||
```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
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Включить HTTPS вручную на домен:
|
||
|
||
</div>
|
||
|
||
```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
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Проверка на VPS:
|
||
|
||
</div>
|
||
|
||
```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
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Нормальная картина:
|
||
|
||
<br><br>
|
||
|
||
<code>443</code> слушает <code>nginx</code><br>
|
||
<code>80</code> и <code>8088</code> слушает <code>python3</code> Hub<br>
|
||
certbot ставит auto-renew<br>
|
||
скрипт добавляет hook для перезагрузки nginx после обновления сертификата
|
||
|
||
</div>
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary align="center"><b> Уведомления и мини-лог VPS</b></summary>
|
||
|
||
<div align="center">
|
||
|
||
В панели Hub открой кнопку с логином, блок <code>Уведомления</code>, и нажми <code>Включить</code>.
|
||
|
||
<br><br>
|
||
|
||
Что пишет Hub:
|
||
|
||
<br><br>
|
||
|
||
вход в панель: устройство, браузер и IP<br>
|
||
запуск Hub<br>
|
||
запуск VPS после перезагрузки<br>
|
||
короткую причину прошлого выключения/ребута по журналу VPS
|
||
|
||
<br><br>
|
||
|
||
Важно: если VPS полностью выключился или пропал интернет, сам VPS не сможет отправить уведомление в момент падения. Событие появится после следующего запуска, когда Hub снова поднимется.
|
||
|
||
</div>
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary align="center"><b> Проверка после установки</b></summary>
|
||
|
||
<div align="center">
|
||
|
||
На VPS:
|
||
|
||
</div>
|
||
|
||
```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
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Должно быть:
|
||
|
||
<br><br>
|
||
|
||
<code>owrt-remote</code> active/running<br>
|
||
<code>owrt-remote-xray</code> active/running<br>
|
||
<code>*:80</code>, <code>*:443</code>, <code>*:8088</code>, <code>*:8443</code><br>
|
||
<code>127.0.0.1:18080</code> для LuCI первого роутера<br>
|
||
<code>127.0.0.1:19080</code> для SSH первого роутера
|
||
|
||
<br><br>
|
||
|
||
На OpenWrt:
|
||
|
||
</div>
|
||
|
||
```sh
|
||
owrt-remote doctor
|
||
owrt-remote status
|
||
owrt-remote heartbeat
|
||
```
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Частые проблемы</h2>
|
||
|
||
</div>
|
||
|
||
<details>
|
||
<summary align="center"><b> Панель VPS не открывается</b></summary>
|
||
|
||
<div align="center">
|
||
|
||
Проверь сервисы и порты:
|
||
|
||
</div>
|
||
|
||
```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
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Если на VPS <code>curl</code> отвечает <code>{"ok":true}</code>, но снаружи сайт не открывается, проблема почти всегда в firewall VPS-провайдера.
|
||
|
||
<br><br>
|
||
|
||
Открой в личном кабинете VPS:
|
||
|
||
</div>
|
||
|
||
```text
|
||
80/tcp
|
||
443/tcp
|
||
8088/tcp
|
||
8443/tcp
|
||
```
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary align="center"><b> Админка пишет <code>proxy error: [Errno 111] Connection refused</code></b></summary>
|
||
|
||
<div align="center">
|
||
|
||
Пересобери Xray config:
|
||
|
||
</div>
|
||
|
||
```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 align="center"><b> SSH web-terminal просит пароль и молчит</b></summary>
|
||
|
||
<div align="center">
|
||
|
||
Проверь Dropbear на OpenWrt:
|
||
|
||
</div>
|
||
|
||
```sh
|
||
/etc/init.d/dropbear status
|
||
owrt-remote heartbeat
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
В телефоне используй поле снизу терминала:
|
||
|
||
<br><br>
|
||
|
||
<b>Вставить</b> — вставить текст<br>
|
||
<b>Enter</b> — отправить Enter<br>
|
||
<b>Отправить</b> — отправить команду или пароль
|
||
|
||
</div>
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary align="center"><b> С мобильного интернета не открывается</b></summary>
|
||
|
||
<div align="center">
|
||
|
||
Пробуй:
|
||
|
||
</div>
|
||
|
||
```text
|
||
https://YOUR_VPS_IP/
|
||
http://YOUR_VPS_IP/
|
||
http://YOUR_VPS_IP:8088/
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Если по Wi-Fi работает, а через мобильный интернет нет, открой порты в firewall VPS-провайдера и проверь:
|
||
|
||
</div>
|
||
|
||
```sh
|
||
sudo ss -lntp | grep -E ':(80|443|8088)'
|
||
```
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Удаление</h2>
|
||
|
||
</div>
|
||
|
||
<details>
|
||
<summary align="center"><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
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Удалится:
|
||
|
||
<br><br>
|
||
|
||
<code>owrt-remote</code><br>
|
||
<code>owrt-remote-xray</code><br>
|
||
<code>/opt/owrt-remote</code><br>
|
||
<code>/etc/xray/owrt-remote.json</code><br>
|
||
<code>/var/lib/owrt-remote</code><br>
|
||
nginx-конфиг HTTPS, certbot renewal hook и старые TLS override-файлы<br>
|
||
правила <code>ufw</code> для <code>80/tcp</code>, <code>443/tcp</code>, <code>8088/tcp</code>, <code>8443/tcp</code>
|
||
|
||
<br><br>
|
||
|
||
Удалить Hub, но оставить базу роутеров:
|
||
|
||
</div>
|
||
|
||
```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
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Удалить дополнительно сам Xray binary:
|
||
|
||
</div>
|
||
|
||
```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 align="center"><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
|
||
```
|
||
|
||
<div align="center">
|
||
|
||
Удалится:
|
||
|
||
<br><br>
|
||
|
||
<code>/usr/sbin/owrt-remote</code><br>
|
||
<code>/etc/init.d/owrt-remote</code><br>
|
||
<code>/www/cgi-bin/owrt-remote</code><br>
|
||
пункт меню LuCI<br>
|
||
rpcd ACL<br>
|
||
<code>/etc/config/owrtremote</code><br>
|
||
<code>/etc/owrt-remote/web.key</code><br>
|
||
<code>/etc/xray/owrt-remote-client.json</code>
|
||
|
||
<br><br>
|
||
|
||
Удалить только файлы панели, но оставить конфиг:
|
||
|
||
</div>
|
||
|
||
```sh
|
||
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/uninstall.sh?v=$(date +%s)" | sh
|
||
```
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Дерево проекта</h2>
|
||
|
||
</div>
|
||
|
||
<details>
|
||
<summary align="center"><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>
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<h2> Лицензия</h2>
|
||
|
||
<p>
|
||
Этот проект распространяется под лицензией <b>MIT</b>.<br>
|
||
Можно использовать, копировать, изменять, публиковать и распространять проект при сохранении текста лицензии.
|
||
</p>
|
||
|
||
<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¢er=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, свой доступ, свои роутеры под контролем.
|
||
|
||
<br><br>
|
||
|
||
<img src="https://capsule-render.vercel.app/api?type=waving&color=0:F97316,45:7C3AED,100:00A3E0&height=120§ion=footer" alt="Footer" width="100%" />
|
||
|
||
</div>
|