跳到正文
发现
UnPoller:UniFi 监控数据导出工具
命令行工具开发者工具

UnPoller:UniFi 监控数据导出工具

用 Go 编写的 UniFi 控制器数据采集工具,可把站点、设备与客户端指标导出到 InfluxDB 或 Prometheus。

admin
发布于 2026-11-02
浏览
1
访问
0
下载
0
版本
v5.9.1
平台
Windows、macOS、Linux
该作品还没有经过官方审核。访问演示、下载或复制命令前,请自行确认来源可信。

详细介绍

项目简介

UnPoller 是一个用 Go 编写的小型应用,用于采集 UniFi 控制器、站点、设备与客户端的数据,并导出到 InfluxDB;也可以打开端口,以 Prometheus 格式输出这些数据。它同时支持收集 UniFi 的事件、告警、异常与 IDS 数据,这些数据可写入 Loki 或 InfluxDB,或两者都写。

项目附带 13 个 Grafana 仪表板:6 个面向 InfluxDB,7 个面向 Prometheus,在 Grafana 官网 可以搜索到。

主要功能

  • Influx 模式:每 30 秒轮询一次 UniFi 控制器获取测量数据,并写入 Influx 数据库。
  • Prometheus 模式:程序打开一个 Web 端口,等待 Prometheus 拉取;它把 UniFi Controller API 的数据实时转换成 Prometheus 导出格式。
  • 事件与日志采集:自 v2.0.2 起支持 Loki,可收集 UniFi 的事件、告警、异常与 IDS 数据。
  • 覆盖多种设备:支持 UniFi 控制器(可安装在 Windows、macOS、FreeBSD、Linux 或 Docker 上)、CloudKey 硬件,以及较新的 Dream Machine。
  • 多种系统环境:可在 Windows、macOS、FreeBSD、Linux 或 Docker 中运行,并可用 puppet、chef、saltstack、homebrew 或简单的 bash 脚本管理。

安装与使用

安装与配置说明请见官方文档站:https://unpoller.com。

项目为 macOS、Linux、FreeBSD 和 Docker 提供软件包,在 Windows 上同样可以运行。使用时需要有一个持续运行的 UniFi 控制器,以及 InfluxDB 或 Prometheus,再配合 Grafana 查看图表。

遇到问题可以提交 Issue,或在 GoLift Discord 服务器的 #unpoller 频道求助;也可以参考 Ubiquiti 社区帖子。

注意事项

  • 本应用要求 UniFi 控制器始终保持运行。
  • 使用前需要自行准备 InfluxDB 或 Prometheus,以及用于展示的 Grafana。
  • 项目以 MIT 许可证发布,版权归 David Newhall II 所有(2018-2020)。

本作品整理自 GitHub 开源项目 unpoller/unpoller,原作者 @unpoller,许可证 MIT。中文介绍由 AI 根据项目 README 整理,以原仓库为准。

更新记录

  1. v5.9.1当前版本

    ## Changelog * 7ef29ad4cb94a92ba2bf11d40716c0fc45752e0e fix: do not apply slot-specific data plans to other SIMs * df8731dd286695b23a3c0bf931183c50a9989c7f feat: export U5G APN, cellular addressing and data-plan metrics * 4b0fa1e7ab67808b32b1be238568f2264c06159d build: use released UniFi library v6.6.1 * b84bcc7da39db2d6f24801801f4d72a16250810b promunifi: export UAP uplink parent, mesh RSSI/signal and PHY rates

  2. v5.9.0

    改用正式发布的 UniFi 库 v6.6.0;补充对部分 console 系统响应的测试覆盖;修复 inputunifi,使已配置的抓取不受可选指标影响;Prometheus 输出新增 UniFi OS 控制台更新可用性。

评论