Files
luci-app-owrt-remote/docs/XRAY_DOWNLOAD_RECOVERY.md
T
kzolotarev95 70a4705e67
OpenWrt IPK and APK / Validate source and resolve stable SDKs (push) Waiting to run
Release v122 with Tachyon integration and resilient Xray downloads
2026-11-21 22:53:52 +04:00

11 KiB
Raw Blame History

Автоматическая установка и загрузка 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 ещё не выполнена.