如何通过 QNAP NAS 上的 Docker 部署 UniFi 网络应用程序？
最后修订日期:
2026-02-10
适用产品
- All models supporting Container Station
背景
UniFi Network Application 是由 Ubiquiti 开发的网络管理软件，用于管理 UniFi 网络设备（接入点、交换机、网关等）。许多用户希望在他们的 QNAP NAS 上使用 Docker 容器运行 UniFi Network Application，而不是专门使用一个独立设备（如 Raspberry Pi）。
在 QNAP 上通过 Docker 部署 UniFi 的主要挑战包括：
- 理解 Docker Compose YAML 文件的放置
- 正确配置持久性存储
- 使用 QNAP 的 QNET 驱动程序设置具有静态 IP 的网络访问
- 确保容器可以从网络上的 UniFi 设备访问
解决方案
先决条件
- 必须在您的 QNAP NAS 上安装Container Station
- 用于存储 UniFi 容器数据的共享文件夹（例如，
/share/Container） - 了解您的 NAS 网络接口（可以通过 SSH 使用
ifconfig找到）
逐步部署
步骤 1：找到您的网络接口名称
- 在您的 QNAP NAS 上启用 SSH：
- 前往控制台 > 网络和文件服务 > Telnet / SSH
- 启用允许 SSH 连接
- 通过 SSH 连接并运行：
ifconfig - 记录您的网络接口名称（例如，
eth0、br0，或连接到目标网络的适配器）
步骤 2：创建 Docker Compose YAML 文件
创建一个名为docker-compose.yml的文件，内容如下：
带变量的模板：
version: "3.8"
services:
unifi:
image: jacobalberty/unifi:latest
container_name: unifi-controller
restart: unless-stopped
networks:
qnet-network:
ipv4_address: ${QNET_STATIC_IP}
environment:
TZ: ${TZ}
volumes:
- ${SHARE_FOLDER}/unifi:/unifi
networks:
qnet-network:
driver_opts:
iface: ${QNET_INTERFACE}
driver: qnet
ipam:
driver: qnet
options:
iface: ${QNET_INTERFACE}
config:
- subnet: ${QNET_SUBNET}
gateway: ${QNET_GATEWAY}实际值示例：
version: "3.8"
services:
unifi:
image: jacobalberty/unifi:latest
container_name: unifi-controller
restart: unless-stopped
networks:
qnet-network:
ipv4_address: 10.8.32.26
environment:
TZ: Asia/Taipei
volumes:
- /share/Container/unifi:/unifi
networks:
qnet-network:
driver_opts:
iface: br0
driver: qnet
ipam:
driver: qnet
options:
iface: br0
config:
- subnet: 10.8.32.0/24
gateway: 10.8.32.1步骤 3：变量参考
| 变量 | 描述 | 示例 |
|---|---|---|
${QNET_STATIC_IP} | 容器的静态 IP 地址 | 10.8.32.26 |
${TZ} | 容器的时区 | Asia/Taipei |
${SHARE_FOLDER} | 共享文件夹的路径 | /share/Container |
${QNET_INTERFACE} | 步骤 1 中的网络接口 | br0 |
${QNET_SUBNET} | 您的网络子网，使用 CIDR 表示法 | 10.8.32.0/24 |
${QNET_GATEWAY} | 您的网络网关 IP | 10.8.32.1 |
步骤 4：部署容器
- 在您的 QNAP NAS 上打开Container Station
- 进入探索 下拉菜单并选择创建应用程序
- 为您的应用程序命名（例如，unifina-1），并粘贴我们刚刚用实际值填写的 docker-compose.yaml 内容。
- 点击验证按钮以验证 YAML 代码。
- 粘贴您的 YAML 内容或导入
- 点击创建以进行部署
- 完成后，容器已启动并运行。
重要注释
第三方应用程序免责声明
jacobalberty/unifi Docker 镜像是第三方应用程序，不是 QNAP 的官方产品。请注意：
- 数据备份：定期备份
/share/Container/unifi目录 - 稳定性：性能取决于 Docker 镜像维护者的更新
- 支持：对于 UniFi 特定问题，请咨询Docker 镜像文档或 Ubiquiti 社区论坛
