本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
⚠️ 注意:该镜像已废弃。请使用多架构镜像 linuxserver/unifi-controller
更多信息:[***]
linuxserver/unifi 是由 LinuxServer.io 团队开发的Docker容器,用于运行 UniFi® Controller 软件。UniFi Controller是一款功能强大的企业级无线管理软件引擎,主要用于集中管理UniFi系列网络设备(如无线接入点、交换机、安全网关等)。
docker run -d \ --name=unifi \ -v <宿主机数据路径>:/config \ -e PUID=<用户ID> -e PGID=<组ID> \ -p 3478:3478/udp \ -p 10001:10001/udp \ -p 8080:8080 \ -p 8081:8081 \ -p 8443:8443 \ -p 8843:8843 \ -p 8880:8880 \ -p 6789:6789 \ --restart unless-stopped \ linuxserver/unifi
version: "2.1" services: unifi: image: linuxserver/unifi container_name: unifi volumes: - <宿主机数据路径>:/config environment: - PUID=<用户ID> - PGID=<组ID> ports: - 3478:3478/udp - 10001:10001/udp - 8080:8080 - 8081:8081 - 8443:8443 - 8843:8843 - 8880:8880 - 6789:6789 restart: unless-stopped
| 标签 | 说明 |
|---|---|
latest | 基于5.6.x "LTS Stable" 稳定分支 |
unstable | 基于5.9.x "Unstable" 测试分支 |
| 宿主机端口 | 容器端口 | 协议 | 用途说明 |
|---|---|---|---|
| 3478 | 3478 | UDP | STUN服务器端口 |
| 10001 | 10001 | UDP | 接入点发现端口 |
| 8080 | 8080 | TCP | 设备通信端口(inform接口) |
| 8081 | 8081 | TCP | 内部服务端口 |
| 8443 | 8443 | TCP | Web管理界面HTTPS端口 |
| 8843 | 8843 | TCP | 备用HTTPS端口 |
| 8880 | 8880 | TCP | 备用HTTP端口 |
| 6789 | 6789 | TCP | 吞吐量测试端口 |
| 参数 | 说明 |
|---|---|
| PUID | 运行容器的用户ID,用于权限控制,通过 id <用户名> 命令获取 |
| PGID | 运行容器的组ID,用于权限控制,通过 id <用户名> 命令获取 |
| 宿主机路径 | 容器路径 | 说明 |
|---|---|---|
<宿主机数据路径> | /config | 存储UniFi Controller的配置、日志和数据库 |
https://<宿主机IP>:8443 访问Web管理界面若自动发现失败,可通过SSH手动接入:
# 登录接入点(默认用户名:ubnt,密码:ubnt) ssh ubnt@<接入点IP> # 进入mca-cli模式 mca-cli # 设置控制器地址(替换<宿主机IP>为实际IP) set-inform http://<宿主机IP>:8080/inform
问题原因:DHCP服务配置错误
解决方法:
docker exec -it unifi /bin/bash
docker logs -f unifi
docker inspect -f '{{ index .Config.Labels "build_version" }}' unifi
docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/unifi


免费版仅支持 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