这是Ubiquiti Network UniFi Controller的Docker容器化版本,支持非root用户运行、多版本标签选择、自定义SSL证书及外部MongoDB,可集中管理UniFi系列网络设备(如AP、交换机等)。
下载次数: 0状态:社区镜像维护者:jasherai仓库类型:镜像最近更新:
unifi-docker镜像说明
镜像概述
本镜像为Ubiquiti Network UniFi Controller的容器化实现,用于集中管理UniFi系列网络设备(无线AP、交换机、安全网关等)。支持多版本标签、非root运行、数据持久化及自定义配置,适配企业/家庭网络管理场景。
核心功能
- 多版本支持:提供稳定版(latest/stable)、LTS版、RC版等标签,满足不同部署需求。
- 安全运行:通过
RUNAS_UID0=false切换为999/999的unifi用户运行,降低权限风险。 - 数据持久化:绑定
/unifi卷保存配置(data)、日志(log)及证书(cert)。 - 外部MongoDB:通过环境变量配置外部MongoDB服务,实现数据分离。
- 自定义证书:映射
/unifi/cert卷并设置相关变量,支持自定义SSL证书。 - 时区配置:通过
TZ变量指定时区(如Asia/Shanghai)。
使用场景
- 企业/家庭UniFi网络设备的集中配置与监控。
- 跨平台部署(Linux/macOS优先,Windows需注意Mongo卷限制)。
- 高安全性要求的非root容器运行场景。
- 需外部MongoDB实现数据独立存储的部署需求。
配置说明
关键环境变量
| 变量名 | 默认值 | 说明 |
|---|---|---|
RUNAS_UID0 | true | 是否以root运行(建议设为false) |
TZ | - | 时区设置(如Asia/Shanghai) |
UNIFI_HTTPS_PORT | 8443 | Web界面HTTPS端口 |
DB_URI | - | 外部MongoDB URI(需配合STATDB_URI/DB_NAME) |
卷映射
/unifi:主卷,包含data(配置)、log(日志)、cert(证书)子目录。/unifi/data:替代原/var/lib/unifi,保存核心配置。
暴露端口
- 8080/tcp:设备命令控制 | 8443/tcp:Web界面+API | 3478/udp:STUN服务 | ***/udp:UBNT发现
部署示例
Docker Run(Linux/macOS)
bashmkdir -p unifi/data unifi/log docker run --rm --init \ -p 8080:8080 -p 8443:8443 -p 3478:3478/udp -p 10001:10001/udp \ -e TZ='Asia/Shanghai' -e RUNAS_UID0=false \ -v ~/unifi:/unifi --name unifi \ docker.xuanyuan.run/jasherai/unifi-docker:stable
Docker Compose(含MongoDB)
yamlversion: '2.2' services: unifi: image: docker.xuanyuan.run/jasherai/unifi-docker:stable init: true environment: TZ: 'Asia/Shanghai' RUNAS_UID0: 'false' DB_URI: 'mongodb://mongo:27017/unifi' STATDB_URI: 'mongodb://mongo:27017/unifi_stat' DB_NAME: 'unifi' ports: - 8080:8080 - 8443:8443 - 3478:3478/udp - 10001:10001/udp volumes: - ./unifi:/unifi depends_on: - mongo mongo: image: docker.xuanyuan.run/mongo:4.4 volumes: - mongo_data:/data/db volumes: mongo_data:
设备Adoption
- Layer3:Web界面设置控制器IP并重启;或SSH到设备执行
set-inform http://<主机IP>:8080/inform。 - Layer2:使用
--net=host参数运行,或配置macvlan网络。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 unifi-docker 镜像标签
docker pull docker.xuanyuan.run/jasherai/unifi-docker:<标签>
DockerHub 原生拉取命令
docker pull jasherai/unifi-docker:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务