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

116 lines
9.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Поиск совместимого Xray: локальное исправление v121
## Подтверждённая причина
Прежний загрузчик строил имя APK из закреплённой версии и вывода
`apk --print-arch`. В некоторых OpenWrt 25 этот вывод — общий ABI `mipsel`,
а опубликованный asset называется `...-mipsel_24kc.apk`. Получался URL
несуществующего `...-mipsel.apk`, и GitHub возвращал 404.
В ответе [GitHub Releases API](https://api.github.com/repos/yichya/openwrt-xray/releases)
найден настоящий `openwrt-xray-26.6.27-r1-mipsel_24kc.apk`; скачанный файл
имеет SHA256
`275e6f1141796e057befb0d3b8daa33a3731e22da9d749d6edc0290950dc6c80`,
совпадающий с `digest` asset. Это проверка источника, а не закрепление версии.
`Command failed: Not found` до подготовки Xray соответствует безусловному
`owrt-remote-logs restart` при первой установке: стандартный `restart`
сначала вызывает удаление ещё не зарегистрированной службы через ubus.
Теперь установщик останавливает службу только после успешного `running`,
а затем выполняет `start`. Вывод Netis после исправления нужен, чтобы
исключить дополнительную ошибку на конкретном устройстве.
У rpcd, uhttpd и Remote также проверяется наличие работающего экземпляра:
для первой активации используется `start`, для работающей службы — `reload`.
## Новый механизм
- Приоритет у APK; команды opkg на APK-системе не выполняются.
- Точная архитектура берётся из менеджера пакетов. Общий ABI уточняется
через `DISTRIB_ARCH` из `/etc/openwrt_release`, без угадывания по `uname`.
- Загружаются реальные Releases и Assets. Порядок JSON и номер ревизии пакета
не зашиты в код. Обрабатываются до десяти страниц по 20 релизов; временные
ответы и число запросов ограничены. Если кандидаты не проходят проверку,
поиск продолжается на следующей странице с более старыми релизами.
При успешном кандидате лишние страницы не загружаются.
- Draft, prerelease, чужие URL, другой CPU, отсутствие SHA256 и слишком
большой пакет отклоняются. URL проверяется HEAD перед GET при наличии curl;
для минимальных клиентов проверкой доступности служит ограниченный GET.
- Для существующего VLESS reverse без TLS исключаются версии с известным
запретом транспорта (26.7.11+). Это граница совместимости, а не версия
скачивания. Дополнительно каждый кандидат выполняет настоящий `-test`.
- Проверяются размер и SHA256 пакета, метаданные, ABI и зависимости.
APK проверяет нативный solver: `apk add --simulate --no-network`.
Он не устанавливает скачанный пакет. APK извлекается через `apk extract`;
IPK — в отдельный каталог. Системный `/usr/bin/xray` не перезаписывается.
- Версия исполняемого бинарника должна совпасть с релизом. Его запуск
проверяет совместимость с ABI/прошивкой, а не только совпадение имени CPU.
- Проверенный сжатый boot-кэш публикуется атомарно на постоянном разделе
до замены runtime. Кэш проверяется распаковкой и SHA256. Без места или
доступного постоянного раздела подготовка завершается явной ошибкой.
- Рабочий core используется без повторной загрузки; после перезагрузки
проверенный кэш восстанавливается без сети/API. Старые имена кэша читаются.
- Ошибки загрузки, распаковки и проверки сохраняют прежний бинарник,
рабочий JSON и `/etc/config/owrtremote`. Откат локального исправления
возвращает код агента, сохраняя подготовленный core и boot-кэш.
## Диагностика установщика
`OWRT_REMOTE_INSTALL_DIAGNOSTIC=1 sh install.sh` показывает этап, команду,
rc и отдельные stdout/stderr. При ошибке эти сведения выводятся и без
диагностического режима; последующие критические этапы не выполняются.
Вывод каждого потока ограничен 32 КиБ. Shell xtrace не включается.
Файлы проекта сначала загружаются/копируются во временный файл в каталоге
назначения и заменяются атомарно. Ошибка загрузки не обрезает прежний агент.
После подготовки Xray установщик для уже включённого клиента проверяет JSON,
запуск процесса и Heartbeat. Исходный UCI сохраняется. Первая установка с
`enabled=0` сообщает, что для соединения необходим OpenWrt config из Hub.
Намеренную остановку Xray через Remote установщик уважает.
Диагностика без ключей: `owrt-remote xray-package-diagnostics`.
## Установка локального исправления и откат
Подставить доступный SSH-адрес удалённого роутера вместо `АДРЕС_РОУТЕРА`:
```powershell
$Fix = "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-release-fix.ps1"
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Router "root@АДРЕС_РОУТЕРА" -Action Install
```
Резервная копия: `/root/owrt-remote-backup-before-xray-release-v121`.
Устанавливается агент и выполняется подготовка core/кэша. Рабочий JSON
не пересобирается, туннель этим скриптом не перезапускается. При прерванной
первой установке создаётся отсутствующий web.key; имеющийся ключ сохраняется.
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Router "root@АДРЕС_РОУТЕРА" -Action Rollback
```
## Проверки и ограничения
- `test_xray_release_selection.py`: реальное уточнение CPU/ABI, выбор asset,
ревизии, пагинация, несовместимый CPU, metadata, dependency solver,
ошибки API и некорректный JSON.
- `test_xray_bootstrap.py`: SHA256, повреждённый пакет/кэш, HTTP-ошибка,
переход к следующему asset, отсутствие сети, сохранение старого core,
офлайн-восстановление после удаления RAM-копии, конкурирующие установки.
- `test_install_diagnostics.py`: повторная установка в изолированный ROOT,
сохранение UCI, этап/команда/rc/stdout/stderr, остановка после ошибки.
- `test_xray_release_deploy.py`: установка, откат и автоматическое
восстановление кода при ошибке подготовки.
- Синтаксис и тесты shell проверяются MSYS sh и BusyBox ash на Windows.
Результат локального прогона выбора релизов, bootstrap, проверки конфигурации
и установки/отката: 76 тестов, 70 успешно, 6 пропущены (четыре требуют
внешних настоящих бинарников Xray, два требуют Linux /proc для проверки
дочерних процессов и конкуренции). Эти два сценария отдельно проходили
в MSYS sh. После добавления атомарной установки и выбора start/reload
повторно прошли все 5 тестов установщика. Shell syntax и PowerShell parser
ошибок не обнаружили.
Физического Netis N6 в этой среде нет. Нативные `apk adbdump/extract`,
бинарник Linux/MIPSel, реальная перезагрузка и успешный туннель на
OpenWrt 25.12.2 должны быть подтверждены после установки на устройстве.
Эмуляция перезагрузки в тестах не заменяет эту проверку.