Verbindung eines UniFi Geräts mit dem UniFi Cloud Controller
In diesem Artikel erfahren Sie, wie Sie ein UniFi Gerät – beispielsweise einen Access Point oder Switch – mit dem UniFi Cloud Controller verbinden. Dabei konzentrieren wir uns auf die für den Betrieb erforderlichen externen Ports und erläutern, wie Sie den Controller mittels DNS-Eintrag noch komfortabler in Ihr Netzwerk integrieren können.
Kunden mit einem Firewall Abonnement können sich bei uns melden und den Cloud Controller für bis zu 5 Geräte kostenlos verwenden.
Voraussetzungen
Damit Ihre UniFi Geräte den UniFi Cloud Controller erreichen können, müssen in Ihrer Firewall folgende Ports für die ausgehende Kommunikation geöffnet sein:
- TCP Port 8080: Für Management-Aufgaben und Adoption (das Setzen des Controller-Parameters über den set-inform-Befehl).
- UDP Port 3478: Für das STUN-Protokoll, das der Datensammlung und der Ermittlung der öffentlichen IP-Adresse dient.
- TCP Port 8443: Für den Zugriff auf das Web-Interface des Controllers und die Remote-Verwaltung. (Optional)
Stellen Sie sicher, dass diese Ports in Ihrer Firewall freigegeben sind, damit eine reibungslose Kommunikation zwischen Ihren UniFi Geräten und dem Controller gewährleistet ist.
L3-Adoption via DNS
Die UniFi Geräte versuchen standardmässig den Namen „unifi“ aufzulösen und sich mit diesem Controller zu verbinden. Wenn man nun auf dem DNS den Namen hinterlegt und auf die IP oder den DNS-Namen des Cloud Controllers auflösen lässt, melden sich neue Geräte automatisch bei diesem zur Adoption.
Bei einer Sophos Firewall würde die Einstellung z. B. so aussehen. Voraussetzung ist hier natürlich, dass die Sophos Firewall als DNS-Server verwendet wird.

L3-Adoption via CLI
Für die Einrichtung des UniFi Geräts per CLI kann man folgende Schritte durchführen. Zuerst muss der UniFi Switch oder Access Point im Netzwerk gestartet werden und eine IP-Adresse erhalten.
- SSH-Verbindung zum Gerät herstellen:
Öffnen Sie ein Terminal und verbinden Sie sich per SSH:
ssh ubnt@
Hinweis: Das Standardpasswort lautet ubnt. Sollte dies nicht funktionieren, hilft nur ein Reset des Geräts. Nach der erfolgreichen Adoption mit dem Controller wird das Passwort automatisch geändert.
- UniFi Controller definieren:
Nach erfolgreichem Login geben Sie den entsprechenden set-inform-Befehl ein, damit das Gerät weiss, bei welchem Controller es sich melden muss.
set-inform http://:8080/inform
Danach meldet sich das Gerät ohne Neustart innerhalb weniger Sekunden am UniFi Controller. Wenn Sie die Mobile App verwenden, erhalten Sie eine Push-Benachrichtigung, dass ein neues Gerät zur Adoption bereit ist.
Nützliche SSH Commands
Wenn man sich mit dem UniFi Switch oder Access Point per SSH verbindet, gibt es noch einige nützliche Befehle fürs Troubleshooting:
Mit dem Befehl können Sie detaillierte Informationen des Geräts abrufen:
info
Sollte ein Gerät neu konfiguriert werden müssen, können Sie mit diesem Befehl die Werkseinstellungen wiederherstellen:
set-default
Wenn die Standardeinstellung des Controllers wie im Auslieferungszustand verwendet werden soll:
set-inform http://unifi:8080/inform
UniFi Device Reset
Manchmal ist es einfacher, das Gerät auf die Werkseinstellungen zurückzusetzen.
- Neustart: Drücken Sie die Reset-Taste am Gerät kurz und lassen Sie sie wieder los.
- Werkseinstellungen wiederherstellen: Halten Sie die Reset-Taste länger als fünf Sekunden gedrückt, bis die LED erlischt.