Fix router update queue controls, compatibility and dashboard
This commit is contained in:
1 parent
e9aa14e080
commit
2a47adb32a
6 files changed
+861
-112
No files matched your search
+54
-8
@@ -5,33 +5,76 @@
|
||||
команда установки и один общий SSH-пароль root. При SSH-ключе поле можно оставить
|
||||
пустым. Команда по умолчанию использует `RAW_REPO_BASE` именно этого Hub:
|
||||
GitHub — GitHub, GitVerse — GitVerse.
|
||||
Можно вставить полную shell-команду или прямую HTTP/HTTPS-ссылку на установочный
|
||||
shell-скрипт с любого источника. Ссылка передаётся загрузчику как данные, включая
|
||||
параметры запроса; скрипт сначала целиком скачивается, затем запускается.
|
||||
|
||||
Hub запускает одну очередь, по одному роутеру. Имена берутся из Heartbeat
|
||||
(`owrtremote.main.router_name`) и уточняются чтением UCI по SSH перед установкой.
|
||||
(`owrtremote.main.router_name`) и уточняются чтением UCI по SSH до подготовки
|
||||
установки. Например, `router_id=node-5`, `router_name=АНТОН ВПН` показываются как
|
||||
«АНТОН ВПН» и отдельно «ID: node-5». Имя UCI имеет приоритет над именем,
|
||||
изменённым карандашом в Hub. Если UCI и Heartbeat не сообщили имя, используется
|
||||
имя из редактора Hub; если нет и его — «Имя роутера не получено», без подмены ID.
|
||||
Неуспешное подключение, ошибка команды и отсутствие подтверждения различаются.
|
||||
Если SSH отклонил общий пароль, у этого роутера выводится понятная ошибка
|
||||
авторизации: его пароль может отличаться от общего. Обновление на нём не
|
||||
запускается, очередь переходит к следующему. Запрет входа по паролю, отсутствие
|
||||
SSH-ключа и сетевые ошибки отображаются отдельно; сам пароль не показывается.
|
||||
`Connection timed out during banner exchange` означает, что SSH-приветствие
|
||||
не поступило вовремя: до проверки пароля и отправки обновления дело не дошло.
|
||||
По одной этой ошибке нельзя различить отказ обратного туннеля и SSH-сервера.
|
||||
Панель показывает понятное объяснение и сохраняет технический ответ.
|
||||
Надпись «Успешно — Советская 30» появляется только при полученном `rc=0`.
|
||||
Код 0 подтверждает выполнение команды, а не проверку всех функций роутера.
|
||||
|
||||
Установка запускается отдельным процессом с `setsid` на роутере, не в shell VPS.
|
||||
Перед запуском проверяются необходимые утилиты. Передача команды, имени и
|
||||
ограниченного вывода не требует `base64`: команда записывается встроенным
|
||||
`printf`, имя читается через UCI, вывод передаётся отдельным завершающим полем.
|
||||
Строки установщика не могут подменить метаданные результата. Подтверждённая
|
||||
ошибка подготовки отображается как «Ошибка» с причиной и текстом «Команда
|
||||
обновления не запускалась»; неопределённость показывается при реальной потере
|
||||
связи после отправки задачи.
|
||||
При разрыве SSH во время установки Hub запрашивает результат по тому же ID,
|
||||
не повторяя команду. При невозможности получить итог останавливаются оставшиеся
|
||||
обновления, чтобы не запускать другую установку параллельно с неподтверждённой.
|
||||
«Остановить очередь после текущего» не прерывает уже начатую установку.
|
||||
не повторяя команду. Ожидание ограничено: запуск — 15 секунд, потеря связи SSH —
|
||||
30 секунд, отсутствие нового вывода — 90 секунд, работа установщика — 180 секунд.
|
||||
На роутере также действует собственный лимит 180 секунд, даже если VPS недоступна.
|
||||
В карточке видны прошедшее время, пауза вывода, результат и причина ошибки.
|
||||
Неудача одного роутера не останавливает очередь остальных. Если остановку нельзя
|
||||
доставить из-за потери SSH, показывается «Не подтверждено», а не ложный успех.
|
||||
|
||||
«Остановить всё» сразу помечает оставшиеся устройства пропущенными, прерывает
|
||||
текущий запрос SSH и отправляет текущей задаче остановку. На доступном роутере
|
||||
установщик с дочерними процессами получает TERM, затем KILL при необходимости.
|
||||
Это не откатывает изменения, уже внесённые установщиком. При отсутствии SSH
|
||||
остановку невозможно подтвердить: действует локальный лимит задачи, очередь
|
||||
показывает фактическую потерю связи. При недоступной сети продолжение следующих
|
||||
роутеров может пересекаться с ещё не завершившейся задачей на отключённом роутере.
|
||||
|
||||
Временный каталог задачи расположен в `/tmp/owrt-remote-update-ID` на роутере;
|
||||
вывод ограничен примерно 32 КиБ, на VPS передаётся хвост до 8 КиБ. После получения
|
||||
результата каталог удаляется. При потере связи остаётся ограниченный результат
|
||||
до следующей перезагрузки; нет постоянно работающего сборщика этой задачи.
|
||||
У отменённой задачи после очистки остаётся только пустой маркер в RAM до
|
||||
перезагрузки: он запрещает поздний запуск уже отменённого запроса из сети.
|
||||
Новый API доступен только владельцу, POST защищён токеном и проверкой Origin.
|
||||
SSH-пароль хранится только в памяти текущего worker, не в БД/журнале/URL/browser
|
||||
storage. Из вывода удаляются пароль и строки с известными форматами секретов.
|
||||
|
||||
Закрытие вкладки не отменяет очередь. После открытия показывается текущее
|
||||
состояние; результаты находятся в памяти VPS до двух часов после завершения.
|
||||
Сводка очереди оформлена карточками: всего, обновляются, ожидают, успешно,
|
||||
ошибки, не подтверждено, остановлено и пропущено. Полоса прогресса считает
|
||||
обработанные устройства всех итоговых категорий; 100% не означает успех всех.
|
||||
Рядом с «Вернуться в Hub» есть «Обновить список роутеров»: после завершения
|
||||
очереди кнопка убирает её результаты и получает текущий список, имена и статусы.
|
||||
Во время работающей очереди она только обновляет статусы, не удаляя задачу.
|
||||
Обновление списка не запускает установку и не меняет введённую команду.
|
||||
В карточках отдельно показаны текущий Heartbeat, онлайн/офлайн и последний
|
||||
сообщённый статус Xray. Они обновляются каждые три секунды и не подменяют
|
||||
прошлый итог установки. Если Heartbeat устарел, старое состояние Xray явно
|
||||
помечается как последнее сообщение. Сброс завершённой очереди защищён CSRF и ID:
|
||||
запрос из старой вкладки не удалит более новую очередь.
|
||||
Перезапуск Hub прерывает очередь, но уже запущенный installer на роутере
|
||||
продолжает работу. После перезапуска Hub его итог нужно проверять отдельно.
|
||||
Роутеры с неработающим обратным SSH-туннелем обновить этим способом нельзя.
|
||||
@@ -49,7 +92,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-router-updates.ps1" -Vps "root@193.233.82.38" -Action Rollback
|
||||
```
|
||||
|
||||
Резервная копия: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-router-updates-v117`.
|
||||
Резервная копия: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-router-updates-control-v117`.
|
||||
Не устанавливай/не откатывай Hub, пока его очередь работает.
|
||||
|
||||
## Проверки
|
||||
@@ -57,9 +100,12 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
|
||||
`python -m unittest discover -s tests -p test_router_updates.py -v` проверяет
|
||||
последовательность, код результата, пароль, отказы подключения, обрыв после
|
||||
запуска, остановку очереди, повторный запрос, права/CSRF и ограниченный shell
|
||||
вывод. Реальный task исполняется в MSYS; там адаптирован только отсутствующий
|
||||
`setsid`. Синтаксис проверяется также BusyBox ash. Настоящий Linux `setsid`,
|
||||
вывод. Реальный task исполняется в MSYS; отсутствующий `setsid` заменён Perl
|
||||
обёрткой над его POSIX-вызовом. Проверяются остановка группы, локальный тайм-аут
|
||||
и получение короткого вывода до завершения установки. Синтаксис проверяется
|
||||
также BusyBox ash. Настоящий Linux `setsid`,
|
||||
Dropbear и обновление физического OpenWrt требуют проверки пользователем.
|
||||
|
||||
`node tests/test_router_updates_ui.cjs` проверяет desktop/mobile, ввод команды,
|
||||
очистку пароля, итоги, сохранение раскрытого вывода и возобновление просмотра.
|
||||
очистку пароля, итоги, дашборд из 35 устройств, обновление списка и живых статусов,
|
||||
сохранение раскрытого вывода и возобновление просмотра.
|
||||
Reference in new issue
Block a user