bswinnerton/unifi_exporter

unifi_exporter

镜像概述

unifi_exporter 是一个Prometheus exporter工具，用于从Ubiquiti UniFi控制器API及设备中采集指标，支持集成到Prometheus监控体系。项目采用MIT许可协议。

维护说明

因UniFi设备种类繁多且API不稳定，原维护者Matt Layher无法单独承担维护工作，正在寻找额外维护者。目前无官方发布版本或Docker镜像，建议从master分支构建部署；若有相关贡献经验，可联系获取推送权限。

核心功能

• 采集UniFi控制器及设备的关键指标（如设备在线状态、网络流量、信号强度等）
• 支持多站点监控配置
• 可通过YAML配置文件自定义连接参数

使用场景

• 企业或家庭UniFi网络的性能与状态监控
• 结合Prometheus和Grafana构建可视化监控仪表盘

配置说明

1. 复制示例配置文件 config.yml.example 并重命名为 config.yml
2. 修改核心参数：
   • unifi.address: UniFi控制器地址
   • unifi.username: 控制器登录用户名
   • unifi.password: 控制器登录密码
   • 默认端口为8443，监听地址默认配置适用于大多数场景

Docker部署示例

Docker Run命令

bash
docker run -d \
  -p 9130:9130 \
  -v /path/to/your/config.yml:/config.yml \
  docker.xuanyuan.run/bswinnerton/unifi_exporter \
  -config.file /config.yml

预期启动输出

2017/11/15 17:06:32 [INFO] successfully authenticated to UniFi controller  
2017/11/15 17:06:32 Starting UniFi exporter on ":9130" for site(s): Default  

示例仪表盘

可结合Grafana创建监控仪表盘，展示设备状态、流量趋势等指标（原项目提供了Grafana仪表盘示例截图）。

致谢

特别感谢Vaibhav Bhembre在ceph_exporter项目上的工作，该项目为unifi_exporter的实现提供了参考。