Unpoller项目支持Cloud Gateway Ultra的配置指南

Unpoller作为一款优秀的UniFi控制器数据采集工具，能够将网络设备数据导出到InfluxDB或Prometheus等时序数据库。近期有用户询问关于Cloud Gateway Ultra设备的支持情况，本文将详细介绍如何正确配置Unpoller以支持该设备。

配置要点解析

在配置过程中，有几个关键点需要特别注意：

1. 配置文件位置：Unpoller默认会从/etc/unpoller/up.conf路径读取配置文件，这是许多用户容易出错的地方。在Docker环境中，需要通过volume映射将宿主机上的配置文件挂载到这个位置。

2. 控制器URL格式：正确的URL格式应为控制器的基础地址，而不是登录页面地址。例如使用https://10.10.10.1而非https://10.10.10.1/login?redirect=%2F。

3. 认证信息：确保配置文件中包含正确的用户名和密码，且该账号具有足够的API访问权限。

典型配置示例

以下是一个经过验证的有效配置示例：

[unifi.defaults]
url = "https://10.10.10.1"
user = "unifipoller"
pass = "securepassword"
save_dpi = true

[influxdb]
url = "http://10.10.10.248:8086"

Docker环境部署建议

在Docker Compose中，正确的volume映射方式应为：

volumes:
  - /path/to/your/config/unifi-poller.conf:/etc/unpoller/up.conf

避免将配置文件映射到不相关的位置，如/home/grafana/config，这会导致Unpoller无法找到配置文件。

常见错误排查

1. 连接拒绝错误：通常表示URL配置不正确或控制器服务未运行。检查控制器地址和端口是否正确。

2. 认证失败：确认用户名密码正确，并检查账号权限。

3. 配置文件未加载：查看日志确认Unpoller是否成功读取了配置文件。

通过遵循以上指南，用户应该能够成功配置Unpoller来监控Cloud Gateway Ultra设备。正确的配置是确保数据采集正常工作的基础，特别是在容器化部署环境中更需要注意配置文件的路径问题。