Mit dem UniFi OS Server läuft die UniFi-Verwaltung auf einem eigenen Linux-Server oder einer VM, z. B. bei einem Cloud-Anbieter. Damit lassen sich UniFi-Geräte an mehreren Standorten zentral verwalten, ohne Cloud Key oder Gateway.
1. Installation
Der UniFi OS Server läuft in Containern mit Podman. Auf Debian bzw. Ubuntu:
sudo apt update && sudo apt install podman slirp4netns
Den Installer für die passende Architektur (x64 oder ARM64) von der UniFi-Downloadseite (Bereich Software → UniFi OS Server) herunterladen, ausführbar machen und starten:
curl -O <Download-Link des Installers>
chmod +x <Installer-Datei>
sudo ./<Installer-Datei> install
Der genaue Ablauf steht im Ubiquiti Help Center unter „Self-Hosting UniFi“. Nach der Installation ist die Oberfläche unter https://<Server>:11443 erreichbar.
2. Ports
Welche Ports der Container tatsächlich öffnet, zeigt:
sudo ss -tulpn | grep slirp4netns
Die wichtigsten:
| Port | Protokoll | Zweck |
|---|---|---|
11443 |
TCP | Weboberfläche von UniFi OS |
8443 |
TCP | UniFi Network (Anwendung) |
8080 |
TCP | Inform: Geräte melden sich beim Server |
3478 |
UDP | STUN, für Geräte hinter NAT |
10003 |
UDP | Geräteerkennung im lokalen Netz |
6789 |
TCP | Speedtest der UniFi-App |
8880–8882 |
TCP | Weiterleitung zum Gästeportal |
5514 |
UDP | Syslog der Geräte |
Für Geräte an entfernten Standorten müssen mindestens 8080/TCP und 3478/UDP aus dem Internet erreichbar sein. Die Weboberfläche nach Möglichkeit nur von bekannten IP-Adressen erlauben.
Damit Geräte den Server finden, entweder per SSH set-inform http://<Server>:8080/inform setzen oder die DHCP-Option 43 verwenden.
3. Zertifikat mit Let’s Encrypt
Ein Zertifikat für den Servernamen holen. Im Standalone-Modus braucht certbot dafür kurz Port 80:
sudo apt install certbot
sudo certbot certonly --standalone -d unifi.example.at
Die Dateien liegen danach unter /etc/letsencrypt/live/unifi.example.at/. Zum Hochladen in der Weboberfläche auf den eigenen Rechner kopieren:
scp -r [email protected]:/etc/letsencrypt/live/unifi.example.at/ ~/Documents/cert
In der UniFi-OS-Oberfläche das Zertifikat (fullchain.pem) und den privaten Schlüssel (privkey.pem) als eigenes Zertifikat hinterlegen.
Let’s-Encrypt-Zertifikate laufen nach 90 Tagen ab. certbot erneuert sie automatisch, in UniFi OS muss das neue Zertifikat aber wieder hochgeladen werden.
4. Server aktuell halten
Automatische Sicherheitsupdates für das Betriebssystem aktivieren:
sudo dpkg-reconfigure --priority=low unattended-upgrades