11 KiB
Автоматическая установка и загрузка 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; отдельная установка исправления на существующий клиент:
$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.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Router root@192.168.2.1 -Action Rollback
Для первичной установки из локальных исходников установщик также можно запускать на роутере из копии проекта. Публичная однострочная команда не меняется:
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 ещё не выполнена.