路由器、交换机和控制器

在一个视图中查看你的网络设备

NetPulse 通过原生代理、SNMP、外部代理或交换机固件中的 beacon 接收数据。合适的数据源取决于每台设备能运行的软件。

兼容性

各平台如何连接

这里列出支持的设备系列及每种数据源能提供什么。具体覆盖范围取决于型号和固件。

各平台的数据源、覆盖范围和要求
平台 数据源 可用数据 要求和限制
OpenWrt 和 GL.iNet 路由器上的原生代理 系统、WiFi、客户端和端口 在支持的版本上从 NetPulse 安装
MikroTik RouterOS 7+ 外部 Go 推送程序 主机、接入点和端口 只读用户和一台运行监督程序的机器
Asuswrt / Asuswrt-Merlin 路由器上的探测和推送程序 系统、WiFi、客户端和端口 SSH 访问和 /jffs 持久存储空间
其他集成 BBox 本地 API 轮询器和 RTLPlayground beacon BBox:系统、WAN、主机和端口速率。RTL:端口状态、速率和 FDB BBox:本地 API 和运行 supervisor 的机器。RTL:高级,需替换固件并保留恢复副本
UniFi 外部控制器轮询器 一个站点中的网关、交换机、AP 和客户端 不含 ui.com 云端、CPU 或温度
可网管交换机 NetPulse 通过 SNMP 读取 端口、速率和 LLDP-MIB 邻居 可用 MIB 取决于设备
netpulse-integrations

外部代理

MikroTik、Asuswrt 和 UniFi 会查询路由器或控制器,并通过 HTTPS 将数据发送到 NetPulse。最后一张卡片汇总了使用各自传输方式的其他数据源。

MikroTik RouterOS 7+

读取 RouterOS 并发送主机、接入点和端口数据。

  • 只读用户和一台运行监督程序的机器
  • 使用 8728 端口的二进制 API,REST 作为后备
  • WiFi Wave2 使用 wifi 接口,而不是 capsman

Asuswrt 和 Asuswrt-Merlin

推送程序在路由器上运行,并复用 NetPulse 的可移植探测。它可以放在 /jffs 中。

  • SSH 访问和 /jffs 持久存储空间
  • 客户端、射频、信道和以太网端口
  • 覆盖范围取决于固件和已安装工具

UniFi

读取你的控制器中一个站点的网关、交换机、接入点和客户端。

  • 由你托管的 UniFi OS 控制台和独立控制器
  • 控制器上的只读用户
  • 不支持 ui.com 云账户,不含 CPU 或温度

以及更多集成

两种额外数据源,要求各不相同。

  • BBox:查询本地 API,发送系统、WAN、活动主机和端口速率。
  • RTLPlayground:面向 RTL8372/8373 交换机的固件 beacon,提供端口状态、速率和 FDB。
高级固件

交换机内部的 beacon

Realtek 可网管交换机无法运行 Go 代理。RTLPlayground 分支添加了 beacon,可直接向 NetPulse 监听器发送数据。

NetPulse 接收什么

  • 每 30 秒更新链路状态和速率
  • 根据每个端口的字节计数器计算流量速率
  • 每五分钟发送 FDB 表,按 MAC 地址定位客户端

需要什么

  • 型号必须在 RTLPlayground 设备列表中
  • 为你的机器编译分支并设置交换机标识符
  • 更换固件,并准备闪存备份和恢复方法

beacon 在可信 LAN 内通过 UDP 发送明文令牌。它不使用外部代理的签名 HTTPS 传输。

仅限外部代理

为什么使用独立仓库

RouterOS、Asus、BBox 和 UniFi 共用一个独立仓库。NetPulse 维护数据接收契约,每个集成按各自厂商的发布周期更新。

独立的生命周期

集成使用自己的标签发布修复,无需等待服务器版本。

隔离的凭据

路由器或控制器密码留在集成配置中。NetPulse 只接收代理令牌。

只读

这些集成只读取和发送数据,不会从 NetPulse 修改设备配置。

只启用你需要的功能

核心不会运行你没有使用的集成代码。它保持轻量稳定,你只需要添加所需的代理。

外部代理传输

签名契约

代理使用 HMAC-SHA256 在 X-Agent-Signature 头中签名每个快照,并携带令牌发送到 NetPulse 接收接口。设备显示为 external。

  • 代理运行位置能通过 HTTPS 访问 NetPulse
  • 在应用中创建的路由器令牌
  • 路由器或控制器上的只读用户

编译监督程序

git clone https://github.com/gnacho/netpulse-integrations cd netpulse-integrations go build -o netpulse-integrations ./cmd/integrations-supervisor

仓库发布 amd64 和 arm64 静态二进制及 SHA-256,并附带 systemd 单元示例。

需要了解的限制

  • 外部代理不会配置路由器或控制器。
  • OpenWrt 和 GL.iNet 仍建议使用原生代理。
  • beacon 不报告 CPU、内存或温度,也不发送 LLDP 表。
  • 由 beacon 提供数据的交换机目前无法在 NetPulse 中添加 SNMP 作为第二数据源。
  • 该分支的 beacon 不属于上游 RTLPlayground。

从你的设备开始

安装 NetPulse,然后按照适合你平台的指南操作。

外观
主题