本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

用于运行Ubiquiti UniFi控制器软件的Docker镜像。
Dockerfile目录链接9.1.120, 9.1 (v9.1.120/9.1)9.2.87, 9.2 (v9.2.87/9.2)9.3.45, 9.3 (v9.3.45/9.3)9.4.19, 9.4, 9, latest (v9.4.19/9.4)⚠️ 本项目正在过渡到MongoDB 4.4,直接升级不可行!⚠️
入口点已添加检查,若数据库文件来自旧版Mongo需要升级,将阻止网络应用(控制器)启动。这允许您回滚到之前使用的容器版本,无任何问题。您可在方便时安排升级。
升级说明参见:<[***]>
Ubiquiti的测试版发布结构包含"unstable"、"testing"和"stable candidate"版本,这些版本均包含在此镜像中。仅稳定版本会标记为通用版本(例如:5.6对应5.6.30稳定版)或latest。
| 架构 | 可用 | 标签 | 
|---|---|---|
| amd64 | ✅ | <version tag>-amd64 | 
| arm64v8 | ✅ | <version tag>-arm64v8 | 
| arm32v7 | ❌ | 
注:由于上游不再支持arm32/armhf架构的MongoDB <= 3.6,arm32v7已不再受支持。
从7.5.x版本开始,此容器镜像支持UniFi的标准配置工具。
您可在容器内/var/lib/unifi/system.properties路径提供system.properties文件,或设置以下任一环境变量:
| 环境变量 | 描述 | 默认值 | 
|---|---|---|
| JVM_INIT_HEAP_SIZE | 初始Java堆大小(MiB) | None | 
| JVM_MAX_HEAP_SIZE | 最大Java堆大小(MiB) | 1024 | 
| JAVA_ENTROPY_GATHER_DEVICE | 熵收集设备路径 | None | 
| UNIFI_JVM_EXTRA_OPTS | 额外JVM选项 | $JAVA_OPTS | 
此外,默认使用-XX:+UseParallelGC,但可通过UniFi属性unifi.G1GC.enabled修改。
文档参见wiki。
./build.sh -v <docker版本> -u <unifi版本> [-t <额外docker标签> ...]
示例:./build.sh -v 5.9.29 -u 5.9.29-04b5d20997 -t 5.9 -t 5 -t latest
./publish.sh -v <docker版本> -u <unifi版本>
示例:./publish.sh -v 5.9.29 -u 5.9.29-04b5d20997
./tag.sh -v <docker版本> -u <unifi版本> [-t <额外docker标签> ...]
示例:./tag.sh -v 5.9.29 -u 5.9.29-04b5d20997 -t 5.9 -t 5 -t latest
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429