Publish v119 update safeguards and yichya Xray bootstrap fixes

This commit is contained in:
kzolotarev95 committed 2026-10-27 22:07:15 +04:00
1 parent 730b54c939
commit 5956daa8c2
73 files changed
+980 -306

No files matched your search

+46 -13
View File
@@ -1,10 +1,12 @@
# Обновление панели из Hub (v118)
# Обновление панели из Hub (v119)
Перед «Поиск роутеров» владелец видит кнопку «Обновление панели».
Перед «Поиск роутеров» владелец видит кнопку «Проверить обновление панели».
Обе кнопки оформлены как остальные элементы шапки и стоят рядом на ПК.
На мобильных устройствах каждая занимает отдельную строку.
Подтверждённая актуальная сборка обозначается зелёным, доступное обновление —
жёлтым. Проверка и ошибка проверки остаются нейтральными. Сообщение проверки
Подтверждённая актуальная сборка обозначается зелёной кнопкой «Обновление не требуется»,
без отдельного информационного блока на ПК и мобильном. Кнопка по-прежнему позволяет
повторно проверить обновление. Доступное обновление обозначается жёлтым.
Проверка и ошибка проверки остаются нейтральными. Сообщение проверки
размещено первым блоком панели над шапкой, выровнено по центру и отделено
от элементов управления отступом. Во всех состояниях текст блока белый,
рамка полупрозрачная, как у «Открыть группы роутеров», фон прозрачный. Ширина ограничена
@@ -18,15 +20,41 @@
групп и статистики используется единый интервал 8 пикселей. Раскрытые блоки
отделены тем же интервалом; скрытые элементы не оставляют пустых промежутков.
Для локальной установки изменения кнопки и скрытия блока актуальной версии:
```powershell
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-v119`.
Для отката выполнить ту же команду с `-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 файла, поэтому изменения обнаруживаются и при неизменной
версии v118. «Доступно обновление» означает, что опубликованный файл отличается
от запущенного. Установка требует подтверждения конкретной проверенной сборки.
Сравниваются номер версии и SHA-256 файла: более старая опубликованная версия
не предлагается и не может быть установлена через кнопку/API. Это сохраняет
локальную v119, пока в источнике опубликована предыдущая версия. Кнопка остаётся
зелёной с подписью «Обновление не требуется», отдельного баннера актуальности нет.
Подсказка кнопки показывает номера установленной и более старой опубликованной
версии. Ограничение проверяется и перед запуском задачи, и в процессе установки
до замены файла. Явный откат из PowerShell сохраняет своё прежнее поведение.
Внутри одной версии по-прежнему сравнивается SHA-256: исправления обнаруживаются
и при неизменной версии v119. Установка требует подтверждения конкретной сборки.
Ветка GitHub использует свой `RAW_REPO_BASE`; при переносе в GitVerse необходимо
сохранить его собственный `RAW_REPO_BASE`. Адрес не принимается от браузера.
@@ -38,8 +66,8 @@ systemd, сохраняет резервную копию, проверяет р
в `STATE_DIR/panel-update/job.json`; предыдущий файл — `previous.py` рядом.
После успеха страница автоматически перезагружается один раз.
После перезагрузки сообщение завершённой задачи больше не обещает повторную
перезагрузку: при подтверждённой актуальности выводится «У вас последняя версия
панели, обновление не требуется». Следующие проверки и доступные новые сборки
перезагрузку: при подтверждённой актуальности остаётся только зелёная кнопка
«Обновление не требуется». Следующие проверки и доступные новые сборки
показывают текущее состояние, даже если сохранена предыдущая успешная задача.
Очередь, состояние и резервная копия ограничены одним обновлением. Блокировка
@@ -62,7 +90,7 @@ API доступен только владельцу, POST требует CSRF-
## Проверка через кнопку без публикации
Скрипт ниже подготавливает на VPS две временные сборки из текущего локального
исходника v118. Различается только тестовая отметка, поэтому их SHA-256 разные.
исходника v119. Различается только тестовая отметка, поэтому их SHA-256 разные.
Первая сборка устанавливается скриптом, вторая предлагается кнопкой обновления.
Только эти временные сборки читают файл-кандидат на самой VPS вместо GitHub.
Ссылки установки и `RAW_REPO_BASE` остаются прежними. Данные обычной очереди
@@ -135,7 +163,7 @@ Hub, проверяет `/health`, затем удаляет только соз
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_V118_Install_OK` обновить страницу через Ctrl+F5.
После `HUB_SELF_UPDATE_V119_Install_OK` обновить страницу через Ctrl+F5.
Откат локальной установки:
@@ -144,18 +172,20 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
```
Используется резервная копия
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-hub-self-update-v118`.
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-hub-self-update-v119`.
## Проверки
```powershell
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`
@@ -163,6 +193,9 @@ Python проверяет загрузку из правильного исто
возврат исходного файла, сохранение обычного состояния обновления и подготовку
UTF-8 файлов из Windows PowerShell. Команды systemd в автоматическом тесте
моделируются; их выполнение на VPS проверяется ручным сценарием выше.
Тест установки интерфейса использует HTTP `/health` и проверяет отказ при
ответе другой запущенной сборки или при отсутствии контрольной суммы,
сохранение резервной копии и автоматический возврат предыдущего файла.
Браузер проверяет размеры 1280, 980, 320, 390, 430, 844 и 932 пикселя,
положение статуса над шапкой, перенос текста, размеры мобильных кнопок,
подтверждение/отмену,