Fix router Xray validation and heartbeat error reporting

This commit is contained in:
kzolotarev95 committed 2026-10-14 20:39:24 +04:00
1 parent aa7970c98c
commit 4a398c96b1
9 files changed
+834 -30

No files matched your search

+73
View File
@@ -99,3 +99,76 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
```powershell
python tests/test_xray_mobile_deploy.py -v
```
## Проверка Xray и ошибка Heartbeat после применения (локальный фикс v116)
В предоставленном журнале Xray 26.3.27 запускается успешно, а завершающая
команда `owrt-remote heartbeat` возвращает `rc=1` с `Failed to allocate
uclient context`. Это ошибка HTTP-клиента, не JSON и не переносов строк.
В старом `post_json` переменные `http_proxy`/`https_proxy` экспортировались
пустыми. uclient проверяет наличие указателя `getenv`, пытается создать
клиент для пустого адреса прокси и возвращает эту ошибку ещё до запроса.
Теперь переменные удаляются через `unset` в отдельной оболочке; внешний
процесс и его настройки прокси не изменяются, проверка TLS остаётся включённой.
Источник: [uclient-fetch](https://github.com/openwrt/uclient/blob/master/uclient-fetch.c).
При генерации проверяются UUID, диапазон портов 1–65535 и независимость
меток двух reverse-туннелей. Метки больше не изменяются через `safe_id`;
значение сохраняется буквально либо отклоняется с конкретной причиной.
JSON экранирует управляющие символы; порты записываются в десятичном виде,
в том числе при вводе с ведущими нулями. Идентификаторы пользователей и порт
сверены с генераторами клиента/сервера Hub в локальном тесте. Метки reverse
локальны для каждой стороны; они должны совпадать с правилами маршрутизации
своей стороны, а не обязательно иметь одинаковые имена на VPS и роутере.
Фактические настройки удалённого VPS этот локальный тест не проверяет.
Проверка меток и host не использует классы символов `tr`: в стандартной
сборке OpenWrt 24.10 `FEATURE_TR_CLASSES` выключен. Запись
`tr -d '[:space:][:cntrl:]'` там удаляет обычные буквы из названий классов
и ошибочно отклоняет корректный `reverse-in`. Используется явный диапазон
ASCII-пробела/управляющих байтов; исходные метки не меняются. Проверка пустого
поля CGI также использует явные пробельные символы. Регрессия воспроизводит
старое поведение без классов, проверяет обе метки из конфигурации Hub,
host и применение всего блока через POST с CRLF. Конкретные ключи из
пользовательского `cfg.txt` в тестах не сохраняются.
Источник: [настройки BusyBox OpenWrt 24.10](https://github.com/openwrt/openwrt/blob/openwrt-24.10/package/utils/busybox/Config-defaults.in).
Новый файл создаётся с правами 0600 в приватной папке рядом с рабочим JSON
и имеет расширение `.json`. До атомарной замены выполняется
`xray -test -config <candidate.json>`; используется фактический бинарник,
включая `/tmp/owrt-xray/xray`. Полный вывод и код Xray сохраняются. При
отказе временный файл удаляется, рабочий JSON не заменяется, следующие
команды блока (enable/restart/heartbeat) не выполняются. Проверка Xray
валидирует конфигурацию, но не подтверждает доступность VPS по сети.
CGI получает этап выполнения от агента. Ошибка Heartbeat показывается
отдельно, с настоящим выводом HTTP-клиента и указанием, что предшествующие
команды уже выполнены. Реальная ошибка Xray показывается отдельно; общий
`rc=1` больше не сопровождается советом о переносах строк. Проверка
синтаксиса `sh -n` и мобильная нормализация сохраняются. При любом отказе
вставленный блок остаётся в поле; уже записанные UCI-настройки не откатываются
автоматически, что явно указано в сообщении.
Новый скрипт `vps/deploy-xray-validation-fix.ps1` обновляет CGI и агент,
не пересобирает настройки и не перезапускает службы при установке/откате.
Первая резервная копия обоих файлов:
`/root/owrt-remote-backup-before-xray-validation-v116`. Если установка
оборвалась или проверка файлов не прошла, возвращаются файлы до этой попытки.
На роутере друга нужно указать его доступный SSH-адрес вместо локального IP.
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-validation-fix.ps1" -Router "root@192.168.2.1" -Action Install
```
Откат кода (настройки, уже применённые через форму, сохраняются):
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-validation-fix.ps1" -Router "root@192.168.2.1" -Action Rollback
```
Дополнительные тесты: `tests/test_xray_validation.py` и
`tests/test_xray_validation_deploy.py`. Для проверки реальным Xray задайте
`OWRT_TEST_XRAY_BIN`; проверялась версия 26.3.27 (Windows amd64), включая
настоящий отказ неподдерживаемого `flow` с кодом 23. Отдельный mock проверяет
ошибку с кодом 1, который тоже должен сохраняться без подмены причины.