docker-unifi - UniFi 控制器 Docker 镜像

镜像概述和主要用途

docker-unifi 是 Ubiquiti UniFi 控制器软件的 Docker 化实现。UniFi 控制器是一款功能强大的企业级无线软件引擎，非常适合需要低延迟和高可用性的高密度客户端部署环境。本项目旨在提供一个开箱即用的解决方案，通过 v3 版本的 Compose 文件在 Docker Swarm 中部署 UniFi 控制器软件栈。

核心功能和特性

• 基于官方 APT 安装方法封装，确保软件完整性和稳定性
• 支持数据持久化存储，通过挂载卷保存 MongoDB 数据
• 支持日志和数据分离存储，便于管理和维护
• 完整暴露 UniFi 控制器所需的网络端口，确保所有功能正常运行

使用场景和适用范围

• 企业级无线网络管理和监控
• 需要集中管理多个 UniFi 设备的环境
• Docker Swarm 或容器化部署架构
• 对网络服务可用性和稳定性有较高要求的场景

详细使用方法和配置说明

端口映射说明

UniFi 控制器需要以下端口映射：

数据卷挂载

为确保数据持久化，需要挂载以下目录：

• 数据目录: /usr/lib/unifi/data - 存储 MongoDB 数据库和配置文件
• 日志目录: /usr/lib/unifi/logs - 存储应用程序日志

Docker 部署示例

基本运行命令

docker run --restart=always -d \
  -p 8080:8080 \
  -p 8443:8443 \
  -p 8880:8880 \
  -p 37117:27117 \
  -p 161:8161 \
  -p 6789:6789 \
  -v /opt/unifi/data:/usr/lib/unifi/data \
  -v /opt/unifi/logs:/usr/lib/unifi/logs \
  --name unifi \
  tibmeister/docker-unifi:latest

Docker Compose 配置示例

version: '3'

services:
  unifi-controller:
    image: tibmeister/docker-unifi:latest
    restart: always
    ports:
      - "8080:8080"
      - "8443:8443"
      - "8880:8880"
      - "37117:27117"
      - "161:8161"
      - "6789:6789"
    volumes:
      - /opt/unifi/data:/usr/lib/unifi/data
      - /opt/unifi/logs:/usr/lib/unifi/logs
    container_name: unifi-controller

访问控制器界面

容器启动后，可以通过以下 URL 访问 UniFi 控制器管理界面： https://{主机IP}:8443/ 或 http://{主机IP}:8880/

注意事项

• 首次启动时，系统需要几分钟时间初始化数据库和配置文件
• 确保主机上的挂载目录具有适当的读写权限
• 如需升级控制器版本，建议先备份数据卷中的配置文件
• 详细端口用途可参考 UniFi 官方端口说明文档

参考链接

• UniFi 官方网站
• UniFi 端口使用说明
• UniFi APT 安装指南