vilasboasph/unifi

Unifi-in-Docker（unifi-docker）

本镜像封装了Ubiqiti Network的Unifi Controller，通过Docker解决版本依赖与升级维护问题，支持Ubuntu、Debian、macOS、Windows及树莓派等多平台部署。

核心功能

• 集中管理Unifi系列网络设备（AP、交换机等）
• 多架构兼容（amd64/armhf/arm64）
• 非root用户运行提升安全性
• 自定义SSL证书配置
• 灵活的环境变量（时区、JVM参数等）
• 数据持久化存储（配置、日志）

使用场景

• 家庭/企业网络设备集中管理
• 跨平台部署Unifi Controller需求
• 简化Unifi Controller升级维护流程

配置说明

目录设置（一次性操作）

创建持久化目录：

bash
cd ~
mkdir -p unifi/data
mkdir -p unifi/log

运行容器

bash
docker run -d --init \
   --restart=unless-stopped \
   -p 8080:8080 -p 8443:8443 -p 3478:3478/udp -p 10001:10001/udp \
   -e SYSTEM_IP='<你的Docker主机IP>' \
   -e TZ='Asia/Shanghai' \
   -v ~/unifi:/unifi \
   --user unifi \
   --name unifi \
   docker.xuanyuan.run/vilasboasph/unifi

访问https://<Docker主机IP>:8443完成配置。

停止容器

bash
docker stop unifi
docker rm unifi

升级容器

1. 备份数据
2. 停止当前容器
3. 重新执行docker run命令（自动拉取最新镜像）

关键配置项

环境变量

• SYSTEM_IP：设备访问控制器的IP（需为设备可访问的主机IP）
• TZ：时区（如Asia/Shanghai）
• JVM_MAX_HEAP_SIZE：JVM最大堆内存（默认1024M）
• LOTSOFDEVICES：设备多/资源有限时设为true优化性能

暴露端口

最小化部署需暴露：

• 8080/tcp：设备命令控制
• 8443/tcp：Web界面与API
• 3478/udp：STUN服务
• ***/udp：设备发现

证书支持

将证书放置于~/unifi/cert目录，文件命名：

• cert.pem：证书
• privkey.pem：私钥
• chain.pem：证书链
  椭圆曲线证书需设置UNIFI_ECC_CERT=true。