11notes/unifi

自动构建

包含MongoDB的Unifi控制器镜像，无需单独数据库；默认以非root用户(1000:1000)运行，具备安全的CI/CD流程、应用级健康检查及自动更新功能，确保安全与稳定。

18 收藏0 次下载active11notes镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

!banner

UNIFI

!size!5px!version!5px!pulls!5px!5px!swiss_made

Unifi控制器（含数据库）

概述 📖

此镜像能做什么？ 本镜像提供稳定可靠的Unifi控制器，内置MongoDB（无需单独数据库镜像，因MongoDB相关版本已停止支持）。

核心价值 💶

为何选择此镜像而非其他现有镜像？ 很好的问题！市场上其他同类镜像无法提供以下特性：

本镜像默认以1000:1000用户身份运行，多数其他镜像以root运行
本镜像通过安全的固定CI/CD流程构建，可抵御上游***，多数其他镜像存在可被利用的上游依赖
本镜像包含验证应用实际运行状态的健康检查，多数其他镜像要么无健康检查，要么仅检查端口开放或 ping 通
本镜像具备自动更新功能，会在新版本发布时自动构建，多数其他镜像更新速度较慢

若您重视安全性、简洁性，并希望能与镜像的维护者和开发者直接沟通，使用本镜像将是理想选择。

比较 🏁

以下是本镜像与最常用或***镜像的对比。

镜像	磁盘大小	默认初始用户	无发行版	支持架构

卷 📁

/unifi/var - 所有配置数据和站点的目录

Compose配置 ✂️

yaml
services:
  unifi:
    image: "11notes/unifi:9.4.19"
    environment:
      TZ: "Europe/Zurich"  # 时区，例如"Asia/Shanghai"
    volumes:
      - "var:/unifi/var"  # 挂载配置数据卷
    networks:
      macvlan:
        ipv4_address: 10.255.255.1  # 分配的IPv4地址
    restart: always  # 始终重启策略

volumes:
  var:  # 定义配置数据卷
  
networks:
  macvlan:
    driver: "macvlan"  # 使用macvlan网络驱动
    driver_opts:
      parent: "eth0"  # 父网络接口
    ipam:
      config:
        - subnet: "10.255.255.0/24"  # 子网
          gateway: "10.255.255.254"  # 网关

默认设置 🗃️

参数	值	描述
`user`	docker	用户名
`uid`	1000	用户ID
`gid`	1000	组ID
`home`	/unifi	docker用户的主目录

环境变量 📝

参数	说明	默认值
`TZ`	时区	无
`DEBUG`	激活容器镜像和应用的调试选项（如果可用）	无

主要标签 🏷️

以下是镜像的主要标签。另有基于每次提交及其sha256短哈希的标签。

9.4.19
9.4.19-unraid

为何没有latest标签？如何更新？

个人认为:latest标签存在风险。我曾多次在镜像中引入破坏性变更，这可能对部分用户造成影响。若不想手动更改标签至最新语义化版本，可使用语义化版本的短格式：无需使用:9.4.19，可使用:9或:9.4。这些标签会随软件新版本更新，效果类似:latest，但至少固定在主版本或次版本级别。

若仍需获取应用的最新版本，可使用:rolling标签，但请注意！此标签会即时获取应用的最新版本，无论是否存在破坏性变更或安全问题，风险自负！

镜像仓库 ☁️

docker pull 11notes/unifi:9.4.19
docker pull ghcr.io/11notes/unifi:9.4.19
docker pull quay.io/11notes/unifi:9.4.19

Unraid版本 🟠

本镜像原生支持Unraid系统。只需在任意标签后添加-unraid，镜像将以99:100用户身份运行（而非1000:1000），避免Unraid系统兼容性问题。

来源 💾

11notes/unifi

基础镜像 🏛️

ubuntu:20.04

构建工具 🧰

unifi
11notes/util

通用提示 📌

使用反向代理（如Traefik、Nginx、HAproxy）终止TLS并保护端点
使用Let’s Encrypt DNS-01挑战获取有效的SSL证书

免责声明

¹ 本镜像会通过向各站点的config.properties添加标志（config.system_cfg.1=system.analytics.anonymous=disabled）自动禁用Ubiquiti的***遥测。您仍需在全局设置中禁用遥测，以完全关闭所有遥测。可通过SSH登录接入点并执行grep analytics /tmp/system.cfg检查遥测状态，输出应显示disabled。建议在DNS拦截工具中阻止FQDN trace.svc.ui.com。