ronaldvs/new-unifi

镜像概述

由LinuxServer.io团队提供的Unifi控制器容器，支持用户映射和社区支持。Unifi控制器是一款强大的企业级无线管理软件，适用于高密度客户端部署，需低延迟和高 uptime 性能的场景。

核心功能

• 管理Unifi无线接入点（AP）
• 支持高密度客户端连接，确保低延迟
• 提供直观的Web管理界面
• 支持设备发现与配置
• 提供日志监控与故障排查功能

使用场景

• 企业办公区域的无线网络部署
• 公共场所（如商场、酒店）的无线覆盖管理
• 多站点无线网络的集中化管理
• 需要高可用性和低延迟的无线场景

配置说明

Docker部署示例

docker create \
  --name=unifi \
  -v <数据路径>:/config \
  -e PGID=<组ID> -e PUID=<用户ID>  \
  -p 3478:3478/udp \
  -p 10001:10001/udp \
  -p 8080:8080 \
  -p 8081:8081 \
  -p 8443:8443 \
  -p 8843:8843 \
  -p 8880:8880 \
  ronaldvs/new-unifi

参数说明

参数格式为外部:内部，左侧为宿主机端口/路径，右侧为容器内对应项：

• -p 3478:3478/udp：STUN服务器端口
• -p 10001:10001/udp：AP发现所需端口
• -p 8080:8080：Unifi功能所需端口
• -p 8081:8081：端口
• -p 8443:8443：Web管理界面HTTPS端口
• -p 8843:8843：端口
• -p 8880:8880：Web管理界面HTTP端口
• -v <数据路径>:/config：Unifi配置文件存储路径，需至少3GB可用空间
• -e PGID：组ID，用于解决权限问题
• -e PUID：用户ID，用于解决权限问题

用户/组ID设置

使用id user命令获取用户ID（PUID）和组ID（PGID），确保宿主机数据目录的所有者与指定ID一致：

$ id dockeruser
uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

应用设置步骤

1. 访问Web管理界面：https://<宿主机IP>:8443，通过首次运行向导完成配置。
2. 采用Unifi AP：
   • SSH登录AP：ssh ubnt@<AP-IP>（密码为ubnt）
   • 进入mca-cli模式：mca-cli
   • 设置通知地址：set-inform http://<宿主机IP>:8080/inform

其他信息

• 容器运行时的Shell访问：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" }}' ronaldvs/new-unifi