Release v117 with persistent logs and WAN tunnel recovery

This commit is contained in:
kzolotarev95 committed 2026-10-15 23:08:19 +04:00
1 parent 5f65a3d811
commit b62db40daf
61 files changed
+3080 -438

No files matched your search

+44 -7
View File
@@ -175,16 +175,53 @@ wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/m
и ошибки Xray. Успешные Heartbeat без изменения состояния и повторяющиеся
события не заполняют журнал; подробности каждого соединения Xray отключены.
В просмотре успех отмечается зелёным, предупреждение — жёлтым, ошибка — красным.
Журнал хранится в `/tmp/owrt-remote-logs/`, занимает около 2 МБ максимум,
очищается каждые 24 часа и исчезает после перезагрузки. Сбор работает отдельно
от туннеля; остановка Xray не останавливает журнал. Ключи и пароли скрываются.
Перед записью проверяется tmpfs: журнал и его служебное состояние не размещаются
на Flash. После очистки одинаковые факты могут быть записаны заново.
Постоянный журнал и курсоры доставки хранятся на проверенном доступном для записи
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
@@ -195,9 +232,9 @@ Hub сообщает об этом прямо; последнее предупр
Кнопка доступна и при оффлайн: Hub хранит последние доставленные записи в своей
базе, до 2 МБ на роутер. Архив сохраняется после перезагрузки роутера и Hub;
очистка ОЗУ роутера раз в сутки не удаляет копию на VPS. Hub записывает факт
ротация локального журнала не удаляет копию на VPS. Hub записывает факт
истечения ожидания Heartbeat. Записи, созданные после полной потери связи,
появятся только при её восстановлении, если ещё сохранены в ОЗУ роутера.
появятся только при её восстановлении, если сохранены в ограниченной очереди роутера.
Очистка из Hub сразу удаляет архив VPS, а очистка журнала оффлайн-роутера
применится при следующей доставке. Доступ к журналу требует полного доступа
к этому роутеру; удаление роутера удаляет его архив.