Fix OpenWrt Xray release discovery and installer diagnostics

This commit is contained in:
kzolotarev95 committed 2026-11-06 21:40:47 +04:00
1 parent 6cf3ae7c0f
commit edbc86697a
13 files changed
+1030 -278

No files matched your search

+115
View File
@@ -0,0 +1,115 @@
# Поиск совместимого 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 должны быть подтверждены после установки на устройстве.
Эмуляция перезагрузки в тестах не заменяет эту проверку.