Fix OpenWrt Xray release discovery and installer diagnostics
This commit is contained in:
1 parent
6cf3ae7c0f
commit
edbc86697a
13 files changed
+1030
-278
No files matched your search
@@ -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 должны быть подтверждены после установки на устройстве.
|
||||
Эмуляция перезагрузки в тестах не заменяет эту проверку.
|
||||
Reference in new issue
Block a user