aexea/unifi-controller

Docker化Ubiquiti UniFi控制器镜像

镜像概述

本镜像将Ubiquiti UniFi控制器打包为Docker容器，提供轻量、便捷的部署方式，用于集中管理UniFi系列网络设备（包括无线AP、路由器、交换机等），支持数据持久化以确保配置和设备信息不丢失。

核心功能

• 集中管理UniFi设备：实现设备配置、固件更新、状态监控等功能
• Web管理界面：通过8443端口访问可视化管理后台
• 数据持久化：支持挂载主机目录保存控制器数据，避免容器重启丢失配置
• 兼容主流UniFi设备型号：适配常见的UniFi网络硬件

使用场景

• 家庭或小型企业网络中UniFi设备的统一管理
• 测试环境快速部署UniFi控制器，验证网络配置方案
• 多设备场景下的批量管理与监控

配置说明

1. 端口映射：需映射8443端口（Web管理界面），根据需求可额外映射8080（设备通信）、3478（STUN）等端口
2. 数据持久化：建议将容器内/opt/Unifi/data目录挂载到主机目录（如/opt/UniFi/data），确保数据持久化

部署示例

Docker Run命令

bash
docker run -d -p 8443:8443 -v /opt/UniFi/data:/opt/Unifi/data docker.xuanyuan.run/aexea/unifi-controller

该命令启动容器并挂载主机/opt/UniFi/data目录到容器内数据目录，实现配置和设备信息的持久化。

Docker Compose示例

yaml
version: '3'
services:
  unifi-controller:
    image: docker.xuanyuan.run/aexea/unifi-controller
    ports:
      - "8443:8443"
      - "8080:8080"
    volumes:
      - /opt/UniFi/data:/opt/Unifi/data
    restart: always

此配置添加了8080端口映射（用于设备与控制器通信），并设置容器自动重启以保证服务稳定性。