riro/unifi2mqtt

unifi2mqtt

连接Ubiquiti UniFi控制器到MQTT，实现网络设备数据与物联网平台的集成 📡

镜像概述

本镜像为hobbyquaker/unifi2mqtt的分支版本，用于建立UniFi控制器与MQTT消息代理之间的通信桥梁，支持UniFi设备状态数据的MQTT发布及通过MQTT发送控制指令，适用于物联网场景下的网络设备监控与自动化控制。

核心功能

• 从UniFi控制器获取设备在线状态、流量等数据，并发布到指定MQTT主题
• 通过MQTT消息向UniFi控制器发送设备控制指令（如重启AP）
• 支持跳过SSL证书验证的不安全连接（insecure参数）
• 可配置日志 verbosity 等级（error/warn/info/debug）
• 自定义MQTT主题前缀（name参数）

使用场景

1. 智能家居系统中集成UniFi网络设备状态，实现联动控制
2. 通过MQTT平台监控企业/家庭UniFi网络的设备运行情况
3. 构建基于MQTT的UniFi设备远程管理工具

配置说明

通过环境变量传递配置参数，关键参数如下：

• unifi-host：UniFi控制器地址（默认：127.0.0.1）
• unifi-port：UniFi控制器端口（默认：8443）
• unifi-user：UniFi控制器用户名（默认：admin）
• unifi-password：UniFi控制器密码（必填）
• unifi-site：UniFi站点名称（默认：default）
• insecure：允许不安全的SSL连接（true/false）
• url：MQTT broker地址（默认：mqtt://127.0.0.1）
• verbosity：日志等级（默认：info）

Docker部署示例

拉取镜像

bash
docker pull docker.xuanyuan.run/riro/unifi2mqtt

运行容器

bash
docker run --detach --name unifi2mqtt \
  --restart always \
  --env unifi-host=192.168.100.11 \
  --env unifi-port=8443 \
  --env unifi-user=someuser \
  --env unifi-password=secret \
  --env unifi-site=default \
  --env insecure=true \
  --env url=mqtt://192.168.100.12 \
  docker.xuanyuan.run/riro/unifi2mqtt

查看日志

bash
docker logs -f unifi2mqtt

许可证

MIT © https://github.com/hobbyquaker