freenas/unifi

Ubiquiti Networks UniFi Controller容器（含FreeNAS元数据）

本容器可在FreeNAS及非FreeNAS Docker环境中运行
本容器遵循UniFi最新稳定版/正式发布版本，当前稳定版为v5.4.x。

镜像概述

该容器是Ubiquiti Networks UniFi Controller的Docker化实现，包含FreeNAS元数据，支持在多种Docker环境中部署，用于集中管理UniFi系列网络设备（如无线接入点UAP、交换机USW、网关USG等）。

核心功能

• 集中管理UniFi设备，监控网络状态与性能
• 提供Web GUI和API接口，便捷配置网络参数
• 支持时区自定义，适配不同地区时间显示
• 数据与日志持久化存储，保障配置不丢失
• 暴露必要端口，满足设备发现、通信及门户重定向需求

使用场景

• 家庭网络：管理家用UniFi无线接入点，优化覆盖范围
• 企业网络：配置访客门户、流量控制，提升办公网络效率
• 小型机房：监控设备运行状态，快速排查网络故障

配置说明

环境变量

• TZ：设置时区，例如"Asia/Shanghai"（时区值可参考tz数据库时区列表）

卷挂载

• /usr/lib/unifi/data：存储配置数据及数据库
• /usr/lib/unifi/logs：存储UniFi和MongoDB日志（用于故障排查）

暴露端口

（参考UniFi官方端口说明）

• 3478/udp：STUN连接端口
• 6789/tcp：移动应用吞吐量测量端口
• 8080/tcp：设备向控制器上报信息端口
• 8443/tcp：控制器GUI及API端口
• 8880/tcp：HTTP门户重定向端口
• 8843/tcp：HTTPS门户重定向端口
• 10001/udp：设备发现广播端口（仅同一子网）

部署示例

Docker Run命令

bash
docker run -d \
  --name unifi \
  -e TZ="Asia/Shanghai" \
  -v /your/host/path/data:/usr/lib/unifi/data \
  -v /your/host/path/logs:/usr/lib/unifi/logs \
  -p 3478:3478/udp \
  -p 6789:6789/tcp \
  -p 8080:8080/tcp \
  -p 8443:8443/tcp \
  -p 8880:8880/tcp \
  -p 8843:8843/tcp \
  -p 10001:10001/udp \
  freenas/unifi

升级说明

强烈建议在更新前备份数据
可通过UniFi界面导出.unf文件，以便需要时重新导入。注意：数据库从新版本回滚到旧版本并非总是可行。