UniFi Switch Ports manuell per SSH und CLI verwalten

Einleitung

Normalerweise werden UniFi-Switches bequem über den zentralen Controller konfiguriert. Es gibt jedoch Situationen – etwa bei der Fehlersuche, wenn der Controller offline ist oder um einen «bocking» Port schnell zurückzusetzen –, in denen der direkte Weg über die Kommandozeile (SSH) schneller und effektiver ist.

Dieses Tutorial zeigt, wie Sie sich direkt auf die Hardware verbinden und Ports mittels CLI (Command Line Interface) steuern. Die Befehlsstruktur ähnelt dabei stark der klassischen Cisco IOS Syntax.

Voraussetzungen:

• SSH-Zugriff auf den Switch (IP-Adresse bekannt)
• SSH-Zugangsdaten (zu finden im Controller unter «Settings» > «System» > «Advanced» > «Device Authentication»)
• Terminal-Programm (Terminal, PuTTY, PowerShell)

[BILD 1: Nahaufnahme eines UniFi Switches im Rack mit eingesteckten Patchkabeln]

Schritt-für-Schritt Anleitung

1. Verbindung herstellen
   Öffnen Sie Ihr Terminal. Ersetzen Sie richard durch Ihren SSH-Benutzernamen und die IP durch die Adresse Ihres Switches.
   
   ssh richard@192.168.1.X
2. In den Konfigurationsmodus wechseln
   Nach dem Login befinden Sie sich oft in einer einfachen Linux-Shell (BusyBox). Um die Switch-Befehle nutzen zu können, müssen wir die CLI-Umgebung laden und privilegierte Rechte anfordern.
   
   Befehlsabfolge:
   cli enable config
   Hinweis: Bei manchen älteren Modellen lautet der erste Befehl telnet 127.0.0.1 statt cli.
3. Port auswählen und konfigurieren
   Wählen Sie das Interface (den Port), den Sie bearbeiten möchten. Die Zählung erfolgt meist im Format 0/X (z. B. Port 5 ist 0/5).
   
   interface 0/5
   Nun können Sie Aktionen für diesen Port ausführen:
   
   Port ausschalten (Deaktivieren):
   shutdown
   Port einschalten (Aktivieren):
   no shutdown
4. Status prüfen (Optional)
   Um zu sehen, ob die Änderung gegriffen hat oder wie der PoE-Status ist, nutzen Sie folgende Befehle (dazu ggf. erst mit exit aus dem Interface-Modus raus):
   
   show port all show poe status all
   [BILD 2: Terminal-Screenshot mit der tabellarischen Ausgabe von «show port all»]
5. Speichern und Beenden
   Damit die Änderungen einen Neustart des Switches überleben, müssen sie in den Speicher geschrieben werden.
   
   write memory exit exit

Wichtige Hinweise & Stolperfallen

Die «Provisioning»-Falle: Änderungen, die Sie per SSH vornehmen, sind persistent im Switch gespeichert (durch write memory), aber nicht im UniFi Controller bekannt. Sobald der Controller das nächste Mal Einstellungen an den Switch sendet («Provisioning»), werden Ihre manuellen SSH-Änderungen überschrieben! Nutzen Sie SSH daher primär für Debugging oder Notfälle.

Port-Zählung: Beachten Sie, dass SFP-Ports oft separat nummeriert sind oder höhere Nummern haben. Nutzen Sie show port all, um die korrekte ID zu finden, bevor Sie Befehle absetzen.

Ergebnis & Fazit

Sie haben erfolgreich einen Switch-Port ohne grafische Oberfläche konfiguriert. Diese Methode ist besonders wertvoll für IT-Administratoren, die aus der Cisco-Welt kommen oder Skripte zur Automatisierung nutzen möchten.