Merge remote-tracking branch 'origin/main'
This commit is contained in:
commit
730b54c939
2 files changed
+51
-87
No files matched your search
@@ -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
|
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
|
```sh
|
||||||
@@ -256,20 +185,12 @@ owrt-remote status
|
|||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
```mermaid
|
<p align="center">
|
||||||
flowchart LR
|
<img src="assets/screenshots/scheme.svg" alt="Схема работы OpenWrt Remote Hub" width="900">
|
||||||
U[User Browser] -->|HTTPS 443| N[nginx on VPS]
|
</p>
|
||||||
N --> H[OpenWrt Remote Hub]
|
|
||||||
H --> X[Xray Reverse]
|
|
||||||
X --> R[OpenWrt Router]
|
|
||||||
R --> L[LuCI]
|
|
||||||
R --> S[SSH / Dropbear]
|
|
||||||
```
|
|
||||||
|
|
||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
<b>Главная идея:</b> роутер сам подключается к VPS изнутри сети. Наружу LuCI и SSH на роутере открывать не нужно.
|
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -420,15 +341,20 @@ flowchart LR
|
|||||||
|
|
||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
<h2> Видео-демо</h2>
|
<h2> Интро</h2>
|
||||||
|
|
||||||
<b>Видео дизайн обзор</b>
|
<a href="https://www.youtube.com/watch?v=QLBEj4KeOkM" target="_blank">
|
||||||
<br>
|
<img src="https://img.youtube.com/vi/QLBEj4KeOkM/maxresdefault.jpg"
|
||||||
<sub>Открытие Hub с телефона: статус роутера, LuCI и SSH Web Terminal.</sub>
|
alt="OpenWrt Remote Hub — Интро"
|
||||||
|
width="720">
|
||||||
|
</a>
|
||||||
|
|
||||||
<br><br>
|
<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>
|
</div>
|
||||||
|
|
||||||
|
|||||||
@@ -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 |
Reference in new issue
Block a user