搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

gnacho/netpulse

运维与部署

自托管的 OpenWrt/GL.iNet 家庭网络监控面板,实时汇总体检、设备、WireGuard 和 AdGuard 统计。

334
22
Go
AGPL-3.0
创建于 3 个月前

项目介绍

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 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. bnlqn/overlook只读的家庭实验室状态页,汇总你已在运行的检查引擎、服务器、应用数据和待办事项。Go106
  2. netbirdio/netbird构建基于身份的私有网络,让设备通过 WireGuard 点对点互联并集中管控访问。Go30,383
  3. vernesong/OpenClash在 OpenWrt 路由器上运行并管理 Mihomo 代理,实现规则分流与透明代理。JavaScript28,018
  4. TwiN/gatus面向开发者的自托管健康状态页,主动探测服务并按条件告警。Go12,604
  5. tailscale/tailscale基于 WireGuard 的网状 VPN 守护进程与命令行工具,把服务器、笔记本和远程设备连成一个私有网络。Go38,215