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