cmsj/unifi_exporter

cmsj/unifi_exporter 镜像说明

镜像概述

cmsj/unifi_exporter是基于Go语言开发的Prometheus Exporter，用于从Ubiquiti UniFi控制器API及设备中采集指标数据，并暴露给Prometheus进行监控。该镜像遵循MIT开源许可协议。

核心功能

• 支持通过用户名/密码认证连接UniFi控制器API
• 可采集指定站点或所有站点的UniFi设备指标
• 暴露默认端口9130和路径/metrics的监控接口
• 可配置API请求超时时间
• 提供跳过TLS证书验证的可选参数（需谨慎使用）

使用场景

• 企业或家庭网络中部署UniFi设备（AP、交换机、网关等）时，通过Prometheus+Grafana实现设备性能、连接状态的实时监控
• 网络运维人员需掌握UniFi网络运行状况，及时发现异常并排查问题

配置说明

可用参数

Docker部署示例

docker run命令

bash
docker run -d --name unifi_exporter \
  -p 9130:9130 \
  cmsj/unifi_exporter \
  -unifi.addr https://your-unifi-controller:8443/ \
  -unifi.username your-username \
  -unifi.password your-password \
  -unifi.site your-site（可选）

docker-compose示例

yaml
version: '3'
services:
  unifi_exporter:
    image: cmsj/unifi_exporter
    ports:
      - "9130:9130"
    command:
      - "-unifi.addr=[***]"
      - "-unifi.username=your-username"
      - "-unifi.password=your-password"
    restart: unless-stopped