Docker搭建UniFi Controller

UniFi Controller 是由 Ubiquiti Networks 开发的无线网络管理软件解决方案。它允许用户通过其 Web 用户界面管理多个无线网络。UniFi Controller 支持高密度部署，需要低延迟和高可用性。该软件可以安装在 Linux、macOS 或 Microsoft Windows 7/8 上，但通过 Docker 容器化部署是一种简便且流行的选择，因为它包含了所有必要的依赖项。

通过 Docker CLI 搭建

安装 Docker

确保系统上安装了 Docker Engine。可以参考以下指南安装 Docker：

• How To Install Docker CE on Linux Systems

运行 UniFi Controller 容器

1. 拉取 UniFi Controller 镜像：

   docker pull lscr.io/linuxserver/unifi-controller:latest
   

2. 创建持久化卷：

   sudo mkdir -p /unifi_data/config
   sudo chmod 775 -R /unifi_data/config
   

3. 运行容器：

   docker run -d \
   --name=unifi-controller \
   -e PUID=1000 \
   -e PGID=1000 \
   -e MEM_LIMIT=1024 \
   -v /unifi_data/config:/config \
   -ports: 8443:8443 \
   -l com.ubnt.unifi \
   lscr.io/linuxserver/unifi-controller:latest
   

   参数解释：

   • -d：后台运行容器。
   • --name：为容器指定一个名称。
   • -e PUID 和 -e PGID：设置容器的用户和组 ID，以匹配主机系统上的用户。
   • -e MEM_LIMIT：设置 Java 内存限制。
   • -v：定义存储容器数据的卷。
   • -ports：映射容器端口到主机端口。
   • -l：为容器指定标签。

通过 Docker Compose 搭建

创建 docker-compose.yml 文件

version: '3.8'

services:
  unifi-controller:
    image: lscr.io/linuxserver/unifi-controller:latest
    container_name: unifi-controller
    restart: unless-stopped
    volumes:
      - unifi_controller_config:/config
    ports:
      - 3478:3478/udp
      - 10001:10001/udp
      - 8081:8081
      - 1900:1900/udp
    environment:
      - PUID=1000
      - PGID=1000
      - MEM_LIMIT=1024

volumes:
  unifi_controller_config:

参数解释：

• version：Docker Compose 文件版本。
• services：定义服务。
• image：指定使用的镜像。
• container_name：为容器指定名称。
• restart：定义重启策略。
• volumes：定义数据卷。
• ports：映射端口。
• environment：设置环境变量。