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

19 KiB
Raw Blame History

Обновление всех роутеров из Hub, v120

В меню владельца «Доступ к Hub» добавлен блок «Обновить все роутеры разом». Ссылка «Открыть терминал обновления» открывает отдельную вкладку. В ней задаются команда установки и один общий SSH-пароль root. При SSH-ключе поле можно оставить пустым. Команда по умолчанию использует RAW_REPO_BASE именно этого Hub: GitHub — GitHub, GitVerse — GitVerse. Можно вставить полную shell-команду или прямую HTTP/HTTPS-ссылку на установочный shell-скрипт с любого источника. Ссылка передаётся загрузчику как данные, включая параметры запроса; скрипт сначала целиком скачивается, затем запускается.

Hub запускает одну очередь, по одному роутеру. Имя, заданное карандашом в Hub, имеет приоритет в списке, текущей очереди и её результатах. Переименование отображается в уже открытой вкладке при следующем опросе, примерно через 3 секунды. Если имя в Hub не задано, оно берётся из Heartbeat (owrtremote.main.router_name) и уточняется чтением UCI по SSH до подготовки установки. Например, router_id=node-5, router_name=АНТОН ВПН показываются как «АНТОН ВПН» и отдельно «ID: node-5». Если имя нигде не получено, выводится «Имя роутера не получено», без подмены ID. Переименование в Hub не меняет UCI. Неуспешное подключение, ошибка команды и отсутствие подтверждения различаются. Если 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, отдельный ID, точная причина и раскрываемый вывод команды, если он получен. Нажатие на соответствующую карточку статистики оставляет только её категорию; «Показать все категории» возвращает общий список проблем. Нулевой счётчик открывает понятное сообщение об отсутствии устройств в категории. Список и счётчики обновляются вместе каждые три секунды, выбранная категория, прокрутка и раскрытый вывод сохраняются. В новой очереди снова показываются все проблемные результаты. Дополнительные запросы к роутерам или повторная установка для просмотра списка не выполняются. Мобильная вкладка терминала обновления адаптируется к ширине от 320 пикселей: кнопки идут одной колонкой, карточки статистики — двумя, поля ввода имеют шрифт 16 px, длинные имена, ID, команды и причины переносятся в своих блоках. Списки и вывод команды ограничены по высоте; предусмотрены отступы safe area. На ПК сохраняется прежняя центрированная колонка шириной до 1100 px: ограничения для длинного текста не растягивают её на весь экран. Заголовки и числа всех восьми карточек статистики, включая кнопки «Подробнее», выровнены по центру на ПК и мобильном экране. Пояснения к команде, паролю и остановке отделены от полей и кнопок одинаковыми отступами. Кнопка «Обновить все по очереди» зелёная. Рядом добавлена красная кнопка «Перезапустить все роутера». Она использует тот же общий SSH-пароль, запускает отдельную последовательную очередь reboot и не выполняет команду из поля обновления. Две очереди одновременно не работают. Если имя не задано в Hub, оно уточняется из owrtremote.main.router_name перед перезапуском каждого роутера. Команда отправляется один раз в отдельном процессе с небольшой задержкой, чтобы SSH успел передать подтверждение. Разрыв SSH сам по себе не считается успехом. «Успешно» появляется после восстановления SSH и изменения Linux boot_id: роутер действительно прошёл новую загрузку. Ожидание ограничено тремя минутами на роутер. Ошибка пароля/команды, отсутствие туннеля или неподтверждённая загрузка отображаются отдельно, затем очередь переходит к следующему роутеру. «Остановить всё» прекращает очередь, но уже отправленный reboot не отменяется; его неподтверждённый результат помечается явно. Временный каталог reboot в /tmp исчезает при перезагрузке; повторный запрос не запускает эту задачу второй раз. Пароль остаётся только в памяти worker, очищается в поле после отправки и не попадает в результаты, БД или browser storage. API перезапуска требует владельца и тот же CSRF/Origin-контроль, что обновление. Рядом с «Вернуться в Hub» есть «Обновить информацию о роутерах»: после завершения очереди кнопка убирает её результаты и получает текущий список, имена и статусы. Во время работающей очереди она только обновляет статусы, не удаляя задачу. Обновление списка не запускает установку и не меняет введённую команду. В карточках отдельно показаны текущий Heartbeat, онлайн/офлайн и последний сообщённый статус Xray. Они обновляются каждые три секунды и не подменяют прошлый итог установки. Если Heartbeat устарел, старое состояние Xray явно помечается как последнее сообщение. Сброс завершённой очереди защищён CSRF и ID: запрос из старой вкладки не удалит более новую очередь. Перезапуск Hub прерывает очередь, но уже запущенный installer на роутере продолжает работу. После перезапуска Hub его итог нужно проверять отдельно. Роутеры с неработающим обратным SSH-туннелем обновить этим способом нельзя. Перед запуском списка устройств нет новых требований к их текущему клиенту.

Установка локальной версии на VPS из Windows 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.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-reboot-all-v120. Не устанавливай/не откатывай Hub, пока его очередь работает.

Проверки

python -m unittest discover -s tests -p test_router_updates.py -v проверяет последовательность, код результата, пароль, отказы подключения, обрыв после запуска, остановку очереди, повторный запрос, права/CSRF и ограниченный shell вывод. Реальный task исполняется в MSYS; отсутствующий setsid заменён Perl обёрткой над его POSIX-вызовом. Проверяются остановка группы, локальный тайм-аут и получение короткого вывода до завершения установки. Синтаксис проверяется также BusyBox ash. Настоящий Linux setsid, Dropbear и обновление физического OpenWrt требуют проверки пользователем.

node tests/test_router_updates_ui.cjs проверяет desktop/mobile, ввод команды, очистку пароля, итоги, дашборд из 35 устройств, обновление списка и живых статусов, сохранение раскрытого вывода и возобновление просмотра. Проверяется список проблемных роутеров, причины, фильтры четырёх категорий и нулевые результаты, сохранение выбора и прокрутки при автообновлении, безопасный вывод текста и сброс списка при обновлении роутеров. Дополнительно проверяются мобильные ширины 320/360/390/430 px, альбомный режим, сохранение настоящей ширины viewport при длинном тексте, размеры полей/кнопок и отсутствие горизонтального выезда. Для ПК проверяется центрирование и ограничение ширины 1100 px на экранах 1280/1440/1920 px, а также прежнее расположение кнопок и полей. Проверки перезапуска используют подставной SSH и безопасный stub reboot: ни тестовая Windows, ни реальные роутеры не перезагружаются. Проверяются новая загрузка, обрыв SSH без повторной команды, rc ошибки, общий пароль, тайм-аут, остановка и исключение двух одновременных очередей. Shell проходит BusyBox ash -n. На экранах 320/390/1280 px проверяются красная кнопка, отдельный POST, очистка пароля, восстановление просмотра очереди и счётчики. Реальную перезагрузку OpenWrt и возврат обратного SSH-туннеля нужно проверить на устройстве.