Files
luci-app-owrt-remote/tests/ROUTER_UPDATES.md
T

66 lines
6.0 KiB
Markdown

# Обновление всех роутеров из Hub, v117
В меню владельца «Доступ к Hub» добавлен блок «Обновить все роутеры разом».
Ссылка «Открыть терминал обновления» открывает отдельную вкладку. В ней задаются
команда установки и один общий SSH-пароль root. При SSH-ключе поле можно оставить
пустым. Команда по умолчанию использует `RAW_REPO_BASE` именно этого Hub:
GitHub — GitHub, GitVerse — GitVerse.
Hub запускает одну очередь, по одному роутеру. Имена берутся из Heartbeat
(`owrtremote.main.router_name`) и уточняются чтением UCI по SSH перед установкой.
Неуспешное подключение, ошибка команды и отсутствие подтверждения различаются.
Если SSH отклонил общий пароль, у этого роутера выводится понятная ошибка
авторизации: его пароль может отличаться от общего. Обновление на нём не
запускается, очередь переходит к следующему. Запрет входа по паролю, отсутствие
SSH-ключа и сетевые ошибки отображаются отдельно; сам пароль не показывается.
Надпись «Успешно — Советская 30» появляется только при полученном `rc=0`.
Код 0 подтверждает выполнение команды, а не проверку всех функций роутера.
Установка запускается отдельным процессом с `setsid` на роутере, не в shell VPS.
При разрыве SSH во время установки Hub запрашивает результат по тому же ID,
не повторяя команду. При невозможности получить итог останавливаются оставшиеся
обновления, чтобы не запускать другую установку параллельно с неподтверждённой.
«Остановить очередь после текущего» не прерывает уже начатую установку.
Временный каталог задачи расположен в `/tmp/owrt-remote-update-ID` на роутере;
вывод ограничен примерно 32 КиБ, на VPS передаётся хвост до 8 КиБ. После получения
результата каталог удаляется. При потере связи остаётся ограниченный результат
до следующей перезагрузки; нет постоянно работающего сборщика этой задачи.
Новый API доступен только владельцу, POST защищён токеном и проверкой Origin.
SSH-пароль хранится только в памяти текущего worker, не в БД/журнале/URL/browser
storage. Из вывода удаляются пароль и строки с известными форматами секретов.
Закрытие вкладки не отменяет очередь. После открытия показывается текущее
состояние; результаты находятся в памяти VPS до двух часов после завершения.
Перезапуск Hub прерывает очередь, но уже запущенный installer на роутере
продолжает работу. После перезапуска Hub его итог нужно проверять отдельно.
Роутеры с неработающим обратным SSH-туннелем обновить этим способом нельзя.
Перед запуском списка устройств нет новых требований к их текущему клиенту.
## Установка локальной версии на VPS из Windows PowerShell
```powershell
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 Install
```
Откат Hub (уже установленные на роутеры версии не откатываются этой командой):
```powershell
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`.
Не устанавливай/не откатывай Hub, пока его очередь работает.
## Проверки
`python -m unittest discover -s tests -p test_router_updates.py -v` проверяет
последовательность, код результата, пароль, отказы подключения, обрыв после
запуска, остановку очереди, повторный запрос, права/CSRF и ограниченный shell
вывод. Реальный task исполняется в MSYS; там адаптирован только отсутствующий
`setsid`. Синтаксис проверяется также BusyBox ash. Настоящий Linux `setsid`,
Dropbear и обновление физического OpenWrt требуют проверки пользователем.
`node tests/test_router_updates_ui.cjs` проверяет desktop/mobile, ввод команды,
очистку пароля, итоги, сохранение раскрытого вывода и возобновление просмотра.