NetPulse и Home Assistant

Что вы получите

Ваша сеть как ещё одна сущность дома

NetPulse записывает состояние вашей сети в брокер MQTT, который у вас уже работает для Home Assistant. Оттуда роутеры и их метрики доступны для панелей, автоматизаций и оповещений - как лампа или датчик температуры.

Вся установка

Одно устройство с общим здоровьем (оценка и метка), клиентами онлайн и всего, роутерами онлайн и всего и непрочитанными оповещениями.

Каждый роутер отдельно

Одно устройство на роутер: онлайн ли он, его здоровье, CPU, память, температура и число клиентов. Связано с установкой, чтобы группироваться на панели.

Оповещения по мере событий

Каждое оповещение публикуется как событие в момент срабатывания (температура, падение WAN, новое устройство...), и вы превращаете его в любую нужную автоматизацию.

NetPulse пишет, но не слушает: он публикующая сторона. Из Home Assistant вы читаете сеть; чтобы воздействовать на роутер, используйте NetGrip, его панель, которая тоже говорит по MQTT и принимает команды.

Начало работы

Четыре шага, один раз

Он поставляется выключенным: пока вы его не включите, NetPulse ничего не публикует. Настраивается переменными окружения (или опциями UCI в режиме on-box).

Брокер MQTT (обычно это аддон Mosquitto для Home Assistant)
Включённое обнаружение MQTT в Home Assistant (норма при Mosquitto)
Имя экземпляра, если у вас больше одной установки (дом, офис...)
Больше ничего: не нужно открывать порты и трогать роутер

Переменные окружения

NETPULSE_MQTT_ENABLED=1
NETPULSE_MQTT_HOST=10.0.0.10
NETPULSE_MQTT_USER=netpulse
NETPULSE_MQTT_PASS=...
NETPULSE_MQTT_INSTANCE=casa

После перезапуска в логе появится "[mqtt] connected ... as instance \"home\"". Первое состояние занимает не больше одного интервала.

Сущности

Что появляется в Home Assistant

Одно устройство для установки и по одному на роутер, привязанные к первому. Вот сущности, которые создаются сами:

Устройство	Сущность	Тип	Единица
NetPulse <instancia>	Health score	сенсор
	Clients online	сенсор
	Routers online	сенсор
	Unread alerts	сенсор
	NetPulse version	сенсор (диагностика)
каждый роутер	Online	бинарный (связность)
	Health	сенсор
	CPU usage	сенсор	%
	Memory usage	сенсор	%
	Temperature	сенсор	°C
	Clients	сенсор (диагностика)

Если на роутере работает NetGrip с включённым MQTT, именно NetGrip показывает его в Home Assistant, а NetPulse его не публикует: вы увидите только одно устройство на роутер.

Устройство роутера в Home Assistant с сущностями, созданными обнаружением.

И больше: NetGrip

Управление роутером из Home Assistant

NetPulse только публикует, но роутеры с NetGrip (его панелью) также принимают команды по MQTT. С включённым NetGrip Home Assistant не просто видит роутер: он им управляет.

Действие	Топик команды	Значение
Гостевой Wi-Fi	`netgrip/<router>/command/guest_wifi`	ON / OFF
banIP	`netgrip/<router>/command/banip`	ON / OFF / RELOAD
IPv6	`netgrip/<router>/command/ipv6`	ON / OFF
SQM	`netgrip/<router>/command/sqm`	ON / OFF
Перезагрузка	`netgrip/<router>/command/reboot`	PRESS

Каждый роутер отвечает результатом в netgrip/<router>/result. Также он публикует 17 собственных сенсоров: клиенты по диапазонам, минимальный и средний сигнал WiFi и трафик локальной сети.

Панель Home Assistant с трафиком локальной сети и здоровьем установки.

Что стоит знать

Подключение к брокеру без TLS (порт 1883): рассчитано на брокер в вашей локальной сети, а не на его публикацию в интернет.
Он выключен, пока вы его не включите, а в демо-режиме ничего не публикует.
Никакого облака посередине: данные идут от NetPulse к вашему брокеру и оттуда в ваш Home Assistant, без третьих сторон.
Если брокер упадёт, NetPulse этого не заметит: публикация молча завершается ошибкой и повторяется. Мониторинг продолжает работать.

Попробуйте в своей сети

Установите NetPulse, направьте его экземпляр на брокер - и через минуту ваша сеть будет внутри Home Assistant.

Установить в своей сети Возможности

Ваша сеть внутри Home Assistant