Release v122 with Tachyon integration and resilient Xray downloads
OpenWrt IPK and APK / Validate source and resolve stable SDKs (push) Waiting to run

This commit is contained in:
kzolotarev95 committed 2026-11-21 22:53:52 +04:00
1 parent f4ccbf82f3
commit 70a4705e67
50 files changed
+3173 -181

No files matched your search

+123
View File
@@ -0,0 +1,123 @@
# Автоматическая установка и загрузка 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 ещё не выполнена.