pjmorr/unifi-exporter

unifi_exporter

（MIT许可）

镜像概述

unifi_exporter是一个Prometheus exporter工具，用于采集Ubiquiti UniFi控制器API及旗下设备的指标数据，支持单站点或多站点监控，可与Prometheus、Grafana结合构建网络设备监控仪表盘。

核心功能

• 从UniFi控制器API获取设备（如AP、交换机）和站点的性能指标
• 暴露HTTP端点供Prometheus抓取指标
• 支持跳过TLS证书验证（需谨慎使用）
• 可指定监控特定站点或自动扫描所有站点

使用场景

1. 企业/家庭网络中UniFi设备的实时性能监控
2. 网络故障排查与带宽、连接数等指标分析
3. 结合Grafana构建可视化监控仪表盘

配置说明

可用命令行参数：

-telemetry.addr: 导出器监听地址（默认":9130"）  
-telemetry.path: 指标暴露路径（默认"/metrics"）  
-unifi.addr: UniFi控制器API地址（必填）  
-unifi.insecure: 是否跳过TLS证书验证（可选）  
-unifi.username: 控制器认证用户名（必填）  
-unifi.password: 控制器认证密码（必填）  
-unifi.site: 指定监控的站点（可选，默认所有站点）  
-unifi.timeout: API请求超时时间（默认5s）  

Docker部署示例

bash
# 基本运行命令  
docker run -d -p 9130:9130 pjmorr/unifi-exporter \  
  -unifi.addr https://your-unifi-controller:8443 \  
  -unifi.username admin \  
  -unifi.password your-password  

# 指定监控单个站点  
docker run -d -p 9130:9130 pjmorr/unifi-exporter \  
  -unifi.addr https://your-unifi-controller:8443 \  
  -unifi.username admin \  
  -unifi.password your-password \  
  -unifi.site "HomeNetwork"  

监控示例

可通过Grafana导入模板，基于该镜像导出的指标构建包含设备在线状态、带宽使用、用户连接数等维度的监控仪表盘。
（注：示例仪表盘截图可参考原项目文档）

许可信息

该镜像基于MIT许可证开源，详情见原项目仓库。