Tento obsah je přeložen strojově. Informace najdete na stránce Odmítnutí odpovědnosti za strojový překlad.

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

Jak nasadit aplikaci UniFi Network prostřednictvím Docker na QNAP NAS?

Datum poslední úpravy: 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

Použitelné produkty

All models supporting Container Station

Situace

Aplikace UniFi Network je software pro správu sítě vyvinutý společností Ubiquiti pro správu síťových zařízení UniFi (přístupové body, přepínače, brány atd.). Mnoho uživatelů chce provozovat aplikaci UniFi Network na svém QNAP NAS pomocí kontejnerů Docker místo vyhrazeného zařízení (jako je Raspberry Pi).

Hlavní výzvy při nasazování UniFi přes Docker na QNAP zahrnují:

Pochopení umístění souboru Docker Compose YAML
Správná konfigurace trvalého Úložiště
Nastavení přístupu k síti se statickou IP pomocí ovladače QNET od QNAP
Zajištění, že kontejner je přístupný z UniFi zařízení v síti

Řešení

Předpoklady

Container Station musí být nainstalován na vašem QNAP NAS
Sdílená složka pro ukládání dat kontejneru UniFi (např. /share/Container)
Znalost síťového rozhraní vašeho NAS (lze zjistit přes SSH pomocí ifconfig)

Postupné nasazení

Krok 1: Najděte název vašeho síťového rozhraní

Povolte SSH na vašem QNAP NAS:
- Přejděte na Ovládací panely > Síťové a souborové služby > Telnet / SSH
- Povolit Povolit připojení SSH
Připojte se přes SSH a spusťte:
```
ifconfig
```
Poznámka: název vaší síťové karty (např. eth0, br0 nebo adaptér připojený k cílové síti)

Krok 2: Vytvořte soubor Docker Compose YAML

Vytvořte soubor s názvem docker-compose.yml s následujícím obsahem:

Šablona s proměnnými:

verze: "3.8"

služby:
  unifi:
    image: jacobalberty/unifi:latest
    container_name: unifi-controller
    restart: unless-stopped

    sítě:
      qnet-network:
        ipv4_address: ${QNET_STATIC_IP}

    prostředí:
      TZ: ${TZ}

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

sítě:
  qnet-network:
    driver_opts:
      iface: ${QNET_INTERFACE}
    driver: qnet
    ipam:
      driver: qnet
      options:
        iface: ${QNET_INTERFACE}
      config:
        - subnet: ${QNET_SUBNET}
          gateway: ${QNET_GATEWAY}

Příklad s reálnými hodnotami:

verze: "3.8"

služby:
  unifi:
    image: jacobalberty/unifi:latest
    container_name: unifi-controller
    restart: unless-stopped

    sítě:
      qnet-network:
        ipv4_address: 10.8.32.26

    prostředí:
      TZ: Asia/Taipei

    svazky:
      - /share/Container/unifi:/unifi

sítě:
  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

Krok 3: Referenční proměnné

Proměnná	Popis	Příklad
`${QNET_STATIC_IP}`	Statická IP adresa pro kontejner	`10.8.32.26`
`${TZ}`	Časové pásmo pro kontejner	`Asia/Taipei`
`${SHARE_FOLDER}`	Cesta k vaší sdílené složce	`/share/Container`
`${QNET_INTERFACE}`	Síťové rozhraní z Kroku 1	`br0`
`${QNET_SUBNET}`	Vaše síťová podsíť v notaci CIDR	`10.8.32.0/24`
`${QNET_GATEWAY}`	IP adresa vaší síťové brány	`10.8.32.1`

Krok 4: Nasazení kontejneru

Otevřete Container Station na vašem QNAP NAS
Přejděte na Prozkoumat rozbalovací nabídku a vyberte Vytvořit aplikaci
Pojmenujte svou aplikaci (např. unifina-1) a vložte obsah souboru docker-compose.yaml, který jsme právě vyplnili skutečnými hodnotami.
Klikněte na tlačítko Ověřit pro ověření kódů YAML.
Vložte svůj obsah YAML nebo impo
Klikněte na Vytvořit pro nasazení
Jakmile je to hotovo, kontejner je spuštěn.

Důležité poznámky

Prohlášení o aplikaci třetí strany

Obraz jacobalberty/unifi Docker je aplikace třetí strany, nikoli oficiální produkt QNAP. Vezměte prosím na vědomí:

Zálohování dat: Pravidelně zálohujte adresář /share/Container/unifi
Stabilita: Výkon závisí na aktualizacích správce obrazu Docker
Podpora: Pro problémy specifické pro UniFi konzultujte Dokumentace k obrazu Docker nebo fóra komunity Ubiquiti

Byl tento článek užitečný?

Ano. Ne.

100% lidí si myslí, že to pomáhá.

Pro další pomoc se zeptejte ostatních uživatelů a odborníků QNAP v komunitě. Přejít do komunity QNAP

Sdělte nám prosím, jak lze tento článek vylepšit:

Článek postrádá důležité informace
Řešení v článku nefungují
Článek je příliš složitý
Článek obsahuje nesprávné informace
Článek je zastaralý

Pokud chcete poskytnout další zpětnou vazbu, uveďte ji níže.