本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。
所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。
轩辕镜像 - 国内开发者首选的专业 Docker 镜像下载加速服务平台 - 官方QQ群:13763429 👈点击免费获得技术支持。
本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。
本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。
本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
unifi-controller Docker 镜像下载 - 轩辕镜像
unifi-controller 镜像详细信息和使用指南
unifi-controller 镜像标签列表和版本信息
unifi-controller 镜像拉取命令和加速下载
unifi-controller 镜像使用说明和配置指南
Docker 镜像加速服务 - 轩辕镜像平台
国内开发者首选的 Docker 镜像加速平台
极速拉取 Docker 镜像服务
相关 Docker 镜像推荐
热门 Docker 镜像下载
linuxserver/unifi-controller
unifi-controller 镜像详细信息
unifi-controller 镜像标签列表
unifi-controller 镜像使用说明
unifi-controller 镜像拉取命令
Docker 镜像加速服务
轩辕镜像平台优势
镜像下载指南
相关 Docker 镜像推荐
LinuxServer.io提供的Unifi Controller Docker镜像，用于管理Ubiquiti Unifi企业无线网络设备，支持高密度客户端部署。**该镜像已弃用**，不再更新和提供支持，推荐迁移至unifi-network-application镜像。
798 收藏0 次下载activelinuxserver镜像
unifi-controller 镜像详细说明
unifi-controller 使用指南
unifi-controller 配置说明
unifi-controller 官方文档
linuxserver/unifi-controller
镜像概述和主要用途
该镜像已弃用。自2024年1月1日起，此镜像将不再更新，也不再提供支持。建议迁移至LinuxServer.io的unifi-network-application镜像。
Unifi-controller软件是一款功能强大的企业级无线网络管理引擎，适用于需要低延迟和高可用性的高密度客户端部署场景。
核心功能和特性
- 由LinuxServer.io团队维护，具备以下特点：
- 定期及时的应用更新
- 简单的用户映射（PGID、PUID）
- 基于s6 overlay的自定义基础镜像
- 每周基础操作系统更新，跨生态系统共享通用层以减少空间占用、 downtime和带宽
- 定期安全更新
支持的架构
该镜像利用Docker manifest实现多平台支持。拉取lscr.io/linuxserver/unifi-controller:latest即可自动获取适合当前架构的镜像，也可通过标签指定特定架构。
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64- |
| arm64 | ✅ | arm64v8- |
| armhf | ❌ |
版本标签
| 标签 | 可用 | 描述 |
|---|---|---|
| latest | ✅ | Unifi Controller稳定版发布 |
| mongoless | ✅ | 不含MongoDB的Unifi Controller稳定版 |
应用设置
重要提示
自2024年1月1日起，此镜像将被弃用且不再更新。请迁移至Unifi Network Application镜像，更多信息参见：[***]
基本配置
Web管理界面地址：https://
设备接入配置
为使Unifi控制器能够接入其他设备（如接入点），需修改通知IP地址。由于容器默认使用设备无法访问的内部IP，需进入设置 > 系统 > 高级，将"通知主机"(Inform Host)设置为设备可访问的主机名或IP地址，并勾选"覆盖"(Override)选项，确保设备在接入过程中能连接控制器。
注意：Unifi会定期调整此选项位置，若未找到，可在设置中搜索"Inform"或"Inform Host"。
手动接入设备步骤
ssh ubnt@$AP-IP set-inform [***]
- 默认设备密码：
ubnt $address：运行容器的主机IP地址$AP-IP：接入点的IP地址
安全网关(DHCP)配置
使用安全网关时，若网络设备无法获取IP，需进入设置 > 网络 > <网络名称>，将"DHCP网关IP"(DHCP Gateway IP)设置为可访问的正确IP地址。
严格反向代理配置
此镜像默认使用自签名证书，因此协议为https。若使用验证证书的反向代理，需禁用对容器的证书检查。
使用方法
docker-compose（推荐）
--- version: "2.1" services: unifi-controller: image: lscr.io/linuxserver/unifi-controller:latest container_name: unifi-controller environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC - MEM_LIMIT=1024 #可选 - MEM_STARTUP=1024 #可选 volumes: - /path/to/data:/config ports: - 8443:8443 - 3478:3478/udp - 10001:10001/udp - 8080:8080 - 1900:1900/udp #可选 - 8843:8843 #可选 - 8880:8880 #可选 - 6789:6789 #可选 - 5514:5514/udp #可选 restart: unless-stopped
docker cli
docker run -d \ --name=unifi-controller \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -e MEM_LIMIT=1024 `#可选` \ -e MEM_STARTUP=1024 `#可选` \ -p 8443:8443 \ -p 3478:3478/udp \ -p 10001:10001/udp \ -p 8080:8080 \ -p 1900:1900/udp `#可选` \ -p 8843:8843 `#可选` \ -p 8880:8880 `#可选` \ -p 6789:6789 `#可选` \ -p 5514:5514/udp `#可选` \ -v /path/to/data:/config \ --restart unless-stopped \ lscr.io/linuxserver/unifi-controller:latest
参数说明
容器通过运行时参数配置，格式为<外部>:<内部>。
端口参数
| 参数 | 功能 |
|---|---|
-p 8443 | Unifi Web管理端口 |
-p 3478/udp | Unifi STUN端口 |
-p 10001/udp | 接入点发现所需端口 |
-p 8080 | 设备通信所需端口 |
-p 1900/udp | "使控制器在L2网络可发现"选项所需（可选） |
-p 8843 | Unifi访客门户HTTPS重定向端口（可选） |
-p 8880 | Unifi访客门户HTTP重定向端口（可选） |
-p 6789 | 移动吞吐量测试端口（可选） |
-p 5514/udp | 远程syslog端口（可选） |
环境变量参数
| 参数 | 功能 |
|---|---|
-e PUID=1000 | 用户ID - 详见下方说明 |
-e PGID=1000 | 组ID - 详见下方说明 |
-e TZ=Etc/UTC | 指定时区，列表参见时区数据库 |
-e MEM_LIMIT=1024 | 可选，修改Java内存限制（MB），设为default恢复默认值 |
-e MEM_STARTUP=1024 | 可选，修改Java初始/最小内存（MB），设为default恢复默认值 |
卷参数
| 参数 | 功能 |
|---|---|
-v /config | Unifi所有数据存储路径 |
环境变量从文件（Docker secrets）
可通过特殊前缀FILE__从文件设置环境变量，例如：
-e FILE__MYVAR=/run/secrets/mysecretvariable
将从/run/secrets/mysecretvariable文件内容设置MYVAR环境变量。
Umask设置
所有镜像支持通过-e UMASK=022覆盖容器内服务的默认umask设置。注意umask是权限减法而非加法，详情参见umask说明。
用户/组标识符（PUID/PGID）
使用卷时，可通过指定PUID（用户ID）和PGID（组ID）避免主机与容器间的权限问题。确保主机卷目录所有者与指定的PUID/PGID一致。
通过id your_user命令获取当前用户的PUID和PGID：
id your_user
示例输出：
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
Docker Mods
LinuxServer.io提供多种Docker Mods以扩展容器功能，上述徽章链接可查看此镜像及通用Mods列表。
支持信息
容器内Shell访问
docker exec -it unifi-controller /bin/bash
实时日志监控
docker logs -f unifi-controller
容器版本查询
docker inspect -f '{{ index .Config.Labels "build_version" }}' unifi-controller
镜像版本查询
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/unifi-controller:latest
更新方法
通过Docker Compose
-
更新镜像：
- 所有镜像：
docker-compose pull - 单个镜像：
docker-compose pull unifi-controller
- 所有镜像：
-
更新容器：
- 所有容器：
docker-compose up -d - 单个容器：
docker-compose up -d unifi-controller
- 所有容器：
-
清理旧镜像：
docker image prune
通过Docker Run
-
更新镜像：
docker pull lscr.io/linuxserver/unifi-controller:latest -
停止运行中的容器：
docker stop unifi-controller -
删除容器：
docker rm unifi-controller -
使用相同参数重新创建容器（若卷映射正确，
/config文件夹及设置将保留） -
清理旧镜像：
docker image prune
通过Watchtower自动更新（仅在忘记原始参数时使用）
docker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ --run-once unifi-controller
警告：不建议将Watchtower用作现有容器的自动更新解决方案，长期推荐使用Docker Compose。
本地构建
git clone [***] cd docker-unifi-controller docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/unifi-controller:latest .
在x86_64硬件上构建ARM变体需使用multiarch/qemu-user-static：
docker run --rm --privileged multiarch/qemu-user-static:register --reset
然后使用-f Dockerfile.aarch64指定架构Dockerfile。
版本历史
- 01.01.24: 镜像弃用
- 05.09.23: 添加弃用警告（详见公告）
- 04.09.23: 将JRE升级至17以支持v7.5
- 02.05.23: 清理构建时
apt-get install以减小镜像体积 - 18.03.23: 添加mongoless分支
- 10.03.23: 测试写入/run/unifi，失败时符号链接至/config/run
- 20.02.23: 迁移至s6v3，构建时安装deb包，修复权限
- 23.01.23: 从/config卷排除run目录
- 30.11.22: 将JRE升级至11
- 01.06.22: 弃用armhf架构
- 23.12.21: 将最小/最大内存配置从run移至system.properties
- 22.12.21: 将deb包安装移至首次初始化以避免overlayfs性能问题
- 13.12.21: 64位容器基于Focal重建
- 11.12.21: 添加Java选项以缓解CVE-2021-44228
- 11.06.21: 新增可选环境变量以修改Java初始内存
- 12.01.21: 弃用
LTS标签（Unifi不再发布LTS稳定版），建议切换至latest标签 - 17.07.20: 64位容器基于Bionic和Mongo 3.6重建
- 16.06.20: 添加logrotate
- 02.06.20: 更新端口列表及描述，部分端口设为可选
- 14.11.19: 更新deb包URL以匹配新Ubiquity域名
- 29.07.19: 新增可选环境变量以修改Java内存限制
- 23.03.19: 迁移至新基础镜像，使用arm32v7标签
- 10.02.19: 新unifi-controller镜像初始发布，包含新标签和流水线逻辑
常见问题
轩辕镜像免费版与专业版有什么区别？
免费版仅支持 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 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
410 错误问题
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
manifest unknown 错误
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
镜像拉取成功后，如何去掉轩辕镜像域名前缀？
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
轩辕镜像下载加速使用手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录方式进行 Docker 镜像下载加速教程
通过 Docker 登录方式配置轩辕镜像加速服务，包含7个详细步骤
Linux Docker 镜像下载加速教程
在 Linux 系统上配置轩辕镜像源，支持主流发行版
Windows/Mac Docker 镜像下载加速教程
在 Docker Desktop 中配置轩辕镜像加速，适用于桌面系统
Docker Compose 镜像下载加速教程
在 Docker Compose 中使用轩辕镜像加速，支持容器编排
K8s containerd 镜像下载加速教程
在 k8s 中配置 containerd 使用轩辕镜像加速
宝塔面板 Docker 镜像下载加速教程
在宝塔面板中配置轩辕镜像加速，提升服务器管理效率
群晖 NAS Docker 镜像下载加速教程
在 Synology 群晖NAS系统中配置轩辕镜像加速
飞牛fnOS Docker 镜像下载加速教程
在飞牛fnOS系统中配置轩辕镜像加速
极空间 NAS Docker 镜像下载加速教程
在极空间NAS中配置轩辕镜像加速
爱快路由 ikuai Docker 镜像下载加速教程
在爱快ikuai系统中配置轩辕镜像加速
绿联 NAS Docker 镜像下载加速教程
在绿联NAS系统中配置轩辕镜像加速
威联通 NAS Docker 镜像下载加速教程
在威联通NAS系统中配置轩辕镜像加速
Podman Docker 镜像下载加速教程
在 Podman 中配置轩辕镜像加速，支持多系统
ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像加速教程
配置轩辕镜像加速9大主流镜像仓库，包含详细配置步骤
专属域名方式进行 Docker 镜像下载加速教程
无需登录即可使用轩辕镜像加速服务，更加便捷高效
需要其他帮助？请查看我们的 常见问题 或 官方QQ群: 13763429