集成

你的网络,进入 Home Assistant

NetPulse 将设备群状态发布到 MQTT broker,Home Assistant 自动发现:无需手动定义,它就会创建设备和实体。一切都在你的局域网内完成。

你能得到什么

把网络当作家里又一个实体

NetPulse 将网络状态写入你为 Home Assistant 已有的 MQTT broker。之后,路由器和它们的指标就可用于面板、自动化和提醒,就像一盏灯或一个温度传感器。

整个安装

一个设备,包含全局健康(评分和标签)、在线与总客户端数、在线与总路由器数,以及未读提醒。

每台路由器,独立呈现

每台路由器一个设备,包含是否在线、健康、CPU、内存、温度和客户端数。与安装关联,以便在面板中分组。

提醒随发生而来

每条提醒在触发的那一刻就作为事件发布(温度、WAN 断开、新设备……),你可以把它变成任意自动化。

NetPulse 只写入,不监听:它是一个发布者。在 Home Assistant 里你读取网络;要对路由器进行操作,用 NetGrip,它的面板,同样说 MQTT,也接受命令。

快速上手

四步,只需一次

默认关闭:在你开启之前,NetPulse 不发布任何内容。它通过环境变量配置(on-box 模式下用 UCI 选项)。

  • 一个 MQTT broker(通常选 Home Assistant 的 Mosquitto 附加组件)
  • 在 Home Assistant 中启用 MQTT 发现(配合 Mosquitto 是常规做法)
  • 如果有多套安装,需要一个实例名(家里、办公室……)
  • 不需要别的:无需开放端口,无需动路由器

环境变量(或设置中的 MQTT 卡片)

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 不只是看到路由器:还能驱动它。

操作 命令 topic 值
访客 Wi-Finetgrip/<router>/command/guest_wifiON / OFF
banIPnetgrip/<router>/command/banipON / OFF / RELOAD
IPv6netgrip/<router>/command/ipv6ON / OFF
SQMnetgrip/<router>/command/sqmON / OFF
重启netgrip/<router>/command/rebootPRESS

每台路由器在 netgrip/<router>/result 上回复结果。它还发布自己的 17 个传感器:各频段客户端数、最弱和平均 WiFi 信号,以及局域网流量。

带有局域网流量和安装健康的 Home Assistant 面板。

你需要知道的

  • 与 broker 的连接不带 TLS(端口 1883):面向局域网内的 broker,而不是把它暴露到互联网。
  • 在你开启之前一直关闭,演示模式下不发布任何内容。
  • 中间没有云端:数据从 NetPulse 到你的 broker,再从那里到你的 Home Assistant,不经过任何第三方。
  • 如果 broker 掉线,NetPulse 不会察觉:发布会静默失败并重试。监控照常运行。

在你的网络上试试

安装 NetPulse,把它的实例指向 broker,一分钟内你的网络就进入 Home Assistant。

外观
主题