Перейти к содержанию

Роутеры (OpenWrt)

Агент можно поставить на роутер площадки с OpenWrt: он выполняет сетевые проверки с точки подключения – оттуда, где офис выходит в интернет. Роутеры живут на своей вкладке Настройки → Агенты → «Роутеры», отдельно от частных агентов, и в «Пользовательский опыт» не попадают.

Вкладка «Роутеры» стоит после «Частных» и видна всегда. Пока роутеров нет, на ней строка «Роутеров пока нет. Добавьте роутер кнопкой «+ Добавить агента», тип «Роутер».» Таблица и раскрытие строки – такие же, как у частных агентов, см. Парк агентов. Массового обновления у роутеров нет.

Что понадобится

Требования окно установки пишет само:

  • OpenWrt 24.10 или новее, процессор aarch64 или ARMv7;
  • на роутере есть curl, sha256sum, UCI и procd;
  • верное время UTC, работающий DNS и корневые сертификаты, исходящий HTTPS до платформы;
  • не меньше 13 МиБ свободного флеша и 28 МиБ в /tmp;
  • доступ к роутеру по SSH от root.

Предварительная сборка

Агент для OpenWrt – предварительная сборка. Окно называет её версию и на чём установка проверена; установка на OpenWrt ARMv7 ещё не принята.

Шаг 1. Завести роутер

Настройки → Агенты → «+ Добавить агента», тип «Роутер», имя обязательно – так роутер будет называться в списке и в тестах. «Создать».

Окно покажет токен – один раз – и одну вкладку «OpenWrt» с командами. Запустить агента с этим токеном нужно в течение семи суток. После «Готово» откроется вкладка «Роутеры».

окно Агент … создан для типа Роутер

Шаг 2. Выполнить команды на роутере

Все шаги выполняются по SSH от root на самом роутере, в одном сеансе: команды следующих шагов пользуются каталогом, который создал первый. Каждую команду копируйте из окна кнопкой «Копировать» – в ней уже адреса вашей платформы.

  1. «Скачайте установщик на роутер и проверьте SHA256 – продолжайте только после OK». Команда скачивает установщик во временный каталог и сверяет его контрольную сумму. Если вместо OK пришла ошибка – дальше не идите.

  2. «Сохраните токен – вставьте его в терминал и нажмите Enter»:

    sh ./install.sh token

    Токен вводится скрыто и не попадает ни в команду, ни в историю.

  3. «Установите и запустите агента» – команда install.sh install с именем роутера и адресами платформы.

  4. «Проверьте службу, затем свежий контакт и новый результат назначенного теста в платформе»:

    service netelum-agent status &&
service netelum-agent enabled &&
/usr/bin/netelum-agent version

  5. «Удалите скачанный установщик после проверки».

Токен хранится в /etc/netelum/token с правами 600.

Время на роутере

Агенту нужно верное время. Если на роутере нет признака синхронизации NTP (файла /var/state/dnsmasqsec), сверьте UTC с точным источником и только после этого добавьте --time-synced к команде установки из шага 3.

Шаг 3. Проверить в панели

Статус службы на роутере ещё не значит, что измерения доходят. На Настройки → Агенты → «Роутеры» роутер должен стать «онлайн» со свежим «Контактом», а у теста, на который его назначили, – появиться новый результат.

Вернуть из архива

Роутер отправляется в архив и возвращается так же, как частный агент, см. Архив агентов. При возврате на вкладке «OpenWrt» другие шаги: сохранить новый токен, затем перезапустить службу; если агент с роутера удалён, тот же шаг установит его заново.

Чего здесь пока нет

Диагностика на роутере, настройки UCI и удаление агента в окне не описаны – за этими инструкциями обращайтесь в поддержку Netelum.