# Tachyon в карточке роутера Интеграция включена в Remote Hub v122. Обновить нужно Hub на VPS и агент на роутере; Tachyon устанавливается отдельно и автоматически не загружается. ## Исправление APK 3.0.5 в пакетах 122-r2 На node-12 с OpenWrt 25.12.5 команда `apk info -v tachyon` вернула описание, а не версию. Прежний парсер ожидал `tachyon-VERSION`, получил пустую строку и выбрал старую LuCI-страницу вместо самостоятельной панели на порту 1680. Поэтому в карточке исчезла версия, а кнопка открывала LuCI с внешней ссылкой. Теперь версия читается через `apk list --installed --manifest`, с резервным структурированным `apk query`. Наличие самостоятельного интерфейса подтверждает локальный read-only API `/api/agent/v1/health`; старый номер пакета не мешает обнаружить работающий современный интерфейс. HTTP 403 страницы LuCI сам по себе не означает, что неизвестный Tachyon работает. Версия работающего приложения по-прежнему берётся из его OpenAPI, если он доступен. Блок карточки имеет две строки: название/версия/состояние и ниже кнопка. Отсутствие версии больше не переносит кнопку в верхнюю строку и не меняет высоту обычного блока. Проверены ПК, мобильная вертикальная и горизонтальная ориентация. Установить исправление интерфейса VPS из локальных исходников: ```powershell $Fix = Join-Path $env:USERPROFILE 'Documents\openwrt overlay\vps\deploy-tachyon-detection-fix.ps1' powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -Action Install ``` Установить агент на удалённый node-12 через существующий SSH-туннель VPS: ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -RouterId node-12 -Action Install ``` SSH отдельно запрашивает пароль VPS и пароль выбранного роутера; они могут отличаться. Скрипт читает `ssh_entry_port` выбранного роутера из базы в режиме read-only и подключается через ProxyJump. Туннель не публикуется наружу. Перезапуск выполняет отдельный procd worker после завершения записи файлов, чтобы не оборвать установку вместе с SSH. После него VPS ждёт свежий Heartbeat и проверяет настоящий Tachyon API через обратный маршрут выбранного роутера. При отсутствии подтверждения выводится ошибка, успех не подставляется. Проверить node-12 отдельно, без переустановки и без изменения файлов: ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -RouterId node-12 -Action Status ``` Ожидается `TACHYON_CHECK_OK: node-12`. Команда показывает версию, режим, порт, состояние Xray, возраст Heartbeat и результат запроса к API через туннель. Страница LuCI вместо JSON Tachyon не считается успешной проверкой. Для обычного локального SSH: ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Router root@192.168.2.1 -Action Install ``` Отдельная резервная копия на каждом устройстве: `/root/owrt-remote-backup-before-tachyon-detection-v122`. Откат удалённого роутера и затем VPS: ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -RouterId node-12 -Action Rollback powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Vps root@132.243.19.232 -Action Rollback ``` В рамках исправления не меняются настройки и пакет самого Tachyon. Исправленные пакеты выпускаются с тегом v122-r2. Прежние IPK/APK 122-r1 и тег v122 сохраняются. ## Обнаружение Агент проверяет установленные пакеты 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.