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

+96
View File
@@ -0,0 +1,96 @@
# Восстановление Xray после пропажи выбранного WAN (v117)
Сообщения `No selected WAN has a physical IPv4 default route`, ошибки
генерации конфигурации и `crash loop 6 crashes` описывают последовательность:
временно исчез маршрут на выбранном uplink, каждый запуск агента завершался,
а procd прекратил повторные попытки запуска Xray. Затем Heartbeat смог
восстановиться самостоятельно. Он делает HTTP-запрос, поэтому его успех
не подтверждает работу двух обратных соединений Xray для Админки и SSH.
В прежнем `wan_reconcile_xray` остановленный Xray игнорировался; при возврате
того же интерфейса также ничего не происходило. Это подтверждённый дефект
восстановления. Причину исчезновения исходного маршрута и фактическое
текущее состояние Xray на удалённом устройстве только эти логи не определяют.
## Исправление
- Перед генерацией JSON служебный процесс ожидает выбранный WAN с физическим
IPv4 default route. Проверка каждые 5 секунд, одна запись о начале ожидания
и одна о возвращении WAN. Конфигурация в ожидании не заменяется.
- Ошибки UUID, JSON или проверки Xray при доступном WAN не маскируются
ожиданием сети: генерация по-прежнему завершается с настоящей ошибкой.
- Heartbeat не перезапускает всю службу, пока все выбранные WAN недоступны.
- После подготовки WAN проверяются процесс Xray и состояние procd. Если
Xray отсутствует и его instance не работает, но служба включена и Heartbeat
работает, повторно регистрируется только instance `xray` через `service add`.
Работающий процесс запуска, который ожидает WAN или готовит Xray, не трогается.
- Живой Heartbeat и остальные instance не удаляются. При прежнем здоровом
туннеле на том же интерфейсе перезапуск не запрашивается.
- Блокировка в RAM исключает одновременные запросы восстановления; PID
завершившегося worker освобождается. Повторные запросы ограничены интервалом
300 секунд, в том числе при ошибке ubus. Успешный ответ ubus означает принятие
запроса запуска, а не доказанную доступность Админки.
- Явная остановка через панель (`enabled=0`) или остановка всей службы
не отменяется автоматикой. Невыбранные интерфейсы не используются.
- Источники установки, настройки LAN, DNS, Podkop и логика WAN policy routing
не меняются этим исправлением.
Формат `service add` и строковых параметров respawn сверялся с исходниками:
- https://github.com/openwrt/procd/blob/master/service/service.c
- https://github.com/openwrt/procd/blob/master/service/instance.c
- https://github.com/openwrt/openwrt/blob/openwrt-24.10/package/system/procd/files/procd.sh
## Установка и откат
Windows PowerShell 5.1, роутер пользователя:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-wan-recovery-fix.ps1" -Router "root@192.168.2.1" -Action Install
```
Скрипт обновляет агент и WAN helper парой, сохраняет первую копию в
`/root/owrt-remote-backup-before-wan-recovery-v117`, проверяет shell-синтаксис
и побайтовое совпадение. Затем перезагружает только работающий Heartbeat,
чтобы в RAM не остался прежний shell с уже загруженными функциями.
Туннель при исправном Xray не перезапускается. Остановленный Heartbeat
не запускается принудительно. Ошибка установки восстанавливает файлы
до текущей попытки. UCI и рабочий JSON скрипт установки не заменяет;
обычный запуск Xray выполняет штатную проверку и генерацию конфигурации.
Установка подтверждается `WAN_RECOVERY_ROUTER_Install_OK`, это подтверждение
установки кода. Проверка состояния:
```powershell
ssh root@192.168.2.1 'owrt-remote status; owrt-remote heartbeat-diagnostics; logread -e owrt-remote | tail -n 60'
```
Откат к коду до первого применения:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-wan-recovery-fix.ps1" -Router "root@192.168.2.1" -Action Rollback
```
Для роутера друга нужен его собственный доступный SSH-адрес, VPN или человек
в локальной сети. Через оборванные обратные SSH/HTTP-туннели установить код
невозможно. Если WAN уже вернулся, для разового восстановления на самом
роутере можно выполнить `/etc/init.d/owrt-remote restart`, затем проверить
`owrt-remote status`. Сам по себе этот перезапуск не устанавливает исправление.
## Локальная проверка
`test_wan_recovery.py` моделирует длительное отсутствие маршрута, возврат
того же интерфейса, остановленный Xray при работающем Heartbeat, начальную
подготовку, исправный туннель, ручную остановку, параллельные запросы,
оставшуюся блокировку, отказ ubus и настоящую ошибку генерации JSON.
Поддерживает `OWRT_RECOVERY_TEST_SHELL` для BusyBox ash.
`test_wan_recovery_deploy.py` проверяет установку, повторную установку,
сохранение первой резервной копии, откат, отсутствие копии, повреждённый
payload, отказ проверки и отказ перезапуска Heartbeat без реального SSH.
Дополнительно запускаются регрессии WAN failover, host policy, HTTP/HTTPS
авторизации и перенаправлений. Проверка BusyBox ash выполняется локальной
Windows-сборкой BusyBox; OpenWrt 24.10.3 и настоящий procd на устройстве
требуют проверки пользователем. Прямой WAN на удалённом устройстве не
отключать для искусственного теста без независимого канала доступа.