lsiodev/unifi

linuxserver/unifi

https://linuxserver.io

https://linuxserver.io团队带来的这款容器支持便捷的用户映射和社区支持。如需支持，请通过以下渠道联系：

• https://forum.linuxserver.io
• https://www.linuxserver.io/irc/（freenode网络，频道#linuxserver.io）
• https://www.linuxserver.io/podcast/：内容涵盖Linux服务器优化、Docker及容器化相关主题！

https://hub.docker.com/r/linuxserver/unifi/https://hub.docker.com/r/linuxserver/unifi/

UniFi® Controller软件是一款功能强大的企业级无线软件引擎，适用于需要低延迟和高可用性的高密度客户端部署场景。

镜像概述和主要用途

本镜像提供UniFi Controller软件的容器化部署，用于集中管理UniFi网络设备（如无线接入点、安全网关等）。支持企业级网络配置、设备监控、用户管理及流量分析，适用于中小规模企业网络环境。

核心功能和特性

• 支持UniFi官方"稳定LTS"（默认）和"不稳定"两个版本分支
• 提供用户ID（PUID）和组ID（PGID）映射，避免主机与容器间权限冲突
• 基于xenial系统和s6 overlay，支持容器运行时的shell访问
• 完整端口映射配置，确保设备发现、管理和数据传输功能正常
• 持久化存储配置文件，确保数据不丢失

使用场景和适用范围

• 企业无线接入点（AP）集中管理
• 中小规模网络设备监控与配置
• 需要低延迟、高可用性的无线网络环境
• 多设备统一管理的办公或商业网络

使用方法和配置说明

基本部署命令

bash
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 \
  -p 6789:6789 \
  linuxserver/unifi

版本分支选择

通过标签可选择不同版本分支：

• latest（默认，无需标签）：5.6.x "LTS Stable"稳定分支
• unstable：5.9.x "Unstable"不稳定分支

如需指定分支，在镜像名称后添加标签，例如：linuxserver/unifi:unstable

参数说明

参数格式为主机端:容器端，左侧为宿主机配置，右侧为容器内部配置。

容器基于xenial系统和s6 overlay构建，运行中可通过docker exec -it unifi /bin/bash进入shell。

用户/组ID设置

使用数据卷（-v参数）时，可能出现宿主机与容器间权限冲突。通过指定PUID（用户ID）和PGID（组ID）可解决此问题。确保宿主机数据卷目录所有者与指定的ID一致即可正常运行。

查看当前用户ID和组ID：

bash
$ id 用户名
  uid=1001(用户名) gid=1001(组名) groups=1001(组名)

示例中PUID=1001，PGID=1001。

应用设置

1. Web UI访问：通过https://<宿主机IP>:8443访问管理界面，首次登录将启动设置向导。

2. 设备采用配置：

   • UniFi控制器默认使用容器内部IP，其他设备无法访问。需进入设置 > 控制器 > 控制器设置，将"控制器主机名/IP"修改为宿主机可访问的IP地址。
   • 手动采用设备步骤：

     bash
     ssh ubnt@<AP-IP>  # AP-IP为接入点IP地址
     mca-cli
     set-inform http://<宿主机IP>:8080/inform  # 宿主机IP为运行容器的主机IP
     

     登录密码默认为ubnt。

常见问题

• 安全网关（路由器）下设备无法获取IP：进入设置 > 网络 > 网络名称，将"DHCP网关IP"设置为正确且可访问的IP地址。

容器管理命令

• 进入运行中的容器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" }}' linuxserver/unifi

版本历史

• 14.09.18：更新至5.6.40版本
• 06.07.18：更新至5.6.39版本
• 26.04.18：更新至5.6.37版本
• 24.03.18：更新至5.6.36版本
• 14.03.18：添加5.7x版本的unstable分支
• 19.02.18：添加6789端口以支持吞吐量测试
• 09.02.18：更新至5.6.30版本
• 08.02.18：使用循环简化符号链接
• 08.01.18：更新至5.6.29版本
• 15.12.17：更新至5.6.26版本
• 09.12.17：修复续行符问题
• 12.11.17：在示例中添加STUN服务器端口3478映射
• 11.11.17：更新至5.6.22版本
• 22.10.17：修复Dockerfile和证书生成中的拼写错误
• 05.10.17：更新至5.5.24版本
• 03.08.17：更新至5.5.20版本
• 15.07.17：更新至5.5.19版本，切换为.deb包安装
• 05.07.17：更改仓库为稳定版，移除execstack命令
• 18.03.17：修复execstack警告
• 14.10.16：添加版本层信息
• 20.09.16：更新至5.27版本
• 10.09.16：添加层徽章到README
• 28.08.16：添加徽章到README
• 01.07.16：切换至lsiobase/xenial基础镜像
• 25.06.16：基于xenial重建并使用更新的仓库
• 02.11.15：初始发布