diff --git a/README.md b/README.md
index c293a63..f936470 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,13 @@ Xray и недоступном SSH-туннеле, если агент прод
Установка, проверка и откат.
+
+Tachyon: автоматическое обнаружение пакета на каждом роутере,
+версия и Online/Offline, открытие отдельного веб-интерфейса или старого LuCI
+через авторизованный туннель Hub.
+Локальная установка, проверка и откат.
+
+
@@ -189,9 +196,13 @@ owrt-remote doctor
owrt-remote status
```
+Если загрузка Xray прерывается: общий загрузчик с переключением клиентов,
+диагностика DNS/TLS/HTTP, локальная установка исправления и откат описаны в
+[docs/XRAY_DOWNLOAD_RECOVERY.md](docs/XRAY_DOWNLOAD_RECOVERY.md).
+
Готовые пакеты для OpenWrt
-OpenWrt 23.05/24.10 и APK для 25.12. Пакеты
+IPK для OpenWrt 23.05/24.10 и APK для 25.12. Пакеты
архитектурно независимые (`all`/`noarch`): содержат тот же агент и LuCI-файлы,
что и `install.sh`, сохраняют `/etc/config/owrtremote` и существующий Xray.
GitHub Actions проверяет SDK разных архитектур, установку/обновление/удаление
diff --git a/docs/OPENWRT_PACKAGES.md b/docs/OPENWRT_PACKAGES.md
index 5c78141..7c7f077 100644
--- a/docs/OPENWRT_PACKAGES.md
+++ b/docs/OPENWRT_PACKAGES.md
@@ -144,12 +144,12 @@ Workflow `.github/workflows/openwrt-packages.yml` запускается на т
публикации Release, изменениях пакета в pull request и вручную. В PR и при
обычном ручном запуске он только собирает и тестирует. Для повторной публикации
после исправления сборочного инструмента доступен ручной запуск с
-`publish_release=true` и существующим `release_tag`, например `v121`.
+`publish_release=true` и существующим `release_tag`, например `v122`.
Он не перемещает тег и проверяет, что содержимое `files/` и установочные
помощники совпадают с этим тегом. Рецепт и инструменты сборки могут содержать
исправления; точный commit сборки записывается в отчёте. После проверок
пакеты прикладываются к Release.
-Тег должен совпадать с `PKG_VERSION`: текущий пример — `v121`.
+Тег должен совпадать с `PKG_VERSION`: текущий пример — `v122`.
Следующий выпуск должен получить новую версию или пакетную ревизию в Makefile.
На каждом запуске выбирается последняя стабильная patch-версия веток
diff --git a/docs/TACHYON_INTEGRATION.md b/docs/TACHYON_INTEGRATION.md
new file mode 100644
index 0000000..e02b3a2
--- /dev/null
+++ b/docs/TACHYON_INTEGRATION.md
@@ -0,0 +1,241 @@
+# Tachyon в карточке роутера
+
+Интеграция включена в Remote Hub v122. Обновить нужно Hub на VPS и агент
+на роутере; Tachyon устанавливается отдельно и автоматически не загружается.
+
+## Обнаружение
+
+Агент проверяет установленные пакеты tachyon и luci-app-tachyon через
+действующий менеджер пакетов: APK либо opkg. Проверка не обращается к репозиториям
+и не устанавливает зависимости. Открытый порт без установленного пакета
+не создаёт интеграцию.
+
+Короткая проверка procd и HTTP различает наличие пакета и доступность интерфейса.
+Для ветки 2.x порт берётся из tachyon.settings.listen_port, по умолчанию 1680.
+Для старых версий используется LuCI через существующий вход Админки. В старой
+ветке listen_port может относиться к прокси, поэтому этот параметр не принимается
+за порт веб-интерфейса.
+
+Результат включается в защищённый Heartbeat. Кэш обнаружения находится только
+в /tmp/owrt-remote-tachyon, обновляется не реже раза в 30 секунд и не содержит
+конфигураций или секретов. Временные файлы удаляются; размер файла ограничен.
+Неудачная проверка пакетов не считается удалением Tachyon. Hub сохраняет
+последний подтверждённый факт установки, но показывает Offline.
+
+У каждого роутера отдельное состояние. После успешной проверки отсутствующего
+пакета блок исчезает. После новой установки он появляется автоматически. Смена
+только состояния службы не перезапускает серверный Xray.
+
+## Удалённый доступ
+
+Кнопка открывает /tachyon/ROUTER_ID/ в отдельной вкладке. Проверяется вход
+в Hub и право Админки A именно на выбранный роутер. Изменяющие запросы
+дополнительно проверяют Origin/Referer. Пароли и токены не добавляются в URL.
+
+Для отдельного веб-сервера Hub выделяет свободный вход Xray, доступный только
+на 127.0.0.1 VPS. Он использует уже существующий аутентифицированный reverse
+канал Админки. В клиенте добавляется правило только для обнаруженного TCP-порта
+127.0.0.1:PORT и соответствующего reverse-тега. Остальной HTTP и SSH идут
+по прежним правилам. Адрес назначения фиксирован; HTTP-запрос не может выбрать
+другой хост или порт.
+
+При установке, удалении или смене порта Tachyon агент обновляет конфигурацию
+только своего Xray. Возможен короткий разрыв обратного туннеля. Heartbeat
+продолжает работать; ручная остановка Xray через Remote сохраняется. Автоматическая
+операция использует общую блокировку с Remote управлением Xray.
+Настройки Tachyon, WAN, DNS, Podkop, firewall и policy routing не меняются.
+
+HTML, LuCI-ресурсы, fetch/XHR и REST-пути переписываются с префиксом выбранного
+роутера. Cookies Tachyon получают собственный путь; сессионные cookies Hub
+не отправляются на роутер. Старый Tachyon открывается через существующий
+авторизованный прокси LuCI.
+
+Online означает свежий Heartbeat, запущенный процесс Xray и доступность
+интерфейса по локальной проверке агента. Это не заменяет фактическую проверку
+открытия страницы: внешняя проблема туннеля может проявиться при переходе.
+Offline сохраняет кнопку, чтобы не путать недоступность с удалением пакета.
+
+## Реальные интерфейсы Tachyon
+
+Изучены [main](https://github.com/Dushnilin/tachyon) и исходники установленной
+у пользователя версии
+[v2.0.0-beta.8](https://github.com/Dushnilin/tachyon/tree/v2.0.0-beta.8) и
+[v2.0.0-beta.14](https://github.com/Dushnilin/tachyon/tree/v2.0.0-beta.14).
+Архитектура этих веток различается, поэтому одного README недостаточно.
+
+В beta.8 Rust HTTP-сервер отдаёт LuCI SPA и ubus-мост на 1680. REST API находится
+в /api/agent/v1, включая health и openapi.json; CGI-подобный alias
+/cgi-bin/tachyon-agent обслуживается этим же Rust-сервером. Он не означает,
+что такой CGI-файл есть у uhttpd на 80. API проверяет сессию, Bearer token либо
+доверенный локальный адрес. Интеграция не извлекает и не сохраняет API-токены:
+открытие происходит через авторизованный Hub, а оригинальная авторизация
+Tachyon сохраняется.
+
+В другой изученной ветке CGI /cgi-bin/tachyon-agent относится к uhttpd.
+Агент проверяет существование файла и успешный read-only health-ответ перед
+передачей метаданных API. Для Rust API на обнаруженном порту проверяется
+типизированное поле core_running; остановленное ядро не приравнивается
+к отсутствию REST API. Если OpenAPI сообщает версию работающей программы,
+она отображается в карточке; версия пакета сохраняется отдельно в package_version.
+Управление Tachyon через отдельные Hub-команды
+в эту реализацию не входит.
+
+## Локальная установка и откат
+
+Сначала обновить VPS, затем агент роутера:
+
+~~~powershell
+$Fix = Join-Path $env:USERPROFILE 'Documents\openwrt overlay\vps\deploy-tachyon.ps1'
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -Action Install
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Router root@192.168.2.1 -Action Install
+~~~
+
+Пароль вводится в SSH, не передаётся в аргументах. Скрипт проверяет синтаксис,
+создаёт резервную копию, сверяет установленные файлы и проверяет запуск
+Heartbeat либо ревизию работающего Hub. База и конфиг owrtremote сохраняются.
+Миграция базы добавляет один совместимый столбец для внутреннего порта.
+
+Откат в обратном порядке:
+
+~~~powershell
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Router root@192.168.2.1 -Action Rollback
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -Action Rollback
+~~~
+
+Копия на каждом устройстве: /root/owrt-remote-backup-before-tachyon-integration-v121.
+При откате VPS прежний генератор пересоздаёт конфигурацию Xray без нового входа.
+Дополнительный столбец базы безвреден для прежнего Hub и не удаляется.
+
+Проверка после установки:
+
+~~~powershell
+ssh root@192.168.2.1 'owrt-remote tachyon-status'
+~~~
+
+Дождаться одного Heartbeat и обновить страницу Hub через Ctrl+F5. При обычном
+интервале обнаружение занимает до 30–60 секунд. Для проверки локального кода
+использовать этот скрипт, поскольку опубликованная сборка GitHub пока другая.
+
+## Проверки
+
+По предоставленному пользователем выводу реального роутера: пакет
+tachyon 2.0.0~beta.8-1, служба tachyon запущена, uhttpd на 80,
+tachyon.settings.listen_port=1680, HTTP 200 на loopback и LAN:1680,
+старый LuCI URL возвращает 403. CGI REST на uhttpd не найден.
+Дополнительные GET-запросы с компьютера подтвердили HTTP 200 для корневой
+страницы, /api/agent/v1/health и /api/agent/v1/openapi.json на порту 1680.
+Health сообщил core_running=true; OpenAPI и заголовок страницы сообщили
+2.0.0-beta.14, хотя пакетный менеджер показывает beta.8. Эти версии намеренно
+не смешиваются. Переустановка или обновление Tachyon не выполнялись.
+
+Локальные тесты проверяют opkg/APK, старый LuCI, собственный порт, остановку,
+ошибку инвентаризации, удаление/переустановку, независимость роутеров,
+потерю/восстановление Heartbeat, запрещённые адреса/порты и ручную остановку Xray.
+HTTP-тесты проверяют 401/403, выбор роутера, изоляцию cookies, REST POST/PUT/DELETE
+и защиту Origin. Node проверяет появление/исчезновение блока, Offline,
+экранирование и обе реализации карточек.
+
+Настоящие Xray 26.6.27 (клиент) и 26.10.21 (сервер) успешно провели одновременно
+HTTP Админки, SSH и отдельный HTTP Tachyon с разными ответами. Проверены оба
+генератора конфигурации. Это стенд на loopback, не реальный удалённый роутер.
+Дополнительно прошли 41 регрессия WAN/Heartbeat, 22 проверки пакетов и проверки
+Remote управления Xray. Установку/удаление и остановку Tachyon на рабочем
+роутере ради теста не выполняли; установка локальной интеграции на него
+и проверка через рабочую VPS ещё предстоят.
+Четыре сценария обнаружения и генерации выполнены в Linux на BusyBox ash 1.36.1.
+Пять сценариев установщика проверяют повторную установку, откат с удалением
+ранее отсутствовавшего helper, ошибки preflight и восстановление после отказа
+перезапуска. Дополнительные команды пакетов на рабочем роутере не выполнялись.
+В отдельной Ubuntu 24.04 выполнены установка нового Hub и откат этим же
+PowerShell-скриптом: работающая ревизия подтверждена в обоих случаях.
+Проверено также переписывание настоящего HTML интерфейса с роутера и синтаксис
+встроенных скриптов после переписывания.
+
+Изменённые и добавленные файлы: files/usr/sbin/owrt-remote,
+files/usr/lib/owrt-remote/tachyon.sh, install.sh, uninstall.sh, vps/owrt-remote-hub.py,
+vps/deploy-tachyon.ps1, vps/diagnose-tachyon.ps1, tests/test_tachyon.py,
+tests/test_tachyon_ui.cjs, tests/test_tachyon_deploy.py, tests/test_xray_reverse_transport.py,
+README.md и этот документ.
+
+## Исправление для VPS с Xray 26.3.27
+
+На рабочем сервере подтверждён Xray 26.3.27. Этот выпуск принимает имя
+протокола tunnel, но использует исходные настройки network/address/port,
+игнорируя новые allowedNetwork/rewriteAddress/rewritePort. Поэтому в reverse
+передавался порт входа VPS вместо 1680, правило клиента не совпадало и запрос
+получал обычную Админку. Это объясняет переход на /cgi-bin/luci/.
+
+Генератор Hub теперь выдаёт оба набора полей с одинаковыми значениями.
+На настоящем Xray 26.3.27 ошибка воспроизведена до исправления: отдельный вход
+Tachyon возвращал ответ HTTP-стенда Админки. После исправления он возвращает
+ответ именно Tachyon; HTTP Админки и SSH продолжают работать.
+
+Для уже установленной локальной интеграции нужно применить исправление на VPS:
+
+~~~powershell
+$Fix = Join-Path $env:USERPROFILE 'Documents\openwrt overlay\vps\deploy-tachyon-route-fix.ps1'
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -Action Install
+~~~
+
+Скрипт сохраняет текущие файлы Hub и Xray, дополняет только настройки
+управляемых Remote входов, проверяет JSON установленным Xray, затем применяет
+изменения и перезапускает Hub и серверный Xray. Остальные параметры JSON,
+включая порт VLESS, клиентов и посторонние службы, сохраняются.
+На время перезапуска возможен короткий разрыв туннелей. Бинарники Xray
+и файлы роутера не меняются.
+
+Откат именно этого исправления:
+
+~~~powershell
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -Action Rollback
+~~~
+
+Оба файла восстанавливаются из
+/root/owrt-remote-backup-before-tachyon-route-fix-v121. Неудачная проверка Xray
+останавливает установку до замены файлов; отказ перезапуска вызывает
+восстановление копии текущей попытки.
+
+Дополнительно добавлены vps/deploy-tachyon-route-fix.ps1,
+vps/diagnose-tachyon-vps.ps1 и tests/test_tachyon_route_deploy.py.
+Диагностика VPS передаёт код в base64, чтобы Windows PowerShell не повреждал
+завершение Python heredoc. По первоначальному выводу данные были собраны
+полностью; завершающий NameError: PY относится к передаче скрипта, а не к Xray.
+
+## Пустое место над интерфейсом
+
+Общий обработчик оформления Hub первоначально исключал /access/, но не новый
+маршрут /tachyon/. В страницу Tachyon попадало правило общих эффектов,
+устанавливающее position:relative для прямых дочерних элементов body.
+Оно переопределяло position:fixed у .tachyon-bg-layer. Фон становился обычным
+блоком и сдвигал панель ниже первого экрана; в браузере воспроизведён отступ 720 px.
+
+Обработка /tachyon/ теперь сохраняет собственные CSS и JavaScript Tachyon.
+Переписывание URL для удалённого доступа продолжает работать.
+Принудительная прокрутка и дополнительные отступы не добавляются.
+
+Для уже установленной интеграции:
+
+~~~powershell
+$Fix = Join-Path $env:USERPROFILE 'Documents\openwrt overlay\vps\deploy-tachyon-layout.ps1'
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -Action Install
+~~~
+
+Откат:
+
+~~~powershell
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -Action Rollback
+~~~
+
+Установка меняет только файл Hub и перезапускает его веб-службу. Копия:
+/root/owrt-remote-backup-before-tachyon-layout-v121. Файлы роутера и конфигурация
+Xray при установке этого исправления не меняются.
+
+Проверки: два теста общих тем, два HTTP-теста прокси и 18 браузерных сочетаний
+1280x900 / 390x844 / 844x390 с сохранёнными режимами default / winter / lite.
+В браузере проверены самостоятельный пример и настоящий HTML Tachyon beta.14:
+фон имеет position:fixed, верх maincontent находится на 0 px, прокрутка равна
+нулю, дополнительный canvas Hub отсутствует. Загрузка RPC в этой проверке
+отключена, поэтому параметры роутера не изменяются.
+
+Дополнительно добавлены vps/deploy-tachyon-layout.ps1 и tests/test_tachyon_layout.cjs;
+обновлены tests/test_hub_design_global.py и tests/test_tachyon.py.
diff --git a/docs/XRAY_DOWNLOAD_RECOVERY.md b/docs/XRAY_DOWNLOAD_RECOVERY.md
new file mode 100644
index 0000000..3d7505f
--- /dev/null
+++ b/docs/XRAY_DOWNLOAD_RECOVERY.md
@@ -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 ещё не выполнена.
diff --git a/files/usr/lib/owrt-remote/tachyon.sh b/files/usr/lib/owrt-remote/tachyon.sh
new file mode 100644
index 0000000..c285376
--- /dev/null
+++ b/files/usr/lib/owrt-remote/tachyon.sh
@@ -0,0 +1,147 @@
+#!/bin/sh
+# Discovery only: never starts/stops Tachyon or changes its UCI/network settings.
+TACHYON_RUNTIME="${OWRT_REMOTE_TACHYON_RUNTIME:-${TMPDIR:-/tmp}/owrt-remote-tachyon}"
+
+tachyon_inventory_failed() {
+ if [ -s "$TACHYON_RUNTIME/status" ]; then
+ sed 's/"checked":true/"checked":false/;s/"available":true/"available":false/' "$TACHYON_RUNTIME/status"
+ else printf '{"checked":false}'; fi
+}
+
+tachyon_json() (
+ local dir package version package_version mode port service available api code pkg rc now last admin_port
+ umask 077
+ ulimit -f 64
+ mkdir -p "$TACHYON_RUNTIME" || { printf '{"checked":false}'; return; }
+ if [ "${1:-}" != force ] && [ -s "$TACHYON_RUNTIME/status" ]; then
+ now="$(cut -d. -f1 /proc/uptime)"
+ last="$(cat "$TACHYON_RUNTIME/updated" 2>/dev/null)"
+ case "$last" in ''|*[!0-9]*) ;; *)
+ if [ "$now" -ge "$last" ] && [ $((now-last)) -lt 30 ]; then cat "$TACHYON_RUNTIME/status"; return; fi ;;
+ esac
+ fi
+ dir="$(mktemp -d "$TACHYON_RUNTIME/probe.XXXXXX")" || { printf '{"checked":false}'; return; }
+ trap 'rm -f "$dir/package" "$dir/json"; rmdir "$dir" 2>/dev/null || true' EXIT
+ trap 'exit 1' INT TERM
+ package=''; version=''
+ if command -v apk >/dev/null 2>&1; then
+ apk info >"$dir/package" 2>/dev/null || { tachyon_inventory_failed; return; }
+ for pkg in tachyon luci-app-tachyon; do
+ grep -qx "$pkg" "$dir/package" || continue
+ package="$pkg"
+ version="$(apk info -v "$pkg" 2>/dev/null | sed -n "s/^$pkg-//p" | head -n 1 | awk '{print $1}')"
+ break
+ done
+ elif command -v opkg >/dev/null 2>&1; then
+ for pkg in tachyon luci-app-tachyon; do
+ opkg status "$pkg" >"$dir/package" 2>/dev/null || { tachyon_inventory_failed; return; }
+ package="$(awk '/^Package:/{p=$2} /^Status:.* installed$/{print p;exit}' "$dir/package")"
+ [ -n "$package" ] || continue
+ version="$(awk -v wanted="$package" '/^Package:/{p=$2} p==wanted && /^Version:/{print $2;exit}' "$dir/package")"
+ break
+ done
+ else
+ tachyon_inventory_failed; return
+ fi
+ case "$package" in tachyon|luci-app-tachyon) ;; *) package='' ;; esac
+ if [ -z "$package" ]; then
+ printf '{"checked":true,"installed":false}\n' >"$dir/json"
+ else
+ package_version="$version"
+ port=0
+ mode=luci
+ # Older Tachyon can use listen_port for a proxy, not its web UI.
+ case "$version" in 2.*|[3-9].*)
+ mode=standalone
+ port="$(uci -q get tachyon.settings.listen_port 2>/dev/null)"
+ ;;
+ esac
+ case "$port" in ''|*[!0-9]*) port=0 ;; esac
+ [ "${#port}" -le 5 ] || port=0
+ [ "$port" -ge 1024 ] && [ "$port" -le 65535 ] || port=0
+ port="$(printf '%s' "$port" | awk '{printf "%d", $1}')"
+ [ "$mode" != standalone ] || [ "$port" != 0 ] || port=1680
+ service=unknown
+ for pkg in tachyon tachyon-core; do
+ rc="$(ubus call service list "{\"name\":\"$pkg\"}" 2>/dev/null |
+ jsonfilter -e "@[\"$pkg\"].instances.*.running" 2>/dev/null)"
+ if printf '%s\n' "$rc" | grep -qx true; then service=running; break; fi
+ [ -z "$rc" ] || service=stopped
+ done
+ available=false; api=''
+ if [ "$mode" = standalone ]; then
+ code="$(curl -q -s --noproxy '*' --connect-timeout 1 --max-time 2 -o /dev/null \
+ -w '%{http_code}' "http://127.0.0.1:$port/" 2>/dev/null)"
+ else
+ port=0
+ admin_port="$(uci_get admin_port 80)"
+ case "$admin_port" in ''|*[!0-9]*) admin_port=80 ;; esac
+ [ "$admin_port" -gt 0 ] && [ "$admin_port" -le 65535 ] || admin_port=80
+ code="$(curl -q -s --noproxy '*' --connect-timeout 1 --max-time 2 -o /dev/null \
+ -w '%{http_code}' "http://127.0.0.1:$admin_port/cgi-bin/luci/admin/services/tachyon" 2>/dev/null)"
+ fi
+ case "$code" in 2??|3??|401|403) [ "$service" = stopped ] || available=true ;; esac
+ if [ "$mode" = standalone ] && [ "$available" = true ]; then
+ rc="$(curl -q -fsS --noproxy '*' --max-time 1 "http://127.0.0.1:$port/api/agent/v1/health" 2>/dev/null |
+ jsonfilter -e '@.core_running' 2>/dev/null)"
+ case "$rc" in true|false)
+ api='/api/agent/v1'
+ rc="$(curl -q -fsS --noproxy '*' --max-time 1 --max-filesize 65536 \
+ "http://127.0.0.1:$port/api/agent/v1/openapi.json" 2>/dev/null | jsonfilter -e '@.info.version' 2>/dev/null)"
+ case "$rc" in ''|*[!a-zA-Z0-9.+~_-]*) ;; *) [ "${#rc}" -gt 80 ] || version="$rc" ;; esac
+ ;;
+ esac
+ fi
+ for pkg in tachyon-api tachyon-agent; do
+ [ -z "$api" ] || break
+ [ -e "/www/cgi-bin/$pkg" ] || continue
+ rc="$(curl -q -fsS --noproxy '*' --max-time 1 \
+ "http://127.0.0.1/cgi-bin/$pkg/health" 2>/dev/null |
+ jsonfilter -e '@.success' 2>/dev/null)"
+ [ "$rc" != true ] || { api="/cgi-bin/$pkg"; break; }
+ done
+ printf '{"checked":true,"installed":true,"version":%s,"package_version":%s,"mode":"%s","port":%s,"service":"%s","available":%s,"api":%s}\n' \
+ "$(json_string "$(printf '%s' "$version" | head -c 80)")" "$(json_string "$(printf '%s' "$package_version" | head -c 80)")" \
+ "$mode" "$port" "$service" "$available" "$(json_string "$api")" >"$dir/json"
+ fi
+ cat "$dir/json"
+ mv -f "$dir/json" "$TACHYON_RUNTIME/status"
+ cut -d. -f1 /proc/uptime >"$TACHYON_RUNTIME/updated"
+)
+
+tachyon_tunnel_port() {
+ local state port
+ state="$(tachyon_json)"
+ [ "$(printf '%s' "$state" | jsonfilter -e '@.installed' 2>/dev/null)" = true ] || { printf 0; return; }
+ [ "$(printf '%s' "$state" | jsonfilter -e '@.mode' 2>/dev/null)" = standalone ] || { printf 0; return; }
+ port="$(printf '%s' "$state" | jsonfilter -e '@.port' 2>/dev/null)"
+ case "$port" in ''|*[!0-9]*) port=0 ;; esac
+ [ "$port" -ge 1024 ] && [ "$port" -le 65535 ] || port=0
+ printf '%s' "$port"
+}
+
+tachyon_reconcile_xray() {
+ local desired current config slot
+ truthy "$(uci_get enabled 0)" || return 0
+ xray_control_stopped && return 0
+ xray_running || return 0
+ [ "$(tachyon_json | jsonfilter -e '@.checked' 2>/dev/null)" = true ] || return 0
+ desired="$(tachyon_tunnel_port)"
+ config="$(uci_get xray_config /etc/xray/owrt-remote-client.json)"
+ current="$(jsonfilter -i "$config" -e '@.outbounds[@.tag="router-tachyon"].settings.redirect' 2>/dev/null)"
+ [ "$desired" != 0 ] || desired=''
+ [ -z "$desired" ] || desired="127.0.0.1:$desired"
+ [ "$current" != "$desired" ] || return 0
+ slot="$(cut -d. -f1 /proc/uptime)"; slot=$((slot/120))
+ ubus call service add "{\"name\":\"owrt-remote\",\"instances\":{\"tachyon-reconfigure\":{\"command\":[\"/usr/sbin/owrt-remote\",\"tachyon-reconfigure\",\"$desired\",\"$slot\"],\"stdout\":true,\"stderr\":true}}}" >/dev/null 2>&1
+}
+
+tachyon_reconfigure() (
+ xray_control_lock "$CONTROL_RUNTIME/worker-lock" || return 0
+ trap 'rm -f "$CONTROL_RUNTIME/worker-lock/pid"; rmdir "$CONTROL_RUNTIME/worker-lock" 2>/dev/null || true' EXIT
+ trap 'exit 1' INT TERM
+ xray_control_stopped && return 0
+ truthy "$(uci_get enabled 0)" || return 0
+ log 'Tachyon: обновление локального маршрута в обратном туннеле'
+ xray_control_execute restart
+)
diff --git a/files/usr/sbin/owrt-remote b/files/usr/sbin/owrt-remote
index 60df2ac..4d6ed53 100644
--- a/files/usr/sbin/owrt-remote
+++ b/files/usr/sbin/owrt-remote
@@ -38,6 +38,7 @@ usage() {
owrt-remote heartbeat
owrt-remote heartbeat-loop
owrt-remote heartbeat-diagnostics
+ owrt-remote tachyon-status
owrt-remote logs-sync
owrt-remote network-diagnostics
@@ -149,6 +150,14 @@ else
xray_control_result_json() { printf null; }
xray_control_dispatch() { return 0; }
fi
+TACHYON_HELPER="${OWRT_REMOTE_TACHYON_HELPER:-/usr/lib/owrt-remote/tachyon.sh}"
+if [ -r "$TACHYON_HELPER" ]; then
+ . "$TACHYON_HELPER"
+else
+ tachyon_json() { printf '{"checked":false}'; }
+ tachyon_tunnel_port() { printf 0; }
+ tachyon_reconcile_xray() { :; }
+fi
host_model() {
if [ -r /tmp/sysinfo/model ]; then
@@ -447,8 +456,8 @@ xray_discover_releases() (
# Older pages are fetched on demand after candidates fail validation.
page="${3:-1}"
while [ "$page" -le 10 ]; do
- fetch_file "$XRAY_RELEASE_API_URL?per_page=20&page=$page" "$work/releases.json" || {
- log 'ERROR: GitHub API unavailable; existing Xray preserved'; return 1;
+ DOWNLOAD_STAGE=xray-releases fetch_file "$XRAY_RELEASE_API_URL?per_page=20&page=$page" "$work/releases.json" || {
+ rc=$?; log "ERROR: GitHub API unavailable (rc=$rc); existing Xray preserved"; return "$rc";
}
[ "$(wc -c <"$work/releases.json")" -le 2097152 ] || return 1
# Validate JSON, including an empty array. API error objects fail closed.
@@ -645,6 +654,8 @@ EOF
)
render_client_config() (
+ local tachyon_port
+ tachyon_port="$(tachyon_tunnel_port)"
local temp_dir rc xray_host out stdout router_id vps_host vps_port uuid ssh_uuid encryption flow reverse_tag ssh_reverse_tag admin_host admin_port ssh_host ssh_port xray_config xray_config_dir
temp_dir=""
out=""
@@ -718,6 +729,7 @@ render_client_config() (
},
"inbounds": [],
"outbounds": [
+ $([ "$tachyon_port" = 0 ] || printf '{"tag":"router-tachyon","protocol":"freedom","settings":{"redirect":"127.0.0.1:%s","finalRules":[{"action":"allow","network":"tcp","port":%s}]}},' "$tachyon_port" "$tachyon_port")
{
"tag": "router-admin",
"protocol": "freedom",
@@ -773,6 +785,7 @@ render_client_config() (
],
"routing": {
"rules": [
+ $([ "$tachyon_port" = 0 ] || printf '{"type":"field","inboundTag":["%s"],"ip":["127.0.0.1"],"port":%s,"outboundTag":"router-tachyon"},' "$(json_escape "$reverse_tag")" "$tachyon_port")
{
"type": "field",
"inboundTag": [
@@ -862,6 +875,7 @@ heartbeat_json() {
"xray_control": $([ -r "$CONTROL_HELPER" ] && printf 1 || printf 0),
"xray_control_result": $(xray_control_result_json || printf null),
"ssh": $(json_string "$ssh_state"),
+ "tachyon": $(tachyon_json),
"event": $(json_string "$event"),
"service": $(json_string "$service_state")
}
@@ -1289,6 +1303,7 @@ send_heartbeat() {
mv -f "$dir/last" "${TMPDIR:-/tmp}/owrt-remote-heartbeat-last"
cat "$response"
xray_control_dispatch "$response" || log 'Remote Xray: команда не принята; повторная доставка при следующем Heartbeat'
+ tachyon_reconcile_xray || log 'Tachyon: обновление маршрута отложено'
log "Heartbeat: OK; Hub=$safe_endpoint; WAN_direct=$(uci_get wan_direct 0); WAN_active=$(cat "$WAN_STATE/active-interface" 2>/dev/null)"
return 0
fi
@@ -1703,77 +1718,184 @@ xray_cache_restore() (
return 1
)
-# Keep a finite wait even without BusyBox's optional timeout applet. The
-# foreground poll avoids a racing/orphaned watchdog when downloads finish fast.
-xray_native_fetch() (
- dst="$1"; shift
- client=''
- trap 'result=$?; [ -z "$client" ] || { kill -KILL "$client" 2>/dev/null || true; wait "$client" 2>/dev/null || true; }; [ "$result" = 0 ] || rm -f "$dst"' EXIT
- trap 'exit 1' INT TERM
- # Shells report file blocks in 512 or 1024 bytes: either limit stays <=32 MiB.
- ulimit -f 32768 || return 1
- "$@" & client=$!
+# BEGIN SHARED ROUTER DOWNLOADER
+# Shared, embedded in install.sh and the router agent by embed-router-download.py.
+# No dependency on curl/jsonfilter/timeout is needed to bootstrap curl itself.
+download_clock() {
+ if [ -r /proc/uptime ]; then cut -d. -f1 /proc/uptime; else date +%s; fi
+}
+download_note() {
+ if command -v log >/dev/null 2>&1; then log "$*"; else printf '%s\n' "$*" >&2; fi
+}
+download_origin() {
+ local authority
+ case "$1" in https://?*) ;; *) return 3 ;; esac
+ authority="${1#https://}"; authority="${authority%%/*}"
+ case "$authority" in ''|*[@\?\#\ ]*|*[!A-Za-z0-9.:-]*) return 3 ;; esac
+ case "$authority" in *:*) ;; *) authority="$authority:443" ;; esac
+ printf 'https://%s' "$authority"
+}
+download_signal_tree() {
+ local child
+ # Kill descendants first: a timed-out shell function may own a DNS client.
+ if [ -r "/proc/$1/task/$1/children" ]; then
+ for child in $(cat "/proc/$1/task/$1/children"); do download_signal_tree "$child" "$2"; done
+ fi
+ kill -"$2" "$1" 2>/dev/null || true
+}
+download_kill_tree() {
+ local ticks
+ download_signal_tree "$1" TERM
+ # Allow shell EXIT traps to release locks and staging files first.
ticks=0
- while kill -0 "$client" 2>/dev/null; do
- if [ "$ticks" -ge 120 ]; then
- kill -KILL "$client" 2>/dev/null || true
- wait "$client" 2>/dev/null || true
- client=''; return 28
- fi
+ while kill -0 "$1" 2>/dev/null && [ "$ticks" -lt 2 ]; do sleep 1; ticks=$((ticks+1)); done
+ download_signal_tree "$1" KILL
+}
+download_run() (
+ seconds="$1"; shift; child=''
+ trap 'result=$?; [ -z "$child" ] || { download_kill_tree "$child"; wait "$child" 2>/dev/null || true; }; exit "$result"' EXIT
+ trap 'exit 28' INT TERM
+ "$@" & child=$!
+ ticks=0
+ while kill -0 "$child" 2>/dev/null; do
+ [ "$ticks" -lt "$seconds" ] || return 28
sleep 1; ticks=$((ticks+1))
done
- rc=0; wait "$client" || rc=$?; client=''
+ rc=0; wait "$child" || rc=$?; child=''; return "$rc"
+)
+download_curl() (
+ url="$1"; dst="$2"; stats="$3"; method="$4"; deadline="$5"; hop=0
+ while [ "$hop" -le 5 ]; do
+ origin="$(download_origin "$url")" || return 3
+ set -- -q -fsS --connect-timeout 10 --noproxy '*' --proto '=https' --max-filesize 33554432
+ [ "$method" != HEAD ] || set -- "$@" -I
+ DL_DEVICE=''; DL_RESOLVE=''
+ # The agent resolves every redirect through its selected WAN. The
+ # installer has no routing hook and uses the router's system resolver.
+ if command -v download_route >/dev/null 2>&1; then download_route "$origin" || return $?; fi
+ [ -z "$DL_DEVICE" ] || set -- "$@" --interface "$DL_DEVICE"
+ [ -z "$DL_RESOLVE" ] || set -- "$@" --resolve "$DL_RESOLVE"
+ remaining=$((deadline - $(download_clock)))
+ [ "$remaining" -gt 0 ] || return 28
+ rc=0
+ curl "$@" --max-time "$remaining.000" -o "$dst" -w '%{http_code} %{redirect_url}\n' "$url" >"$stats" || rc=$?
+ [ "$rc" = 0 ] || return "$rc"
+ code=''; redirect=''; read -r code redirect <"$stats" || true
+ case "$code" in
+ 301|302|303|307|308) [ -n "$redirect" ] || return 47; url="$redirect"; hop=$((hop+1)) ;;
+ 200) [ -s "$dst" ] || return 52; return 0 ;;
+ *) return 22 ;;
+ esac
+ done
+ return 47
+)
+download_reason() {
+ case "$1" in
+ 3) printf invalid_https_url; return ;; 6) printf DNS; return ;;
+ 23|27) printf write; return ;; 28|124|137) printf timeout; return ;;
+ 35|51|58|60|77|80|82|83|90|91) printf TLS; return ;;
+ esac
+ if LC_ALL=C grep -Eqi 'no space|permission denied|read-only|write error|file too large' "$2"; then printf write
+ elif LC_ALL=C grep -Eqi 'resolv|bad address|name or service|DNS' "$2"; then printf DNS
+ elif LC_ALL=C grep -qi 'uclient context' "$2"; then printf client_context
+ elif LC_ALL=C grep -Eqi 'TLS|SSL|certificate' "$2"; then printf TLS
+ elif LC_ALL=C grep -Eqi 'timed out|timeout' "$2"; then printf timeout
+ elif [ "$3" != 000 ]; then printf HTTP
+ else printf network; fi
+}
+download_tools() {
+ local tool path identity seen
+ seen='|'
+ for tool in curl uclient-fetch wget; do
+ path="$(command -v "$tool" 2>/dev/null)" || continue
+ identity="$(readlink -f "$path" 2>/dev/null)"; identity="${identity:-$path}"
+ case "$seen" in *"|$identity|"*) continue ;; esac
+ seen="$seen$identity|"; printf '%s\n' "$tool"
+ done
+}
+remote_download() (
+ url="$1"; dst="$2"; method="${3:-GET}"
+ work="$(mktemp -d "${TMPDIR:-/tmp}/owrt-download.XXXXXX")" || return 23
+ trap 'result=$?; rm -rf "$work"; [ "$result" = 0 ] || rm -f "$dst"; exit "$result"' EXIT
+ trap 'exit 28' INT TERM
+ unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY all_proxy ALL_PROXY
+ # Also bound native clients and their error/response files on small RAM.
+ ulimit -f 32768 || return 23
+ deadline=$(( $(download_clock) + 120 ))
+ [ -z "${DOWNLOAD_RESULT_FILE:-}" ] || : >"$DOWNLOAD_RESULT_FILE"
+ for outer in "${XRAY_PREPARE_DEADLINE:-}" "${XRAY_FILE_DEADLINE:-}" "${DOWNLOAD_SOURCE_DEADLINE:-}"; do
+ [ -z "$outer" ] || [ "$outer" -ge "$deadline" ] || deadline="$outer"
+ done
+ origin="$(download_origin "$url")" || { download_note 'Download: reason=invalid_https_url; rc=3'; return 3; }
+ tools="$(download_tools)"; set -- $tools; left="$#"; rc=127
+ [ "$left" -gt 0 ] || download_note 'Download: stage=tools; reason=no_http_client; rc=127'
+ for tool in $tools; do
+ remaining=$((deadline - $(download_clock)))
+ [ "$remaining" -gt 0 ] || { rc=28; reason=timeout; break; }
+ # Reserve time for genuinely different fallback clients. No blind
+ # retries on dozens of releases when their common host is unavailable.
+ seconds=$((remaining / left)); [ "$seconds" -gt 0 ] || seconds=1
+ left=$((left-1)); attempt_end=$(( $(download_clock) + seconds ))
+ rm -f "$dst"; : >"$work/stats"; : >"$work/error"; rc=0
+ case "$tool" in
+ curl) download_run "$seconds" download_curl "$url" "$dst" "$work/stats" "$method" "$attempt_end" 2>"$work/error" || rc=$? ;;
+ *)
+ if command -v download_native_notice >/dev/null 2>&1; then download_native_notice; fi
+ download_run "$seconds" "$tool" -T "$seconds" -O "$dst" "$url" >"$work/stats" 2>"$work/error" || rc=$? ;;
+ esac
+ code=000
+ if [ "$tool" = curl ]; then
+ read -r code ignored <"$work/stats" || true
+ case "$code" in [1-5][0-9][0-9]) ;; *) code=000 ;; esac
+ else
+ code="$(LC_ALL=C sed -n -e 's/.*HTTP\/[0-9.]* *\([1-5][0-9][0-9]\).*/\1/p' -e 's/.*HTTP error \([1-5][0-9][0-9]\).*/\1/p' -e 's/.*awaiting response[. ]*\([1-5][0-9][0-9]\).*/\1/p' "$work/error" | tail -n 1)"
+ code="${code:-000}"
+ fi
+ if [ "$rc" = 0 ]; then
+ [ -s "$dst" ] && [ "$(wc -c <"$dst")" -le 33554432 ] || rc=23
+ fi
+ reason="$(download_reason "$rc" "$work/error" "$code")"
+ [ "$rc" != 0 ] || reason=ok
+ # Never print URLs, query strings, redirect signatures or raw headers.
+ download_note "Download: stage=${DOWNLOAD_STAGE:-file}; tool=$tool; host=$origin; http=$code; rc=$rc; reason=$reason"
+ [ -z "${DOWNLOAD_RESULT_FILE:-}" ] || printf '%s %s %s\n' "$rc" "$reason" "$code" >"$DOWNLOAD_RESULT_FILE"
+ [ "$rc" != 0 ] || return 0
+ case "$reason" in write|invalid_https_url) break ;; esac
+ done
+ [ "$rc" != 28 ] || download_note 'Download: reason=timeout; file/preparation deadline reached or HTTP client timed out'
+ [ -z "${DOWNLOAD_RESULT_FILE:-}" ] || printf '%s %s %s\n' "$rc" "${reason:-no_http_client}" "${code:-000}" >"$DOWNLOAD_RESULT_FILE"
return "$rc"
)
+# END SHARED ROUTER DOWNLOADER
-# Bound one complete download, including redirects. In WAN mode use the
-# selected resolver on every HTTPS hop, retaining hostname verification/SNI.
-fetch_file() (
- url="$1"; dst="$2"; method="${3:-GET}"; rm -f "$dst"
- stats=''
- trap 'result=$?; rm -f "$stats"; [ "$result" = 0 ] || rm -f "$dst"' EXIT
- trap 'exit 1' INT TERM
- unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY all_proxy ALL_PROXY
- if command -v curl >/dev/null 2>&1; then
- stats="$(mktemp "${TMPDIR:-/tmp}/owrt-xray-http.XXXXXX")" || return 1
- started="$(remote_clock_ms)"; hop=0; rc=1
- while [ "$hop" -le 5 ]; do
- origin="$(remote_url_origin "$url")" || return 3
- case "$origin" in https://*) ;; *) log 'Xray: отклонена загрузка без HTTPS'; return 3 ;; esac
- set -- -q -fsS --connect-timeout 10 --noproxy '*' --proto '=https' --max-filesize 33554432
- [ "$method" != HEAD ] || set -- "$@" -I
- if truthy "$(uci_get wan_direct 0)"; then
- host="${origin#https://}"; port="${host##*:}"; host="${host%:*}"
- device="$(wan_device)" || return 1
- ip="$(wan_resolve_host "$host")" || return 6
- set -- "$@" --interface "$device" --resolve "$host:$port:$ip"
- fi
- remaining=$((120000 - $(remote_clock_ms) + started))
- [ "$remaining" -gt 0 ] || return 28
- remaining="$(LC_ALL=C awk -v ms="$remaining" 'BEGIN { printf "%.3f", ms/1000 }')"
- rc=0
- curl "$@" --max-time "$remaining" -o "$dst" -w '%{http_code} %{redirect_url}\n' "$url" >"$stats" || rc=$?
- [ "$rc" = 0 ] || return "$rc"
- code=''; redirect=''; read -r code redirect <"$stats" || true
- case "$code" in
- 301|302|303|307|308) rc=47; [ -n "$redirect" ] || return 47; url="$redirect"; hop=$((hop+1)) ;;
- 200) [ -s "$dst" ] || { rc=1; return 1; }; return 0 ;;
- *) rc=22; return 22 ;;
- esac
- done
- return 47
- fi
- # Minimal images without curl keep bounded native HTTPS clients. These do
- # not offer curl's per-host resolver override.
- if truthy "$(uci_get wan_direct 0)"; then log 'Xray: curl отсутствует; загрузчик использует системный DNS'; fi
- rc=1
- case "$url" in https://*) ;; *) return 3 ;; esac
- if command -v uclient-fetch >/dev/null 2>&1; then
- xray_native_fetch "$dst" uclient-fetch -q -T 15 -O "$dst" "$url" && rc=0
- elif command -v wget >/dev/null 2>&1; then
- xray_native_fetch "$dst" wget -q -T 15 -O "$dst" "$url" && rc=0
- fi
- [ "$rc" = 0 ] && [ -s "$dst" ] && [ "$(wc -c <"$dst")" -le 33554432 ]
+# Keep WAN policy for every curl redirect; native fallback uses system DNS.
+download_route() {
+ local host port ip
+ truthy "$(uci_get wan_direct 0)" || return 0
+ host="${1#https://}"; port="${host##*:}"; host="${host%:*}"
+ DL_DEVICE="$(wan_device)" || return 1
+ ip="$(wan_resolve_host "$host")" || return 6
+ DL_RESOLVE="$host:$port:$ip"
+}
+fetch_file() { remote_download "$@"; }
+download_native_notice() {
+ if truthy "$(uci_get wan_direct 0)"; then log 'Download: native fallback uses system DNS; WAN settings unchanged'; fi
+}
+xray_native_fetch() (
+ dst="$1"; shift
+ trap 'result=$?; [ "$result" = 0 ] || rm -f "$dst"' EXIT
+ ulimit -f 32768 || return 23
+ download_run 120 "$@"
+)
+xray_prepare_timed() (
+ now="$(download_clock)"; deadline=$((now + 300))
+ [ -z "${XRAY_PREPARE_DEADLINE:-}" ] || [ "$XRAY_PREPARE_DEADLINE" -ge "$deadline" ] || deadline="$XRAY_PREPARE_DEADLINE"
+ XRAY_PREPARE_DEADLINE="$deadline"
+ export XRAY_PREPARE_DEADLINE
+ remaining=$((deadline - now)); [ "$remaining" -gt 0 ] || return 28
+ rc=0; download_run "$remaining" "$@" || rc=$?
+ [ "$rc" != 28 ] || log 'Xray: preparation timeout (300s); existing Xray and cache preserved'
+ return "$rc"
)
install_package() {
@@ -1781,10 +1903,10 @@ install_package() {
rc=0
if command -v apk >/dev/null 2>&1; then
log "Xray dependency: apk -U add $1"
- apk -U add "$1" >&2 || rc=$?
+ download_run 120 apk -U add "$1" >&2 || rc=$?
elif command -v opkg >/dev/null 2>&1; then
log "Xray dependency: opkg update && opkg install $1"
- opkg update >&2 && opkg install "$1" >&2 || rc=$?
+ download_run 120 opkg update >&2 && download_run 120 opkg install "$1" >&2 || rc=$?
else
log 'Xray: no supported package manager (apk/opkg)'
return 1
@@ -1886,39 +2008,66 @@ xray_package_extract_binary() (
xray_binary_usable() {
[ -x "$1" ] && "$1" version >/dev/null 2>&1 && ! xray_requires_legacy_replacement "$1"
}
-xray_probe_url() {
- # Use the same TLS/WAN/redirect policy as the actual GET.
- if command -v curl >/dev/null 2>&1; then
- fetch_file "$1" "$2" HEAD
- else
- # uclient-fetch has no HEAD mode. A bounded HTTPS GET is the probe
- # and payload together, with its size/digest checked before extraction.
- return 0
- fi
-}
+xray_download_package() (
+ url="$1"; package="$2"; tag="$3"; asset="$4"
+ XRAY_FILE_DEADLINE=$(( $(download_clock) + 120 ))
+ export XRAY_FILE_DEADLINE
+ # No third-party proxy is assumed trusted. Opt-in mirrors serve only
+ # published assets; the caller still verifies the OFFICIAL API digest.
+ mirror="${XRAY_PACKAGE_MIRROR:-$(uci_get xray_package_mirror '')}"
+ if [ -n "$mirror" ]; then
+ case "$mirror" in *[\?\#\@]*|*[!A-Za-z0-9_./:+-]*) log 'Xray: invalid HTTPS mirror configuration'; return 3 ;; esac
+ download_origin "$mirror" >/dev/null || return 3
+ DOWNLOAD_SOURCE_DEADLINE=$(( $(download_clock) + 60 ))
+ fi
+ DOWNLOAD_STAGE=xray-package
+ rc=0; fetch_file "$url" "$package" || rc=$?
+ [ "$rc" != 0 ] || return 0
+ unset DOWNLOAD_SOURCE_DEADLINE
+ if [ -n "$mirror" ]; then
+ log 'Xray: official asset download failed; trying configured HTTPS mirror with official SHA256'
+ DOWNLOAD_STAGE=xray-mirror
+ fetch_file "${mirror%/}/$tag/$asset" "$package" && return 0
+ rc=$?
+ else
+ log 'Xray: HTTPS mirror not configured; no third-party download proxy used'
+ fi
+ return "$rc"
+)
+
install_xray_tmp_locked() (
+ XRAY_PREPARE_DEADLINE="${XRAY_PREPARE_DEADLINE:-$(( $(download_clock) + 300 ))}"
+ export XRAY_PREPARE_DEADLINE
dir="$(xray_runtime_dir)"
mkdir -p "$dir" || return 1
work="$(mktemp -d "$dir/.download.XXXXXX")" || return 1
trap 'rm -rf "$work"' EXIT
trap 'exit 1' INT TERM
- ensure_ca_certificates || { log 'Xray: trusted CA certificates unavailable; existing Xray preserved'; return 1; }
- ensure_fetch_tool || { log 'Xray: need curl, uclient-fetch or wget'; return 1; }
+ ensure_ca_certificates || { log 'Xray: stage=dependencies; trusted CA certificates unavailable; existing Xray preserved'; return 1; }
+ ensure_fetch_tool || { log 'Xray: stage=dependencies; need curl, uclient-fetch or wget'; return 1; }
+ command -v jsonfilter >/dev/null 2>&1 || install_package jsonfilter || { log 'Xray: stage=dependencies; jsonfilter unavailable'; return 1; }
rc=1
page=1
while [ "$page" -le 10 ]; do
- xray_discover_releases "$work/candidates" "$work" "$page" || return 1
+ [ "$(download_clock)" -lt "$XRAY_PREPARE_DEADLINE" ] || return 28
+ xray_discover_releases "$work/candidates" "$work" "$page" || return $?
while IFS='|' read -r tag asset url digest bytes; do
# Keep the published name for native package-manager diagnostics.
rm -f "$work/xray.new" "${package:-$work/unused}"
package="$work/$asset"
- log "Xray: candidate: $asset; checking download URL..."
- xray_probe_url "$url" "$work/headers" || { rc=$?; log "Xray: URL unavailable (rc=$rc); candidate skipped"; continue; }
- log "Xray: загрузка пакета yichya/openwrt-xray/$asset; общий тайм-аут=120s"
- fetch_file "$url" "$package" || { rc=$?; log "ERROR: GitHub download unavailable (rc=$rc); existing Xray preserved"; continue; }
- [ "$(wc -c <"$package")" = "$bytes" ] || { log 'Xray: package length mismatch'; rc=1; continue; }
+ log "Xray: candidate: $asset; downloading verified GET (file <=120s, preparation <=300s)"
+ DOWNLOAD_RESULT_FILE="$work/download-result"
+ xray_download_package "$url" "$package" "$tag" "$asset" || {
+ rc=$?; http=''; reason=''; ignored=''
+ [ ! -s "$DOWNLOAD_RESULT_FILE" ] || read -r ignored reason http <"$DOWNLOAD_RESULT_FILE"
+ log "ERROR: published Xray package found but download failed (rc=$rc; reason=${reason:-network}; http=${http:-unknown}); existing Xray preserved"
+ # Only a confirmed missing asset may select another candidate.
+ # DNS/TLS/timeout/403 must not trigger a storm of old downloads.
+ case "$http" in 404|410) continue ;; *) return "$rc" ;; esac
+ }
+ [ "$(wc -c <"$package")" = "$bytes" ] || { log 'Xray: stage=verify; reason=size; package length mismatch'; rc=1; continue; }
log 'Xray: verifying package checksum...'
- [ "$(xray_digest "$package")" = "$digest" ] || { log 'Xray: package SHA256 mismatch; existing Xray preserved'; rc=1; continue; }
+ [ "$(xray_digest "$package")" = "$digest" ] || { log 'Xray: stage=verify; reason=SHA256; package SHA256 mismatch; existing Xray preserved'; rc=1; continue; }
xray_check_package_metadata "$package" "$work" "$asset" || { rc=$?; continue; }
xray_package_extract_binary "$package" "$work/xray.new" "$asset" || { rc=$?; log "Xray: extraction failed for $asset (rc=$rc)"; continue; }
[ -s "$work/xray.new" ] && [ "$(wc -c <"$work/xray.new")" -le 67108864 ] || { rc=1; continue; }
@@ -1991,10 +2140,10 @@ prepare_xray_tmp() (
if xray_binary_usable "$configured"; then return 0; fi
xray_cache_restore && return 0
log 'Xray: загрузочной копии нет; требуется загрузка из сети'
- install_xray_tmp_locked
+ xray_prepare_timed install_xray_tmp_locked
)
prepare_xray() (
- ensure_xray_available || return 1
+ ensure_xray_available || return $?
bin="$(xray_bin_path)"
case "$bin" in
/tmp/*|"$(xray_runtime_dir)"/*)
@@ -2095,10 +2244,10 @@ case "$cmd" in
heartbeat_diagnostics
;;
install-xray-tmp)
- install_xray_tmp
+ xray_prepare_timed install_xray_tmp
;;
prepare-xray)
- prepare_xray
+ xray_prepare_timed prepare_xray
;;
xray-package-diagnostics)
xray_package_diagnostics
@@ -2112,6 +2261,12 @@ case "$cmd" in
xray-control-execute)
xray_control_execute "$@"
;;
+ tachyon-status)
+ tachyon_json force
+ ;;
+ tachyon-reconfigure)
+ tachyon_reconfigure
+ ;;
render-client)
xray_apply_trace render-client
render_client_config "$@" || exit $?
diff --git a/files/www/cgi-bin/owrt-remote b/files/www/cgi-bin/owrt-remote
index 22ee3d6..15d6826 100644
--- a/files/www/cgi-bin/owrt-remote
+++ b/files/www/cgi-bin/owrt-remote
@@ -3,7 +3,7 @@
KEY_FILE="${KEY_FILE:-/etc/owrt-remote/web.key}"
AGENT="${AGENT:-/usr/sbin/owrt-remote}"
LOG_HELPER="${OWRT_REMOTE_LOG_HELPER:-/usr/lib/owrt-remote/logs.sh}"
-OWRT_REMOTE_UI_VERSION="2026-07-02-mobile-terminal-batch-v25"
+OWRT_REMOTE_UI_VERSION="2026-11-21-v122"
PARAMS_FILE="${TMPDIR:-/tmp}/owrt-remote-cgi.$$"
RESULT_TITLE=""
RESULT_BODY=""
@@ -515,7 +515,7 @@ render_page() {
-OpenWrt Remote Hub v121
+OpenWrt Remote Hub v122
