gnacho/netpulse
运维与部署自托管的 OpenWrt/GL.iNet 家庭网络监控面板,实时汇总体检、设备、WireGuard 和 AdGuard 统计。
项目介绍
NetPulse 是面向 OpenWrt/GL.iNet 家庭或小型办公网络的自托管 PWA。Go 服务端从各路由器上的 agent 收集数据,存入 SQLite,再通过 SSE 把状态实时推给 React 前端。页面集中展示整个网络的健康分、单台路由器的 CPU/内存/温度/流量、接入设备、WireGuard 节点、AdGuard Home 统计和告警,适合想自己掌控网络硬件、不希望监控数据出局域网的人。
除了状态卡片,它还能根据 bridge FDB、LLDP 和 SNMP 数据推断并绘制拓扑,按主机名和 OUI 分类设备,按需或定时做 WAN 测速。告警可通过 Web Push、ntfy、Telegram 或 Webhook 送达。可选的 MQTT 发布能让 Home Assistant 自动发现网络实体。MikroTik、Asuswrt/Merlin、OPNsense 和 UniFi 通过独立 pusher 集成接入,平台相关代码不放在路由器上。
快速使用
官方流程要求一台带 systemd 的 Linux 机器(x86_64、arm64 或 armv7),以及局域网内的 OpenWrt/GL.iNet 路由器。安装服务端前,README 建议先把安装脚本下载下来阅读,再执行 安装服务端:
curl -fsSL --retry 3 -o /tmp/netpulse-install.sh https://raw.githubusercontent.com/gnacho/netpulse/main/install.sh && sh /tmp/netpulse-install.sh
安装器会创建 netpulse systemd 服务,并打印一次初始管理员密码。打开 http://<server-ip>:3000 登录,把首次启动生成的 SSH 公钥追加到各路由器的 /etc/dropbear/authorized_keys,然后在界面中进入 Routers → Install agent。服务端会按路由器架构推送对应二进制、写入配置并启动服务。
在浏览器中安装 PWA 并在 Settings 启用 Web Push 后,手机即使关闭页面也能收到告警。没有路由器也可以先试用:README 说明了带 67 台设备样例网络的 demo 模式,另有只读的 在线演示 可直接操作。
使用约束
OpenWrt/GL.iNet 路由器通过原生 agent 接入;MikroTik、Asuswrt/Merlin、OPNsense 和 UniFi 需要部署单独的 pusher,步骤见 外部集成指南。支持 SNMP 管理的交换机。服务端运行在 Linux + systemd 上,也可按文档在 OpenWrt 路由器上单机运行。LAN 发现能识别网关,但监控其他路由器仍依赖 SSH 访问或配对令牌流程。
内置 MCP 服务默认关闭,启用后通过 API token 经 HTTP 读取整个网络状态,README 提醒把端口留在局域网内。MQTT 和机柜预览同样是可选功能。项目采用 AGPL-3.0 许可证,安装脚本、用户手册和更新日志都在仓库中维护。
HotRepo 点评
在 2026-11-16 的 Go 日榜中,NetPulse 记录到 332 个 Star 和 22 个 Fork,当日新增 36 个 Star,最佳名次为第 7。这只是单日快照,不能据此判断长期趋势,但说明项目在 Go 生态中获得了当日关注。值得留意的设计是把平台集成放在服务端之外:核心保持单个 Go 二进制,路由器只运行自己平台的 agent,既缩小了自托管体积,也让非 OpenWrt 设备的支持可以独立演进。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。