Release v117 with persistent logs and WAN tunnel recovery
This commit is contained in:
1 parent
5f65a3d811
commit
b62db40daf
61 files changed
+3080
-438
No files matched your search
@@ -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 на удалённом устройстве не
|
||||
отключать для искусственного теста без независимого канала доступа.
|
||||
Reference in new issue
Block a user