Merge remote-tracking branch 'origin/main'

This commit is contained in:
kzolotarev95 committed 2026-10-20 01:04:32 +04:00
commit 730b54c939
2 files changed
+51 -87

No files matched your search

+13 -87
View File
@@ -168,77 +168,6 @@ hub.example.com
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
@@ -256,20 +185,12 @@ owrt-remote status
</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]
```
<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>
---
@@ -420,15 +341,20 @@ flowchart LR
<div align="center">
<h2> Видео-демо</h2>
<h2> Интро</h2>
<b>Видео дизайн обзор</b>
<br>
<sub>Открытие Hub с телефона: статус роутера, LuCI и SSH Web Terminal.</sub>
<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>
<video src="https://github.com/user-attachments/assets/f7990b3c-2cfe-4fbf-bb01-c846102e1c94" width="360" controls></video>
<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>
+38
View File
@@ -0,0 +1,38 @@
<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="470" viewBox="0 0 1200 470">
<defs>
<linearGradient id="bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#0f172a"/><stop offset="1" stop-color="#172554"/></linearGradient>
<linearGradient id="blue" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#0ea5e9"/><stop offset="1" stop-color="#2563eb"/></linearGradient>
<linearGradient id="purple" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#8b5cf6"/><stop offset="1" stop-color="#6d28d9"/></linearGradient>
<linearGradient id="orange" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#fb923c"/><stop offset="1" stop-color="#ea580c"/></linearGradient>
<filter id="shadow" x="-20%" y="-20%" width="140%" height="150%"><feDropShadow dx="0" dy="7" stdDeviation="7" flood-color="#020617" flood-opacity=".35"/></filter>
<marker id="arrow" markerWidth="10" markerHeight="10" refX="8" refY="3" orient="auto"><path d="M0,0 L0,6 L9,3 z" fill="#94a3b8"/></marker>
<style>
.label{font-family:Inter,Arial,sans-serif;font-weight:700;fill:#fff;text-anchor:middle}
.small{font-family:Inter,Arial,sans-serif;font-size:17px;fill:#cbd5e1;text-anchor:middle}
.line{fill:none;stroke:#94a3b8;stroke-width:3;marker-end:url(#arrow)}
</style>
</defs>
<rect width="1200" height="470" rx="28" fill="url(#bg)"/>
<text x="600" y="48" class="label" font-size="28">OpenWrt Remote Hub — схема работы</text>
<text x="600" y="78" class="small">Без прямого открытия LuCI и SSH роутера в интернет</text>
<g filter="url(#shadow)">
<rect x="45" y="155" width="205" height="95" rx="18" fill="url(#blue)"/>
<rect x="310" y="155" width="205" height="95" rx="18" fill="url(#purple)"/>
<rect x="575" y="155" width="205" height="95" rx="18" fill="url(#orange)"/>
<rect x="840" y="155" width="205" height="95" rx="18" fill="url(#blue)"/>
<rect x="930" y="325" width="210" height="82" rx="16" fill="#334155" stroke="#64748b" stroke-width="1.5"/>
<rect x="650" y="325" width="210" height="82" rx="16" fill="#334155" stroke="#64748b" stroke-width="1.5"/>
</g>
<path class="line" d="M250 202 H300"/>
<path class="line" d="M515 202 H565"/>
<path class="line" d="M780 202 H830"/>
<path class="line" d="M942 250 V290 H755 V315"/>
<path class="line" d="M1040 250 V315"/>
<text x="147" y="193" class="label" font-size="21">Браузер</text><text x="147" y="221" class="small">HTTPS :443</text>
<text x="412" y="193" class="label" font-size="21">nginx на VPS</text><text x="412" y="221" class="small">TLS / reverse proxy</text>
<text x="677" y="193" class="label" font-size="21">Hub-панель</text><text x="677" y="221" class="small">OpenWrt Remote Hub</text>
<text x="942" y="193" class="label" font-size="21">OpenWrt роутер</text><text x="942" y="221" class="small">Xray Reverse-туннель</text>
<text x="1035" y="358" class="label" font-size="20">LuCI</text><text x="1035" y="383" class="small">веб-интерфейс</text>
<text x="755" y="358" class="label" font-size="20">SSH / Dropbear</text><text x="755" y="383" class="small">терминал в браузере</text>
<text x="600" y="445" class="small">Роутер сам устанавливает исходящее соединение с VPS</text>
</svg>

After

Width:  |  Height:  |  Size: 3.3 KiB