OpenWrt IPK and APK / Validate source and resolve stable SDKs (push) Waiting to run
124 lines
11 KiB
Markdown
124 lines
11 KiB
Markdown
# Автоматическая установка и загрузка Xray
|
||
|
||
Исправление общее для OpenWrt с opkg/IPK и apk/APK. Версия интерфейса — v122.
|
||
Изменения включены в v122 и используются установщиком и агентом из GitHub.
|
||
|
||
## Что было неправильно
|
||
|
||
Наличие curl считалось достаточным: при его ошибке другие клиенты не запускались.
|
||
Без curl выбирался только один из uclient-fetch/wget. При этом wget часто является
|
||
ссылкой на uclient-fetch. Отказ предварительного HEAD исключал даже доступный
|
||
через GET пакет. Ошибка сети запускала перебор старых релизов и могла закончиться
|
||
сообщением об отсутствии совместимого Xray.
|
||
|
||
Лог GL-MT6000 подтверждает сбой загрузки, но не устанавливает его сетевую причину.
|
||
DNS, TLS, HTTP и сбой самого клиента различаются новой диагностикой на устройстве.
|
||
|
||
## Что изменено
|
||
|
||
- До замены файлов установщик проверяет curl, CA и jsonfilter. Недостающие пакеты
|
||
устанавливаются через обнаруженный менеджер. Ошибка зависимостей останавливает
|
||
установку отдельным этапом, до подготовки Xray.
|
||
- Установщик и агент используют один загрузчик, встроенный в оба файла. Исходник —
|
||
`scripts/router-download.sh`; обновление встроенных копий —
|
||
`python scripts/embed-router-download.py`, проверка — та же команда с `--check`.
|
||
- curl → uclient-fetch → wget: переход происходит после ошибки, ссылки на один
|
||
исполняемый файл не повторяются. Частичные ответы удаляются. Секреты, URL с
|
||
параметрами, подписанные адреса перенаправлений и сырые заголовки не печатаются.
|
||
- Для Xray выполняется GET без обязательного HEAD. Один файл имеет общий бюджет
|
||
до 120 секунд на все клиенты и источники, подготовка Xray — до 300 секунд.
|
||
Завершение процессов и уборка временных данных могут занять ещё несколько секунд.
|
||
- DNS/TLS/тайм-аут/403 останавливают перебор пакетов. Подтверждённый 404/410 позволяет
|
||
проверить следующий опубликованный asset. Ошибки совместимости проверяют следующие
|
||
кандидаты в пределах общего бюджета.
|
||
- Список релизов, имена файлов, размеры и SHA256 берутся из официального GitHub API.
|
||
Сохраняются проверки формата, точной архитектуры/ABI, зависимостей целевой системы,
|
||
версии и фактической поддержки VLESS reverse. Фиксированной версии пакета нет.
|
||
- Существующий исправный Xray используется повторно. Проверенная постоянная сжатая
|
||
копия создаётся до замены бинарника; восстановление из неё не требует GitHub.
|
||
- Без настроек Hub установка возвращает успех и сообщает:
|
||
«Установлено. Добавьте OpenWrt config из Hub для запуска туннеля».
|
||
Существующие UCI и ключ веб-панели сохраняются.
|
||
|
||
В диагностике `http=000` означает, что клиент не сообщил HTTP-статус. Это не ответ
|
||
HTTP 000. Например, DNS-сбой curl показывает `tool=curl; http=000; rc=6; reason=DNS`.
|
||
`client_context` сохраняет отдельную причину ошибки контекста uclient: она сама по
|
||
себе не доказывает проблему TLS или нехватку RAM.
|
||
|
||
curl сохраняет разрешение DNS и привязку каждого перенаправления к выбранному WAN.
|
||
Резервные минимальные клиенты используют системный DNS, о чём агент сообщает при
|
||
WAN direct. Скрипты не меняют WAN/DNS/маршруты/Podkop/Xray transport.
|
||
|
||
## Зеркало
|
||
|
||
Готового доверенного зеркала проекта сейчас нет. По умолчанию используются только
|
||
официальные GitHub API/Assets; случайные публичные прокси не подключаются.
|
||
Полная недоступность GitHub без исправного локального Xray/кэша остаётся явной
|
||
ошибкой загрузки. Смена клиента не гарантирует обход сетевой блокировки.
|
||
|
||
Для будущего собственного HTTPS-зеркала предусмотрены `XRAY_PACKAGE_MIRROR`
|
||
в окружении или `owrtremote.main.xray_package_mirror` в UCI. Формат адресов:
|
||
`https://YOUR-MIRROR/xray/vVERSION/PUBLISHED_ASSET_NAME`. Адрес не должен содержать
|
||
пароль, query или fragment. Ожидаемая SHA256 всё равно берётся из официального API;
|
||
метаданные зеркало не подменяет. При включённом зеркале первая половина бюджета
|
||
файла отведена официальному источнику, вторая остаётся для зеркала.
|
||
|
||
## Локальная проверка на роутере
|
||
|
||
PowerShell Windows 11; отдельная установка исправления на существующий клиент:
|
||
|
||
```powershell
|
||
$Fix = Join-Path $env:USERPROFILE 'Documents\openwrt overlay\vps\deploy-xray-download-fix.ps1'
|
||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Router root@192.168.2.1 -Action Install
|
||
```
|
||
|
||
Скрипт сохраняет агент в
|
||
`/root/owrt-remote-backup-before-xray-download-v121`, устанавливает новый агент и
|
||
выполняет `prepare-xray`. При ошибке автоматически восстанавливает прежний агент.
|
||
Рабочий Xray, проверенный кэш и настройки не удаляются. Действующий туннель
|
||
скрипт не перезапускает. Если первая установка прервалась до создания web.key,
|
||
ключ создаётся только при его отсутствии.
|
||
|
||
Откат кода агента, с сохранением исправного бинарника и кэша:
|
||
|
||
```powershell
|
||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Router root@192.168.2.1 -Action Rollback
|
||
```
|
||
|
||
Для первичной установки из локальных исходников установщик также можно запускать
|
||
на роутере из копии проекта. Публичная однострочная команда не меняется:
|
||
|
||
```sh
|
||
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/install.sh?v=$(date +%s)" | sh
|
||
```
|
||
|
||
Диагностический режим установки включается переменной
|
||
`OWRT_REMOTE_INSTALL_DIAGNOSTIC=1` у процесса `sh`, исполняющего установщик. Он
|
||
показывает stdout/stderr этапов и коды возврата, без `set -x` и дампа UCI.
|
||
|
||
## Проверки
|
||
|
||
Регрессионные сценарии: отказ curl с успешным резервным клиентом; дедупликация
|
||
wget/uclient-fetch; сохранение исходного rc; DNS/TLS/ошибка записи; отсутствие HEAD;
|
||
остановка перебора при сетевой ошибке; 404; общий бюджет; зависший дочерний процесс;
|
||
официальная SHA256 при использовании зеркала; повреждённый пакет; сохранение
|
||
рабочего Xray и загрузочного кэша; установка и откат локального исправления.
|
||
|
||
Матрица выбора assets проверяет IPK/APK и точные имена aarch64, ARM, MIPS/MIPSel,
|
||
MIPS64, i386 и x86_64. Она не означает, что upstream публикует пакет для каждого
|
||
теоретического имени CPU. Если соответствующего asset нет, чужая архитектура
|
||
не подставляется. Прогоны BusyBox ash и реальные роутеры отмечаются отдельно;
|
||
полный физический прогон на всех CPU не заявляется.
|
||
|
||
Результаты локального прогона 21.11.2026:
|
||
|
||
- Linux BusyBox ash 1.36.1: 38 проверок успешны, включая 22 комбинации
|
||
точных архитектур и форматов в одной проверке матрицы.
|
||
- Windows POSIX shell: в основном прогоне bootstrap/выбора релизов/установщика
|
||
55 тестов прошли, 2 требуют Linux; дополнительные проверки упаковки и локального
|
||
развёртывания также успешны.
|
||
- Реальная HTTPS-загрузка официального release asset размером 12 243 318 байт
|
||
через новый код прошла с HTTP 200; SHA256 совпала с GitHub API. Этот файл
|
||
использован только для проверки скачивания, на роутер он не устанавливался.
|
||
- Установка на проблемный физический GL-MT6000 / OpenWrt 25.12.6 ещё не выполнена.
|