18 KiB
Обновление панели из Hub (v121)
Перед «Поиск роутеров» владелец видит кнопку «Проверить обновление панели». Обе кнопки оформлены как остальные элементы шапки и стоят рядом на ПК. На мобильных устройствах каждая занимает отдельную строку. Подтверждённая актуальная сборка обозначается зелёной кнопкой «Обновление не требуется», без отдельного информационного блока на ПК и мобильном. Кнопка по-прежнему позволяет повторно проверить обновление. Доступное обновление обозначается жёлтым. Проверка и ошибка проверки остаются нейтральными. Сообщение проверки размещено первым блоком панели над шапкой, выровнено по центру и отделено от элементов управления отступом. Во всех состояниях текст блока белый, рамка полупрозрачная, как у «Открыть группы роутеров», фон прозрачный. Ширина ограничена 680 пикселями, на ПК сверху добавлен отступ 12 пикселей. На мобильном длинный текст переносится без обрезки. Элементы шапки идут последовательно: ЦП / ОЗУ / ДИСК, обновление панели, эффекты, поиск роутеров. Кнопки занимают отдельные строки одинаковой ширины, включая горизонтальную ориентацию. Мобильная кнопка «Поиск роутеров» имеет такую же фиолетовую заливку и белый текст, как «Эффекты», в том числе при открытом поиске. Между мобильными кнопками обновления, эффектов, поиска, меню Hub, добавления, групп и статистики используется единый интервал 8 пикселей. Раскрытые блоки отделены тем же интервалом; скрытые элементы не оставляют пустых промежутков.
Для локальной установки изменения кнопки и скрытия блока актуальной версии:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-update-status-ui.ps1" -Vps "root@193.233.82.38" -Action Install
Скрипт сохраняет отдельную резервную копию owrt-remote-hub.py.bak-before-update-status-ui-v121.
Для отката выполнить ту же команду с -Action Rollback. После установки или отката
обновить страницу через Ctrl+F5.
Успех подтверждается только при совпадении SHA-256 загруженного файла и сборки,
которая отвечает на /health?panel-update=1. Ответа {"ok":true} недостаточно.
До публикации локальный файл отличается от репозитория: кнопка может предложить
опубликованную сборку и при подтверждении заменить ею локальный фикс.
Чтобы проверить именно зелёную кнопку «Обновление не требуется» без публикации,
выполнить test-hub-self-update.ps1 -Action Retest, подтвердить обновление с источником
«Локальный тест на VPS (без GitHub)» и дождаться перезагрузки страницы. Обе тестовые
сборки содержат текущий локальный интерфейс; отдельного блока актуальности после
перезагрузки быть не должно. Команды подготовки и возврата приведены ниже.
При открытии панели запускается общая фоновая проверка исходного файла Hub. Проверки кешируются на 5 минут; открытые видимые вкладки опрашивают результат раз в минуту. Нажатие кнопки позволяет запросить проверку раньше, с ограничением не чаще одного сетевого запроса за 15 секунд. Во время установки статус запрашивается раз в 2 секунды. Скрытые вкладки приостанавливают опрос.
Сравниваются номер версии и SHA-256 файла: более старая опубликованная версия
не предлагается и не может быть установлена через кнопку/API. Это сохраняет
локальную v121, пока в источнике опубликована предыдущая версия. Кнопка остаётся
зелёной с подписью «Обновление не требуется», отдельного баннера актуальности нет.
Подсказка кнопки показывает номера установленной и более старой опубликованной
версии. Ограничение проверяется и перед запуском задачи, и в процессе установки
до замены файла. Явный откат из PowerShell сохраняет своё прежнее поведение.
Внутри одной версии по-прежнему сравнивается SHA-256: исправления обнаруживаются
и при неизменной версии v121. Установка требует подтверждения конкретной сборки.
Ветка GitHub использует свой RAW_REPO_BASE; при переносе в GitVerse необходимо
сохранить его собственный RAW_REPO_BASE. Адрес не принимается от браузера.
Обновляется только файл VPS-панели. Процесс запускается отдельной transient-службой
systemd, сохраняет резервную копию, проверяет размер, UTF-8, синтаксис Python
и совместимость обновления, затем атомарно заменяет файл. Проверка /health
подтверждает именно SHA-256 новой запущенной сборки. При ошибке после замены
возвращается предыдущий файл и повторно запускается Hub. Результат сохраняется
в STATE_DIR/panel-update/job.json; предыдущий файл — previous.py рядом.
После успеха страница автоматически перезагружается один раз.
После перезагрузки сообщение завершённой задачи больше не обещает повторную
перезагрузку: при подтверждённой актуальности остаётся только зелёная кнопка
«Обновление не требуется». Следующие проверки и доступные новые сборки
показывают текущее состояние, даже если сохранена предыдущая успешная задача.
Очередь, состояние и резервная копия ограничены одним обновлением. Блокировка flock не позволяет запустить две установки; при аварии её освобождает ядро. Зависшая или прерванная задача получает явный неподтверждённый результат. API доступен только владельцу, POST требует CSRF-токен и проверку Origin.
Подтверждение установки открывается встроенным адаптивным баннером панели с версией, контрольной суммой, источником и кнопками «Отмена» и «Обновить». На мобильном он занимает ширину экрана с безопасными полями, не вызывает системное белое окно браузера и не допускает горизонтального переполнения.
До публикации этой функции публичный старый Hub может не поддерживать проверку сборки после перезапуска. Такая сборка отклоняется до замены файла. Сообщение «Сборка в источнике ещё не поддерживает проверяемое обновление из панели» означает отсутствие механизма обновления в загруженном файле, а не отсутствие новых изменений. При такой ошибке кнопка остаётся нейтральной: актуальность установленной сборки не подтверждена.
Проверка через кнопку без публикации
Скрипт ниже подготавливает на VPS две временные сборки из текущего локального
исходника v121. Различается только тестовая отметка, поэтому их SHA-256 разные.
Первая сборка устанавливается скриптом, вторая предлагается кнопкой обновления.
Только эти временные сборки читают файл-кандидат на самой VPS вместо GitHub.
Ссылки установки и RAW_REPO_BASE остаются прежними. Данные обычной очереди
обновления и её резервная копия сохраняются: тест использует отдельный каталог.
Подготовить тест из Windows 11 PowerShell:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\test-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Prepare
Для повторного теста вместо двух отдельных команд Restore и Prepare
используется одна команда. Она возвращает прежний файл, если тест уже был
подготовлен, затем устанавливает новые тестовые сборки. При ошибке возврата
второй шаг не выполняется; исходная резервная копия не перезаписывается.
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\test-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Retest
После SELF_UPDATE_LOCAL_TEST_READY:
- Открыть панель владельцем, нажать Ctrl+F5 и дождаться жёлтой кнопки «Обновление панели».
- Нажать кнопку и подтвердить установку. Источник в подтверждении — «Локальный тест на VPS (без GitHub)».
- Дождаться результата и автоматической перезагрузки страницы. При успехе кнопка станет зелёной.
Это настоящая замена файла Hub и перезапуск owrt-remote через systemd.
Сервис кратковременно перезапускается; скачивание с GitHub этим тестом
не проверяется. Подготовка также перезапускает Hub. При неудаче подготовки
скрипт возвращает исходный файл и проверяет работоспособность.
Проверить установленный файл, результат задачи, активность службы и SHA-256
запущенной через /health сборки:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\test-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Status
Успешный итог — SELF_UPDATE_LOCAL_TEST_PASSED.
SELF_UPDATE_LOCAL_TEST_WAITING означает, что успех ещё не подтверждён;
следом выводятся статус задачи и результаты проверки.
SELF_UPDATE_LOCAL_TEST_NOT_PREPARED означает, что каталог теста отсутствует.
Диагностика показывает installed_build (baseline, candidate или other),
контрольные суммы установленного и реально запущенного файла, а также
running_installed_file. Она не меняет VPS и не показывает ключи. Если сборка
теста реально запущена, но браузер сообщает об ошибке проверки GitHub, нужно
сверить VPS, на которую указывает открытый домен, и полный результат подготовки.
После проверки вернуть файл, который работал до подготовки теста:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\test-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Restore
Ожидается SELF_UPDATE_LOCAL_TEST_RESTORED. Скрипт проверяет резервную копию
/opt/owrt-remote/self-update-local-test/before.py, возвращает её, перезапускает
Hub, проверяет /health, затем удаляет только созданные файлы теста.
Повторная подготовка не перезаписывает существующую резервную копию: сначала
нужно завершить тест и выполнить Restore либо использовать Retest.
После восстановления обычная
проверка снова использует GitHub; до публикации совместимой сборки исходное
сообщение о неподдерживаемом обновлении ожидаемо появится снова.
Локальная установка с Windows 11
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Install
После HUB_SELF_UPDATE_V121_Install_OK обновить страницу через Ctrl+F5.
Откат локальной установки:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Rollback
Используется резервная копия
/opt/owrt-remote/owrt-remote-hub.py.bak-before-hub-self-update-v121.
Проверки
python tests/test_hub_update.py -v
python tests/test_hub_self_update_local.py -v
python tests/test_update_status_ui_deploy.py -v
node tests/test_hub_update_ui.cjs
Python проверяет загрузку из правильного источника, ошибки сети и синтаксиса,
неизменную версию, отказ от понижения версии при проверке/API/установке,
переход на более новую версию, проверку контрольной суммы, сохранение рабочего файла,
установку и откат, восстановление состояния после перезапуска и права API.
Перезапуск systemd и ответы health в этих тестах моделируются.
Отдельный тест локального сценария проверяет реальные файлы и HTTP /health
до и после повторного запуска сервера с новым исходником, успешное обновление,
возврат исходного файла, сохранение обычного состояния обновления и подготовку
UTF-8 файлов из Windows PowerShell. Команды systemd в автоматическом тесте
моделируются; их выполнение на VPS проверяется ручным сценарием выше.
Тест установки интерфейса использует HTTP /health и проверяет отказ при
ответе другой запущенной сборки или при отсутствии контрольной суммы,
сохранение резервной копии и автоматический возврат предыдущего файла.
Браузер проверяет размеры 1280, 980, 320, 390, 430, 844 и 932 пикселя,
положение статуса над шапкой, перенос текста, размеры мобильных кнопок,
подтверждение/отмену,
разрыв связи при перезапуске, результат и отсутствие повторной установки
или цикла перезагрузок страницы. Сам VPS этими тестами не изменяется.