Files
luci-app-owrt-remote/tests/XRAY_APPLY.md
T

14 KiB
Raw Blame History

Применение OpenWrt config через панель роутера (v117)

При отправке textarea браузер кодирует переносы строк как CRLF. CGI декодировал их без нормализации и записывал CR в исполняемый shell-скрипт. После появления блока if/then/else/fi для сохранения ручного VPS host это приводило к ошибке unexpected end of file (expecting "then").

CGI удаляет CR перед записью скрипта и проверяет целиком sh -n до выполнения любых команд UCI. При ошибке синтаксиса конфигурация не меняется. Выполнение через sh -e останавливается при ошибке команды, например при неудачном render-client, и не продолжает перезапуск.

tests/test_xray_apply.py отправляет настоящий URL-encoded POST в CGI с тестовым ключом и исполняет команды строгой POSIX-оболочкой. Проверяются CRLF и LF, heredoc, пустые строки, кодированные символы, отклонение неполного скрипта до изменений, остановка при сбое команды и отказ без авторизации. Полный конфиг, сгенерированный Hub, применяется через ту же форму с подменёнными UCI/службой; ручной VPS host и WAN сохраняются. На Windows строгая проверка использует Git for Windows dash.

Установка и откат

Скрипт обновляет только CGI на роутере. VPS обновлять для этого фикса не требуется. До замены сохраняется первая резервная копия CGI: /root/owrt-remote-backup-before-xray-apply-v117/owrt-remote.

Из PowerShell Windows 11; замените IP, если адрес роутера отличается:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-apply-fix.ps1" -Router "root@192.168.2.1" -Action Install

После XRAY_APPLY_ROUTER_Install_OK обновите панель роутера через Ctrl+F5, снова скопируйте полный блок OpenWrt config из панели VPS и нажмите Применить настройки. Это повторно применит настройки без CR и пересоберёт Xray-конфиг. Предыдущая неудачная попытка могла успеть записать часть настроек; замена CGI сама по себе их не переприменяет. Если после успешного применения ошибка proxy остаётся, требуется проверка запуска Xray и обратного соединения с VPS на реальном роутере.

Откат возвращает CGI до установки; настройки, повторно применённые через форму, остаются текущими:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-apply-fix.ps1" -Router "root@192.168.2.1" -Action Rollback

Проверки локально:

python tests/test_xray_apply.py -v

Переносы строк в формах описаны в стандарте HTML.

Мобильная вставка команд (локальный фикс v117)

Воспроизведён отдельный случай rc=255: в строке uci set owrtremote.main.router_name=‘Дом у моря’ типографские кавычки не являются кавычками shell. UCI получает лишние аргументы, хотя sh -n не находит ошибки. По одному коду нельзя утверждать, что это причина конкретного сбоя на телефоне; необходима проверка исходного блока.

В поле команд отключены автокоррекция, автоматический регистр и автозаполнение. Перед применением удаляется начальный UTF-8 BOM; в отдельных строках uci set owrtremote.main... исправляются неразрывные разделители и внешние парные типографские кавычки. Содержимое значения экранируется как буквальная строка: $, обратные кавычки и апострофы не становятся командами. Значения в обычных shell-кавычках, многострочные строки и heredoc не переписываются. При ошибке вставленный текст остаётся в поле; настоящие ошибки выполнения по-прежнему останавливают скрипт.

Дополнительные тесты проверяют воспроизведение 255, исправление мобильной типографики, сохранение Unicode-значений, отсутствие исполнения символов из значения, экранирование текста ошибки в HTML и сохранение остановки при настоящей ошибке UCI.

Обновляется только /www/cgi-bin/owrt-remote на роутере, без перезапуска служб и изменений настроек при установке. Резервная копия отдельная: /root/owrt-remote-backup-before-xray-mobile-v117/owrt-remote.

Установка из PowerShell Windows 11:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-mobile-fix.ps1" -Router "root@192.168.1.1" -Action Install

После XRAY_MOBILE_ROUTER_Install_OK обновите страницу на телефоне, снова вставьте полный блок OpenWrt config и примените его.

Откат CGI (применённые через форму настройки остаются текущими):

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-mobile-fix.ps1" -Router "root@192.168.1.1" -Action Rollback

Проверки установки и отката выполняются на временных файлах без SSH:

python tests/test_xray_mobile_deploy.py -v

Проверка Xray и ошибка Heartbeat после применения (локальный фикс v117)

В предоставленном журнале 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.

При генерации проверяются 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.

Новый файл создаётся с правами 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-v117. Если установка оборвалась или проверка файлов не прошла, возвращаются файлы до этой попытки. На роутере друга нужно указать его доступный SSH-адрес вместо локального IP.

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.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, который тоже должен сохраняться без подмены причины.