944 lines
32 KiB
Markdown
944 lines
32 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 отключены.
|
||
В просмотре успех отмечается зелёным, предупреждение — жёлтым, ошибка — красным.
|
||
Постоянный журнал и курсоры доставки хранятся на проверенном доступном для записи
|
||
Flash-разделе: обычно `/overlay/owrt-remote/logs/`. `/overlay` используется только
|
||
если это настоящая точка монтирования JFFS2/UBIFS/ext4/f2fs; tmpfs и корневой
|
||
OverlayFS не считаются постоянным хранилищем. На системах с непосредственно
|
||
записываемым постоянным корнем используется `/etc/owrt-remote/logs/`.
|
||
Предел — 2 МиБ данных и 256 неизменяемых фрагментов до 16 КиБ каждый.
|
||
Доставленные фрагменты удаляются через 24 часа или раньше при нехватке места.
|
||
Неподтверждённые записи не удаляются автоматически: при заполненной очереди
|
||
новые события сверх лимита пропускаются, после восстановления пишется их число.
|
||
|
||
В `/tmp/owrt-remote-log-runtime/` остаются только буфер записи до 16 КиБ,
|
||
небольшой кеш повторов, блокировки, FIFO и ограниченные пакеты HTTP.
|
||
Буфер сбрасывается раз в 60 секунд; обычная остановка сборщика сбрасывает его
|
||
перед выходом. После внезапного отключения питания возможна потеря последней
|
||
минуты в RAM; завершённые фрагменты имеют контрольную сумму и сохраняются
|
||
после перезагрузки. Состояние меняется атомарно на том же разделе, а sync
|
||
выполняется только при фиксации пакета, не после каждой строки.
|
||
Если Flash недоступна, используется ограниченный журнал в RAM до 64 КиБ
|
||
плюс буфер 16 КиБ с предупреждением. При ошибке записи Flash сохранённая
|
||
очередь остаётся на месте; возвращение к ней — после восстановления хранилища
|
||
и перезагрузки роутера. Менее 2 МиБ свободного Flash останавливает новые записи
|
||
на неё. Системный logd, WAN, DNS, Podkop, Xray и конфигурация сети не меняются.
|
||
Сбор работает отдельно от туннеля. Ключи и пароли скрываются.
|
||
|
||
Контрольная сумма фрагментов вычисляется доступным `sha256sum`, `md5sum`
|
||
или `cksum`; пустая/ошибочная сумма не позволяет зафиксировать новый фрагмент.
|
||
Фрагменты без суммы, оставленные ранним локальным исправлением, восстанавливаются
|
||
из сохранённых файлов в отдельный журнал и повторно отправляются на VPS.
|
||
Пустой пакет состояния больше не подтверждает неполученные байты журнала.
|
||
Старые предупреждения о ротации остаются историей; уже потерянные файлы
|
||
восстановить нельзя. Новая контрольная сумма проверяет дальнейшую целостность,
|
||
но не доказывает целостность фрагментов, у которых раньше не было суммы.
|
||
|
||
Подробности устройства хранения и проверки: [tests/PERSISTENT_LOGS.md](tests/PERSISTENT_LOGS.md).
|
||
|
||
В карточке роутера на VPS есть **Глобал логи**, открывающиеся в новой вкладке.
|
||
Архив хранится в постоянной SQLite-базе `/var/lib/owrt-remote/hub.db`
|
||
(или по явно настроенному пути БД), до 2 МиБ на роутер. Тип файловой системы
|
||
и путь показаны в окне логов; для tmpfs/ramfs выводится предупреждение.
|
||
Локальный установщик VPS проверяет постоянный записываемый диск перед заменой
|
||
Hub и не меняет путь БД или конфигурацию сервера.
|
||
|
||
Там доступны те же скачивание, просмотр с обновлением каждые 3 секунды и очистка,
|
||
а также зелёные, жёлтые и красные записи. Роутер доставляет новые записи на VPS
|
||
отдельно от Heartbeat: повторная отправка после обрыва не создаёт дубликатов.
|
||
Новые события обычно поступают после пакетной записи на Flash — до 60 секунд;
|
||
проверка очереди и обновление просмотра выполняются каждые 3 секунды.
|
||
Остановка 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>
|
||
|
||
<p align="center">
|
||
<img src="assets/screenshots/scheme.svg" alt="Схема работы OpenWrt Remote Hub" width="900">
|
||
</p>
|
||
|
||
<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>
|
||
|
||
<a href="https://www.youtube.com/watch?v=QLBEj4KeOkM" target="_blank">
|
||
<img src="https://img.youtube.com/vi/QLBEj4KeOkM/maxresdefault.jpg"
|
||
alt="OpenWrt Remote Hub — Интро"
|
||
width="720">
|
||
</a>
|
||
|
||
<br><br>
|
||
|
||
<a href="https://www.youtube.com/watch?v=QLBEj4KeOkM">
|
||
<img alt="Смотреть интро на YouTube"
|
||
src="https://img.shields.io/badge/Смотреть-Интро%20на%20YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white">
|
||
</a>
|
||
|
||
</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>
|