UniFi Controller 项目教程

1. 项目的目录结构及介绍

UniFi Controller 项目的目录结构如下：

docker-unifi-controller/
├── Dockerfile
├── docker-compose.yml
├── README.md
└── config/
    ├── data/
    ├── log/
    └── run/

目录介绍：

• Dockerfile: 用于构建 Docker 镜像的文件。
• docker-compose.yml: 用于定义和运行多容器 Docker 应用程序的文件。
• README.md: 项目说明文档。
• config/: 配置文件目录，包含以下子目录：
  • data/: 存储 UniFi Controller 的数据文件。
  • log/: 存储日志文件。
  • run/: 存储运行时文件。

2. 项目的启动文件介绍

项目的启动文件主要是 docker-compose.yml，它定义了如何启动 UniFi Controller 容器。

docker-compose.yml 内容：

version: '3.8'
services:
  unifi-controller:
    image: linuxserver/unifi-controller:latest
    container_name: unifi-controller
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    ports:
      - 8443:8443
      - 3478:3478/udp
      - 10001:10001/udp
      - 8080:8080
      - 1900:1900/udp #optional
      - 8843:8843 #optional
      - 8880:8880 #optional
      - 6789:6789 #optional
      - 5514:5514/udp #optional
    volumes:
      - /path/to/data:/config
    restart: unless-stopped

启动文件介绍：

• image: 指定使用的 Docker 镜像。
• container_name: 指定容器名称。
• environment: 设置环境变量，如用户 ID、组 ID 和时区。
• ports: 映射端口，使外部可以访问 UniFi Controller。
• volumes: 挂载数据卷，用于持久化存储数据。
• restart: 设置容器重启策略。

3. 项目的配置文件介绍

项目的配置文件主要位于 config/ 目录下，包括 data/、log/ 和 run/ 子目录。

配置文件介绍：

• data/: 存储 UniFi Controller 的数据文件，包括设备配置、用户数据等。
• log/: 存储日志文件，记录系统运行日志和错误信息。
• run/: 存储运行时文件，包括临时文件和进程 ID 文件。

配置文件示例：

在 data/ 目录下，主要的配置文件包括：

• system.properties: 系统配置文件，包含各种系统参数设置。
• config.gateway: 网络配置文件，定义网络设置和路由规则。

在 log/ 目录下，主要的日志文件包括：

• server.log: 服务器运行日志，记录系统启动、运行和关闭的详细信息。
• error.log: 错误日志，记录系统运行过程中出现的错误信息。

在 run/ 目录下，主要的运行时文件包括：

• unifi.pid: 进程 ID 文件，记录 UniFi Controller 进程的 PID。

通过以上介绍，您可以更好地理解和使用 UniFi Controller 项目。