这是Ubiquiti Network UniFi控制器的容器化版本,用于管理UniFi系列网络设备(如无线AP、交换机、安全网关等),支持灵活部署、设备adoption及自定义配置。
下载次数: 0状态:自动构建维护者:netpak仓库类型:镜像最近更新:
unifi-docker镜像说明
镜像概述
本镜像为Ubiquiti Network UniFi控制器的容器化实现,支持稳定版、旧稳定版及特定版本标签,可便捷部署以集中管理UniFi系列网络设备。镜像跟踪UniFi APT仓库版本,部分最新稳定版会提前推送。
核心功能
- 设备管理:支持UniFi无线AP、交换机、安全网关等设备的adoption与配置
- 灵活部署:兼容桥接网络、主机网络等多种模式,适配不同场景
- 自定义配置:可设置时区、JVM参数,支持挂载自定义SSL证书
- 数据持久化:通过卷挂载保存配置数据与日志,确保数据不丢失
使用场景
- 家庭/企业网络中部署UniFi控制器,实现设备集中管理
- 测试环境快速搭建UniFi控制平台,验证网络配置
- 容器化运维场景,简化UniFi控制器的部署与升级流程
配置说明
支持标签
| 标签 | 描述 |
|---|---|
latest/stable/unifi-5.5 | 跟踪UniFi稳定版(截至2017-07-31为5.5.20) |
oldstable/unifi-5.4 | 跟踪UniFi旧稳定版(截至2017-07-31为5.4.19) |
| 特定版本(如5.4.19) | 固定使用指定版本的UniFi控制器 |
环境变量
TZ:设置时区(例如Asia/Shanghai)JVM_MAX_THREAD_STACK_SIZE:调整JVM最大线程栈大小(例如1280k)
卷挂载
/var/lib/unifi:保存控制器配置数据/var/log/unifi:存储运行日志/var/run/unifi:存放运行时临时信息/var/cert/unifi:挂载自定义SSL证书(需包含cert.pem、privkey.pem、chain.pem)
暴露端口
- 8080/tcp:设备命令与控制
- 8443/tcp:Web界面与API访问
- 8843/tcp:HTTPS门户
- 8880/tcp:HTTP门户
- 3478/udp:STUN服务
- 6789/tcp:Speed Test(仅unifi5版本)
- ***/udp:UBNT设备发现
部署示例
Docker Run快速启动
bashmkdir -p unifi/data unifi/logs docker run --rm --init \ -p 8080:8080 -p 8443:8443 \ -p 3478:3478/udp -p 10001:10001/udp \ -e TZ='Asia/Shanghai' \ -v ~/unifi/data:/var/lib/unifi \ -v ~/unifi/logs:/var/log/unifi \ --name unifi docker.xuanyuan.run/netpak/unifi-docker:latest
设备Adoption方法
Layer3 SSH Adoption
SSH到目标设备执行以下命令:
bashmca-cli set-inform http://<主机IP>:8080/inform
Layer2 Adoption
- 主机网络模式:添加
--net=host参数 - 桥接网络模式:配置macvlan驱动(参考Docker官方文档)
Beta版本构建(可选)
如需构建Beta版本,使用以下命令:
bashdocker build -t unifi-beta \ --build-arg PKGURL=[***] \ "https://github.com/jacobalberty/unifi-docker.git#beta"
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 unifi-docker 镜像标签
docker pull docker.xuanyuan.run/netpak/unifi-docker:<标签>
DockerHub 原生拉取命令
docker pull netpak/unifi-docker:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务