11notes/unifi

UNIFI

Unifi控制器（含数据库）

概述 📖

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

核心价值 💶

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

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

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

比较 🏁

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

卷 📁

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

Compose配置 ✂️

yaml
services:
  unifi:
    image: "docker.xuanyuan.run/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"  # 网关

默认设置 🗃️

环境变量 📝

主要标签 🏷️

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

• https://hub.docker.com/r/11notes/unifi/tags?name=9.4.19
• https://hub.docker.com/r/11notes/unifi/tags?name=9.4.19-unraid

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

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

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

镜像仓库 ☁️

docker pull docker.xuanyuan.run/11notes/unifi:9.4.19
docker pull ***-ghcr.xuanyuan.run/11notes/unifi:9.4.19
docker pull ***-quay.xuanyuan.run/11notes/unifi:9.4.19

Unraid版本 🟠

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

来源 💾

• https://github.com/11notes/docker-UNIFI

基础镜像 🏛️

• https://hub.docker.com/_/ubuntu

构建工具 🧰

• https://community.ui.com/releases/r/network/9.1.120
• https://github.com/11notes/docker-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。

ElevenNotes™️

本镜像仅供您自行承担风险使用。更新镜像版本前请务必备份数据。查看https://github.com/11notes/docker-unifi/releases了解破坏性变更。使用中遇到问题请提交https://github.com/11notes/docker-unifi/issues。如有疑问或建议，请创建https://github.com/11notes/docker-unifi/discussions而非issue。所有其他仓库可在https://github.com/11notes?tab=repositories查看。

创建于 02.09.2025, 07:26:45 (CET)