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

+241
View File
@@ -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.