在绿联 NAS 上搭建 UniFi 控制器

电脑端

应用简介

UniFi 控制器是一款由 Ubiquiti Networks 开发的网络管理软件，专为管理 UniFi 系列设备（如 AP、交换机、路由器等）设计。通过 UniFi 控制器，用户可以轻松完成以下任务：

配置网络设备；

监控网络状态；

管理固件升级。

搭建 UniFi 控制器后，您可以通过统一的平台高效地管理多个 UniFi 设备，优化网络性能。

使用 Docker Compose 部署容器

在 UGOS Pro 系统上，推荐使用项目 Docker Compose 快速部署容器，适合需同时管理多个容器的场景，这种方法简化了容器的部署与管理工作。以下是使用 Docker Compose 部署 UniFi 的详细步骤。

进入 Docker 项目界面

在 UGOS Pro 系统中，打开 Docker 应用，点击【项目】 > 【创建】，启动项目创建向导。

配置 Docker Compose 文件

在项目创建向导中，上传以下 UniFi 的 Docker Compose 配置文件：

services:
  unifi:
    container_name: unifi
    image: jacobalberty/unifi #镜像名
    restart: always # 重启策略
    init: true
    ports:
      - "8080:8080" # http访问端口，如提示端口冲突，冒号前的NAS端口可按需修改
      - "8443:8443" # httpS访问端口，保持默认不要修改
      - "3478:3478/udp" #  WebRTC 的 STUN/TURN 协议的默认端口
      - "10001:10001" # 用于 UniFi 控制器发现未被接管的 UniFi 设备的默认端口
    volumes:
      - ./config:/unifi # 存放 UniFi 的配置文件和数据库
    environment:
      - TZ=Asia/Shanghai # 容器时区
      - BIND_PRIV=false 
      - RUNAS_UID0=false
      - UNIFI_HTTPS_PORT=8443
    user: unifi # 指定容器内运行程序的用户为unifi

参数说明

image：指定使用的 Docker 镜像版本。

restart：容器重启策略，always表示当容器停止或崩溃时自动重启。

init：

init: true：启用 tini 作为容器的初始化进程，负责管理容器内的子进程，避免资源泄漏问题。

ports：

8080:8080：映射 HTTP 接口端口，WebUI 访问端口。

8443:8443：映射 HTTPS 接口端口，用于加密的 Web UI 访问。

3478:3478/udp：支持 WebRTC 的 STUN/TURN 协议。

10001:10001：用于 UniFi 控制器发现未被接管的 UniFi 设备（如接入点或交换机）。

volumes：映射 NAS 文件目录到容器路径。

./config:/unifi：NAS 存储空间目录 ./config 映射到容器内部路径 /unifi ，用来存储所有配置文件和数据，冒号前面是 NAS 的存储空间内存放路径。

注意：

• ./ 表示当前 Docker Compose 文件所在的目录；

• 冒号前是 NAS 的存储路径，冒号后是容器内的映射路径。

environment：

TZ=Asia/Shanghai：设置容器时区为中国上海（Asia/Shanghai），您可以根据所在的时区进行调整，例如美国时区（America/New_York）或欧洲时区（Europe/London）。

BIND_PRIV=false：禁用绑定特权端口（如小于 1024 的端口），允许非 root 用户绑定服务端口。

RUNAS_UID0=false禁止以 root 用户身份运行，增加容器安全性。

UNIFI_HTTPS_PORT=8443 设置的是 HTTPS 端口，HTTP 端口会自动重定向到这个 HTTPS 端口。如果要改 HTTPS 端口，请同时修改这个环境变量。

user：

user=unifi：指定容器内运行程序的用户为 unifi，可提高安全性，避免使用默认的 root 用户。

部署项目

上传配置文件后，点击【立即部署】，系统会自动拉取镜像并启动容器。

部署完成后，通过浏览器访问以下地址进入 UniFi 界面：

http://<NAS_IP>:8080

请将 <NAS_IP> 替换为 NAS 的实际 IP 地址，例如：http://192.168.22.153:8080。

使用指南

完成部署后，通过以下步骤使用 UniFi 控制器：

1. 打开浏览器，访问 http://<NAS_IP>:8080，进入登录页面，按照引导完成以下初始化设置。

2. 为您的 UniFi 网络服务器命名；

3. 登录或注册 UniFi 账户（如无账户，可点击 Create a UI Account 创建新用户）。

4. 登录成功后，您即可在 Web 界面中管理 UniFi 网络设备，包括：

配置无线网络；

管理接入设备；

监控网络状态；

升级设备固件。