Przejdź do głównej zawartości

Instalacja i konfiguracja Unifi Network Application

Cel​

Po wykonaniu kroków na VM unifi01 (Ubuntu 24.04 LTS) działa Unifi Network Application; panel webowy jest dostępny pod adresem https://unifi01.cyfra.local:8443; aplikacja jest gotowa do adopcji punktów dostępowych AP01/AP02/AP03.

Wymagania wstępne​

  • VM unifi01 z Ubuntu 24.04 Server, IP 192.168.50.5/24, dostęp SSH
  • Wpis DNS unifi01.cyfra.local → 192.168.50.5 dodany na gw01 (A-02)
  • Otwarte porty w sieci (brak dodatkowej blokady na poziomie routera):
PortProtokółUsługa
8443TCPPanel webowy Unifi (HTTPS)
8080TCPKomunikacja AP → kontroler (HTTP)
3478UDPSTUN (AP discovery)
10001UDPUnifi device discovery

Parametry maszyny​

ParametrWartość
Hostnameunifi01
IP192.168.50.5/24 (statyczne)
OSUbuntu 24.04 LTS Server
Login SSHcyfra / Cyfra@Unifi2026
Login paneladmin / Cyfra@Unifi2026!
Panel URLhttps://unifi01.cyfra.local:8443

Kroki​

1. Konfiguracja statycznego IP (netplan)​

sudo nano /etc/netplan/01-lan.yaml
network:
  version: 2
  ethernets:
    enp0s3:
      addresses:
        - 192.168.50.5/24
      routes:
        - to: default
          via: 192.168.50.1
      nameservers:
        addresses: [192.168.50.1, 8.8.8.8]
sudo netplan apply

2. Aktualizacja systemu i instalacja zależności​

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl gnupg ca-certificates apt-transport-https

3. Dodanie repozytorium Ubiquiti i instalacja Unifi​

curl -fsSL https://dl.ui.com/unifi/debian/unifi-repo.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/unifi.gpg

echo "deb [signed-by=/usr/share/keyrings/unifi.gpg] \
  https://www.ui.com/downloads/unifi/debian stable ubiquiti" \
  | sudo tee /etc/apt/sources.list.d/unifi.list

sudo apt update && sudo apt install -y unifi

4. Uruchomienie i włączenie usługi​

sudo systemctl enable --now unifi
sudo systemctl status unifi

Oczekiwany status: active (running).

Sprawdzenie logów (jeśli usługa nie startuje):

sudo journalctl -u unifi -n 50

5. Pierwsza konfiguracja przez panel webowy​

  1. Otwórz w przeglądarce: https://192.168.50.5:8443 (akceptuj ostrzeżenie o self-signed certyfikacie)
  2. Postępuj zgodnie z kreatorem konfiguracji:
    • Region: Europe / Poland
    • Nazwa sieci (Site): Cyfra
    • Konto administratora: login admin, hasło Cyfra@Unifi2026!
  3. Pomiń ekran konfiguracji urządzeń Ubiquiti cloud – wybierz Advanced Setup

6. Dodanie statycznego wpisu DNS na gw01​

Zaloguj się na gw01 i dodaj wpis DNS:

/ip dns static add name=unifi01.cyfra.local address=192.168.50.5

Panel będzie dostępny pod nazwą: https://unifi01.cyfra.local:8443

7. Snapshot​

W VirtualBox utwórz snapshot: „UNIFI01-BAZOWY"

Weryfikacja​

# Status usługi
sudo systemctl status unifi

# Sprawdzenie, czy port 8443 nasłuchuje
ss -tlnp | grep 8443

Z dowolnej VM w sieci:

# Dostępność kontrolera
curl -k -s -o /dev/null -w "%{http_code}" https://192.168.50.5:8443
# Oczekiwany wynik: 200 lub 302

Typowe błędy i rozwiązania​

ObjawPrzyczynaRozwiązanie
Usługa unifi nie startujeBrak Java lub niekompatybilna wersja MongoDBSprawdź logi: sudo journalctl -u unifi -n 100; Unifi wymaga Java 17 (instaluje się automatycznie z pakietem)
Port 8443 niedostępnyufw blokuje portsudo ufw allow 8443/tcp && sudo ufw allow 8080/tcp
Błąd SSL w przeglądarceSelf-signed certyfikatNormalny objaw – dodaj wyjątek w przeglądarce lub zaimportuj certyfikat CA
AP nie widzi kontroleraBrak wpisów DNS lub blokada portu 8080Sprawdź DNS na gw01 (/ip dns static print) i dostępność portu unifi01:8080
Panel ładuje się wolnoNiewystarczające zasoby VMZwiększ RAM do 3–4 GB; Unifi wymaga minimum 2 GB

Powiązane artykuły​