owncloudops/unifi

unifi

![构建状态]([] ![Quay.io]([]

Ubiquiti Unifi Controller的自定义容器镜像，用于集中部署和管理Unifi网络设备。

镜像概述

该镜像为Ubiquiti Unifi Controller提供容器化部署方案，支持Unifi网络设备的发现、配置、监控和管理，通过Web界面和API实现设备通信与控制。

核心功能与特性

• 支持Unifi设备通信与管理
• 提供Web管理界面（8443端口）和API
• 支持数据持久化存储
• 可通过环境变量自定义JVM参数和数据库配置
• 包含Unifi控制器运行所需的关键端口

端口说明

详细端口用途可参考Unifi端口使用说明。

• 3478/udp：STUN连接端口
• 6789/tcp：Unifi移动速度测试端口
• 8080/tcp：设备与控制器通信端口
• 8443/tcp：Web浏览器访问的控制器GUI/API端口

数据卷

• /opt/app/unifi/data：用于存储Unifi控制器数据，建议持久化挂载以保留配置和设备信息。

环境变量

Shell
UNIFI_DB_HOST=          # MongoDB数据库主机（留空则使用内置数据库）
UNIFI_DB_PORT=27017     # MongoDB数据库端口，默认27017
UNIFI_DB_NAME=unifi     # 数据库名称，默认unifi
UNIFI_JVM_EXTRA_OPTS=   # JVM额外参数
UNIFI_JVM_MAX_HEAP_SIZE=1024M  # JVM最大堆内存，默认1024M
UNIFI_JVM_INIT_HEAP_SIZE=      # JVM初始堆内存（留空则由JVM自动分配）

使用方法

Docker Run示例

bash
docker run -d \
  --name unifi-controller \
  -p 3478:3478/udp \
  -p 6789:6789/tcp \
  -p 8080:8080/tcp \
  -p 8443:8443/tcp \
  -v /path/to/local/data:/opt/app/unifi/data \
  -e UNIFI_JVM_MAX_HEAP_SIZE=2048M \
  owncloudops/unifi:latest

构建镜像

可通过BUILD_VERSION参数指定目标版本：

bash
docker build --build-arg BUILD_VERSION=5.14.23 -f Dockerfile -t unifi:latest .

许可证

本项目基于Apache 2.0许可证授权 - 详见https://github.com/owncloud-ops/unifi/blob/main/LICENSE%E6%96%87%E4%BB%B6%E3%80%82