Port-Übersicht, SSH-Befehle und Layer-3-Adoption für alle UniFi-Geräte.
Alle Ports, die für die Kommunikation zwischen UniFi-Geräten und dem Network Controller benötigt werden. Besonders wichtig bei Self-Hosted-Controllern, Drittanbieter-Firewalls und VLAN-übergreifenden Setups.
| Protokoll | Port | Verwendung | Erforderlich |
|---|---|---|---|
| Lokale Kommunikation (Ingress) | |||
| TCP/UDP | 53 | DNS – Guest Portal, Updates, Remote Access | Ja |
| UDP | 3478 | STUN – NAT Traversal für Geräte-Kommunikation | Ja |
| TCP | 8080 | Device Inform – Kommunikation Gerät ↔ Controller | Ja |
| TCP | 443 | Controller GUI / API (Webinterface) | Ja |
| TCP | 8443 | Controller GUI / API (auf UniFi Consoles) | Ja |
| UDP | 10001 | Device Discovery – Erkennung neuer Geräte (L2) | Ja |
| UDP | 1900 | L2-Discovery – „Controller im Netzwerk auffindbar" | Optional |
| TCP | 8880 | HTTP Portal Redirect (Guest Hotspot) | Optional |
| TCP | 8843 | HTTPS Portal Redirect (Guest Hotspot) | Optional |
| TCP | 6789 | UniFi Mobile Speed Test | Optional |
| TCP | 27117 | MongoDB – lokale Datenbank-Kommunikation | Lokal |
| UDP | 5514 | Remote Syslog Capture | Optional |
| UDP | 5656–5699 | AP-EDU Broadcasting (Durchsagen über APs) | Optional |
| UDP | 123 | NTP – Zeitsynchronisation | Ja |
| TCP | 22 | SSH – Zugriff auf Geräte (nicht vom Controller genutzt) | Optional |
| Remote / L3 Management (Ingress) | |||
| UDP | 3478 | STUN – NAT Traversal | Ja |
| TCP | 8080 | Device Inform – Gerät ↔ Controller | Ja |
| TCP | 443 | Controller GUI / API | Ja |
| TCP | 8443 | Controller GUI / API (Console) | Ja |
| TCP | 8880 | HTTP Portal Redirect | Wenn Guest Portal |
| TCP | 8843 | HTTPS Portal Redirect | Wenn Guest Portal |
| TCP | 6789 | Mobile Speed Test | Optional |
| Egress (Ausgehend – Remote Access) | |||
| TCP/UDP | 53 | DNS | Ja |
| UDP | 3478 | STUN | Ja |
| TCP/UDP | 443 | Remote Access Service (ui.com) | Ja |
| TCP | 8883 | Remote Access Service | Ja |
| UDP | 123 | NTP – Zeitsynchronisation | Ja |
Die wichtigsten Befehle für den SSH-Zugriff auf UniFi Access Points, Switches, Gateways und Consoles. Standard-Zugangsdaten bei Werkseinstellung: ubnt / ubnt
Alle Geräte SSH-Verbindung zum Gerät aufbauen.
Alle Geräte Zeigt Modell, Firmware, MAC, IP, Status und Inform-URL.
Alle Geräte Teilt dem Gerät mit, wo sich der Controller befindet. Kernbefehl für Layer-3-Adoption.
AP Switch Gerät auf Werkseinstellungen zurücksetzen.
Alle Geräte Alternativer Befehl, wenn syswrapper.sh nicht funktioniert.
AP Switch Firmware per URL direkt auf das Gerät laden.
AP Wenn upgrade nicht funktioniert – manueller Download und Flash.
Alle Geräte Neustart des Geräts über SSH.
Alle Geräte Lokales Passwort des Geräts ändern (wird beim nächsten Provisioning überschrieben).
Alle Geräte Erreichbarkeit des Controllers prüfen.
Wenn sich der UniFi Controller in einem anderen Subnetz befindet als die Geräte, funktioniert die automatische L2-Discovery nicht. Das Gerät muss manuell per SSH über die Inform-URL an den Controller gebunden werden.
Stelle sicher, dass vom Gerät-Subnetz aus TCP 8080 und UDP 3478 zum Controller-Subnetz offen sind. Bei Firewalls zwischen den VLANs müssen diese Ports explizit erlaubt werden.
Wenn das Gerät zuvor an einem anderen Controller adoptiert war, muss es zuerst zurückgesetzt werden.
Nach dem Reset verbindet man sich erneut per SSH (Standard: ubnt / ubnt) und setzt die Inform-URL:
Wichtig: Immer http:// und Port 8080 verwenden – nicht HTTPS und nicht Port 8443!
Das Gerät erscheint im Controller als „Pending Adoption". Klicke auf Adopt. Das Gerät wechselt dann zu „Adopting" → „Provisioning" → „Connected".
Tipp: Falls das Gerät nach dem Adopt wieder verschwindet, den set-inform-Befehl ein zweites Mal ausführen – das ist normal und bei L3-Adoption oft nötig.
Per SSH den aktuellen Status des Geräts überprüfen:
Bei Status: Connected ist alles in Ordnung. Bei Status: Timeout oder Server Reject → Firewall-Regeln und URL nochmals prüfen.
Der DHCP-Server kann den Geräten automatisch die Controller-IP mitteilen. Bei UniFi Gateways unter Network Settings → DHCP → Option 43 konfigurierbar.
UniFi-Geräte suchen automatisch nach dem DNS-Namen unifi. Ein A-Record, der auf die Controller-IP zeigt, ermöglicht automatische Adoption.
Neuere Geräte (z.B. U7 Pro Max) unterstützen ZTP über die Ubiquiti Cloud – Adoption ohne lokalen Zugriff. Wird sukzessive für weitere Geräte ausgerollt.