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

9.9 KiB
Raw Blame History

Поиск совместимого Xray: локальное исправление v121

Подтверждённая причина

Прежний загрузчик строил имя APK из закреплённой версии и вывода apk --print-arch. В некоторых OpenWrt 25 этот вывод — общий ABI mipsel, а опубликованный asset называется ...-mipsel_24kc.apk. Получался URL несуществующего ...-mipsel.apk, и GitHub возвращал 404.

В ответе GitHub Releases API найден настоящий 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-адрес удалённого роутера вместо АДРЕС_РОУТЕРА:

$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.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 должны быть подтверждены после установки на устройстве. Эмуляция перезагрузки в тестах не заменяет эту проверку.