Este conteúdo foi traduzido automaticamente. Consulte a Limitação de Responsabilidade da tradução automática.

How to Deploy UniFi Network Application via Docker on QNAP NAS?

Como implementar a aplicação UniFi Network através de Docker no QNAP NAS?

Data da última modificação: 2026-02-10

Applicable Products

All models supporting Container Station

Background

UniFi Network Application is a network management software developed by Ubiquiti for managing UniFi network devices (access points, switches, gateways, etc.). Many users want to run UniFi Network Application on their QNAP NAS using Docker containers instead of dedicating a separate device (like a Raspberry Pi).

The main challenges when deploying UniFi via Docker on QNAP include:

Understanding Docker Compose YAML file placement
Configuring persistent storage correctly
Setting up network access with static IP using QNAP's QNET driver
Ensuring the container can be accessed from UniFi devices on the network

Solution

Prerequisites

Container Station must be installed on your QNAP NAS
A shared folder for storing UniFi container data (e.g., /share/Container)
Knowledge of your NAS network interface (can be found via SSH with ifconfig)

Step-by-Step Deployment

Step 1: Find Your Network Interface Name

Enable SSH on your QNAP NAS:
- Go to Control Panel > Network & File Services > Telnet / SSH
- Enable Allow SSH connection
Connect via SSH and run:
```
ifconfig
```
Note your network interface name (e.g., eth0, br0, or the adapter connected to your target network)

Step 2: Create the Docker Compose YAML File

Create a file named docker-compose.yml with the following content:

Template with Variables:

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}

Example with Actual Values:

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

Step 3: Variable Reference

Variable	Description	Example
`${QNET_STATIC_IP}`	Static IP address for the container	`10.8.32.26`
`${TZ}`	Timezone for the container	`Asia/Taipei`
`${SHARE_FOLDER}`	Path to your shared folder	`/share/Container`
`${QNET_INTERFACE}`	Network interface from Step 1	`br0`
`${QNET_SUBNET}`	Your network subnet in CIDR notation	`10.8.32.0/24`
`${QNET_GATEWAY}`	Your network gateway IP	`10.8.32.1`

Step 4: Deploy the Container

Open Container Station on your QNAP NAS
Go to Explore pull-down menu and choose Create Application
Name your application (e.g., unifina-1) and paste contents of the docker-compose.yaml that we just filled out with actual values.
Click on Validate button to verify the YAML codes.
Paste your YAML content or impo
Click Create to deploy
Once it is done, the container is up and running.

Important Notes

Third-Party Application Disclaimer

The jacobalberty/unifi Docker image is a third-party application, not an official QNAP product. Please note:

Data Backup: Regularly back up the /share/Container/unifi directory
Stability: Performance depends on the Docker image maintainer's updates
Support: For UniFi-specific issues, consult the Docker image documentation or Ubiquiti community forums

Produtos Aplicáveis

All models supporting Container Station

Contexto

A aplicação UniFi Network é um software de gestão de rede desenvolvido pela Ubiquiti para gerir dispositivos de rede UniFi (pontos de acesso, switches, gateways, etc.). Muitos utilizadores querem executar a aplicação UniFi Network no seu NAS QNAP utilizando Docker containers em vez de dedicar um dispositivo separado (como um Raspberry Pi).

Os principais desafios ao implementar o UniFi via Docker no QNAP incluem:

Compreender a colocação do ficheiro YAML do Docker Compose
Configurar corretamente o Armazenamento persistente
Configurar o acesso à rede com IP estático utilizando o driver QNET da QNAP
Garantir que o container pode ser acedido a partir de dispositivos UniFi na rede

Solução

Pré-requisitos

Container Station deve estar instalado no seu NAS QNAP
Uma pasta partilhada para armazenar dados do container UniFi (por exemplo, /share/Container)
Conhecimento da interface de rede do seu NAS (pode ser encontrado via SSH com ifconfig)

Implementação Passo-a-Passo

Passo 1: Encontrar o Nome da Sua Interface de Rede

Ativar SSH no seu NAS QNAP:
- Vá para Painel de Controlo > Serviços de Rede e de Ficheiro > Telnet / SSH
- Ativar Permitir conexão SSH
Conecte-se via SSH e execute:
```
ifconfig
```
Anote o nome da sua interface de rede (por exemplo, eth0, br0, ou o adaptador conectado à sua rede alvo)

Passo 2: Criar o ficheiro YAML do Docker Compose

Crie um ficheiro chamado docker-compose.yml com o seguinte conteúdo:

Modelo com Variáveis:

versão: "3.8"

serviços:
  unifi:
    imagem: jacobalberty/unifi:latest
    nome_do_container: unifi-controller
    reiniciar: unless-stopped

    redes:
      qnet-network:
        ipv4_address: ${QNET_STATIC_IP}

    ambiente:
      TZ: ${TZ}

    volumes:
      - ${SHARE_FOLDER}/unifi:/unifi

redes:
  qnet-network:
    driver_opts:
      iface: ${QNET_INTERFACE}
    driver: qnet
    ipam:
      driver: qnet
      opções:
        iface: ${QNET_INTERFACE}
      configuração:
        - subnet: ${QNET_SUBNET}
          gateway: ${QNET_GATEWAY}

Exemplo com Valores Reais:

versão: "3.8"

serviços:
  unifi:
    imagem: jacobalberty/unifi:latest
    nome_do_container: unifi-controller
    reiniciar: unless-stopped

    redes:
      qnet-network:
        ipv4_address: 10.8.32.26

    ambiente:
      TZ: Asia/Taipei

    volumes:
      - /share/Container/unifi:/unifi

redes:
  qnet-network:
    driver_opts:
      iface: br0
    driver: qnet
    ipam:
      driver: qnet
      opções:
        iface: br0
      configuração:
        - subnet: 10.8.32.0/24
          gateway: 10.8.32.1

Passo 3: Referência de Variáveis

Variável	Descrição	Exemplo
`${QNET_STATIC_IP}`	Endereço IP estático para o container	`10.8.32.26`
`${TZ}`	Fuso horário para o container	`Asia/Taipei`
`${SHARE_FOLDER}`	Caminho para a sua pasta partilhada	`/share/Container`
`${QNET_INTERFACE}`	Interface de rede do Passo 1	`br0`
`${QNET_SUBNET}`	O seu sub-rede de rede em notação CIDR	`10.8.32.0/24`
`${QNET_GATEWAY}`	O IP do gateway da sua rede	`10.8.32.1`

Passo 4: Implementar o Contentor

Abrir Container Station no seu NAS QNAP
Aceda ao Explorar menu suspenso e escolha Criar Aplicação
Nomeie a sua aplicação (por exemplo, unifina-1) e cole o conteúdo do docker-compose.yaml que acabámos de preencher com valores reais.
Clique no botão Validar para verificar os códigos YAML.
Cole o seu conteúdo YAML ou impo
Clique em Criar para implementar
Uma vez concluído, o contentor está ativo e em execução.

Notas importantes

Isenção de Responsabilidade de Aplicações de Terceiros

A imagem jacobalberty/unifi Docker é uma aplicação de terceiros, não um produto oficial da QNAP. Por favor, note:

Cópia de Segurança de Dados: Faça regularmente cópias de segurança do diretório /share/Container/unifi
Estabilidade: O desempenho depende das atualizações do mantenedor da imagem Docker
Suporte: Para questões específicas do UniFi, consulte os Documentação da imagem Docker ou os fóruns da comunidade Ubiquiti

Este artigo foi útil?

Sim. Não.

100% das pessoas acham que foi útil.

Para obter mais ajuda, pergunte a outros utilizadores e aos especialistas da QNAP na comunidade. Ir para a Comunidade QNAP

Conte-nos como podemos melhorar este artigo:

Informações importantes estão faltando no artigo
As soluções do artigo não funcionam
O artigo é muito complicado
O artigo contém informações incorretas
O artigo está desatualizado

Se quiser enviar outros comentários, escreva-os abaixo.