FAQ Jak wdrożyć UniFi Network Application przez Docker na QNAP NAS?

[QNAP]

Odpowiednie produkty

• Wszystkie modele obsługujące Container Station

---

Tło
UniFi Network Application to oprogramowanie do zarządzania siecią, opracowane przez Ubiquiti do zarządzania urządzeniami sieciowymi UniFi (punktami dostępowymi, przełącznikami, bramami itp.). Wielu użytkowników chce uruchomić UniFi Network Application na swoim QNAP NAS za pomocą kontenerów Docker, zamiast dedykować oddzielne urządzenie (takie jak Raspberry Pi).

Główne wyzwania podczas wdrażania UniFi za pośrednictwem Docker na QNAP obejmują:

• Zrozumienie umiejscowienia pliku Docker Compose YAML
• Prawidłowa konfiguracja trwałego przechowywania danych
• Konfiguracja dostępu do sieci ze statycznym adresem IP przy użyciu sterownika QNET firmy QNAP
• Zapewnienie dostępu do kontenera z urządzeń UniFi w sieci

---

Rozwiązanie

Wymagania wstępne

1. Container Station musi być zainstalowany na Twoim QNAP NAS
2. Udostępniony folder do przechowywania danych kontenera UniFi (np. `/share/Container`)
3. Znajomość interfejsu sieciowego Twojego NAS (można znaleźć za pośrednictwem FAQ SSH za pomocą `ifconfig`)

Wdrażanie krok po kroku

Krok 1: Znajdź nazwę swojego interfejsu sieciowego

1. Włącz FAQ SSH na swoim QNAP NAS:
   • Przejdź do Control Panel > Network & File Services > Telnet / FAQ SSH
   • Włącz Allow FAQ SSH connection
2. Połącz się przez FAQ SSH i uruchom:
   

   ifconfig

3. Zanotuj nazwę swojego interfejsu sieciowego (np. `eth0`, `br0` lub adapter podłączony do Twojej docelowej sieci)

Krok 2: Utwórz plik Docker Compose YAML
Utwórz plik o nazwie `docker-compose.yml` z następującą zawartością:

Szablon ze zmiennymi:

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}

Plain textCopyPrzykład z rzeczywistymi wartościami:

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

Plain textCopy
Krok 3: Odniesienie do zmiennych

Zmienna | Opis | Przykład
`${QNET_STATIC_IP}` | Statyczny adres IP dla kontenera | `10.8.32.26`
`${TZ}` | Strefa czasowa dla kontenera | `Asia/Taipei`
`${SHARE_FOLDER}` | Ścieżka do Twojego udostępnionego folderu | `/share/Container`
`${QNET_INTERFACE}` | Interfejs sieciowy z Kroku 1 | `br0`
`${QNET_SUBNET}` | Twoja podsieć sieciowa w notacji CIDR | `10.8.32.0/24`
`${QNET_GATEWAY}` | Adres IP Twojej bramy sieciowej | `10.8.32.1`

Krok 4: Wdróż kontener

1. Otwórz Container Station na swoim QNAP NAS
2. Przejdź do menu rozwijanego Explore i wybierz Create Application
   
   
   
3. Nazwij swoją aplikację (np. unifina-1) i wklej zawartość pliku docker-compose.yaml, który właśnie wypełniliśmy rzeczywistymi wartościami.
4. Kliknij przycisk Validate, aby zweryfikować kody YAML.
   
   
   
5. Wklej zawartość YAML lub impo
6. Kliknij Create, aby wdrożyć
7. Po zakończeniu kontener jest uruchomiony i działa.
   
   
   

---

Ważne uwagi
Zastrzeżenie dotyczące aplikacji innych firmObraz Docker `jacobalberty/unifi` jest aplikacją innej firmy, a nie oficjalnym produktem QNAP. Proszę zauważyć:

• Kopia zapasowa danych: Regularnie twórz kopie zapasowe katalogu `/share/Container/unifi`
• Stabilność: Wydajność zależy od aktualizacji dostarczanych przez opiekuna obrazu Docker
• Wsparcie: W przypadku problemów specyficznych dla UniFi, skonsultuj się z dokumentacją obrazu Docker lub forami społeczności Ubiquiti