UniFi Controller Docker容器

注意事项

06/01/2024：已修复Java 17更新问题，latest标签恢复准确描述。新年快乐。欢迎反馈使用情况。

12/12/2021：UniFi自6.5.54版本起已修复log4shell漏洞（2021年12月12日起）。更多详情见UniFi社区页面。

更新策略

镜像更新遵循以下策略：

• 每周更新：每周日00:00，master分支将重新构建并标记为latest及对应UniFi版本。这允许上游包更新，始终使用最新版UniFi。
• 临时更新：进行更改时，将推送到dev分支。可能可用，但也可能存在问题。

为保证稳定性，选择latest标签。如需特定UniFi版本，选择对应标签，但注意若非最新版，平台将过时且需更新（部分构建版本较旧）。用于测试开发，选择dev标签。

镜像安装

从Docker Hub拉取：

sh
docker pull lumel/unifi-controller

从源码构建：

sh
git clone [***]
cd docker-unifi-controller
docker build -t "unifi-controller:latest" --rm .

运行容器

创建卷以存储UniFi持久化数据，然后使用创建的卷启动容器。

sh
docker volume create --name unifi
docker run -d \
           --net=host \
           -v unifi:/usr/lib/unifi/data \
           --name lumel-unifi \
           lumel/unifi-controller

若需将状态维护在本地文件系统的特定路径，可使用以下命令：

sh
DATA_PATH=/path/to/unifi-controller
mkdir -p $DATA_PATH
docker run -d \
           --net=host \
           -v ${DATA_PATH}:/usr/lib/unifi/data \
           --name lumel-unifi \
           lumel/unifi-controller

手动更新

如需手动更新包/发行版，使用以下命令：

sh
docker exec -it unifi sh -c 'apt update && apt dist-upgrade'

注意：此操作也会更新UniFi控制器，若为保证稳定性需固定版本，需先固定包：

sh
docker exec -it unifi sh -c 'apt-mark hold unifi && apt update && apt dist-upgrade'

故障排除

问：设备 adoption 失败，提示无法连接控制器。

答： 若使用--net=host网络模式，此问题不应发生！若未使用...

设备 adoption 时，控制器需告知设备回连地址（即控制器地址）。默认自动检测，由于控制器运行在容器中，检测到的地址可能是容器私有IP（通常在172.16.0.0/12网段）。

解决方法：进入UniFi设置，选择“控制器”，输入控制器主机名/IP，并勾选“使用控制器主机名/IP覆盖inform主机”。

问：如何查看当前运行的控制器版本？

答： 三种方法：

1. 查看控制器登录界面
2. 查看“设置 > 网络应用”
3. 执行命令：docker exec -it lumel-unifi cat /unifi-version

作者

• Henry Southgate - GitHub

基于GPL 3许可证分发。详见LICENSE获取更多信息。