175 lines
14 KiB
Markdown
175 lines
14 KiB
Markdown
# Применение OpenWrt config через панель роутера (v118)
|
||
|
||
При отправке 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-v118/owrt-remote`.
|
||
|
||
Из PowerShell Windows 11; замените IP, если адрес роутера отличается:
|
||
|
||
```powershell
|
||
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
|
||
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
|
||
```
|
||
|
||
Проверки локально:
|
||
|
||
```powershell
|
||
python tests/test_xray_apply.py -v
|
||
```
|
||
|
||
Переносы строк в формах описаны в [стандарте HTML](https://html.spec.whatwg.org/multipage/form-control-infrastructure.html).
|
||
|
||
## Мобильная вставка команд (локальный фикс v118)
|
||
|
||
Воспроизведён отдельный случай `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-v118/owrt-remote`.
|
||
|
||
Установка из PowerShell Windows 11:
|
||
|
||
```powershell
|
||
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
|
||
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:
|
||
|
||
```powershell
|
||
python tests/test_xray_mobile_deploy.py -v
|
||
```
|
||
|
||
|
||
## Проверка Xray и ошибка Heartbeat после применения (локальный фикс v118)
|
||
|
||
В предоставленном журнале 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-v118`. Если установка
|
||
оборвалась или проверка файлов не прошла, возвращаются файлы до этой попытки.
|
||
На роутере друга нужно указать его доступный 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, который тоже должен сохраняться без подмены причины.
|