UniFi: Fehlersuche-Leitfaden
Auf einen Blick
| Gilt für | UniFi Cloud Gateways, Switches und Access Points mit UniFi Network 10.x |
|---|---|
| Bereich | Netzwerk-Hardware |
| Dauer | je nach Fehler 5 Minuten bis einige Stunden |
| Rechte | Administrator in UniFi Network, Zugang zu den Geräten |
| Stand | Oktober 2026 |
Die Fehlersuche in UniFi-Netzen folgt immer demselben Prinzip: von unten nach oben – erst Strom und Kabel, dann IP-Adresse und VLAN, dann Verbindung zur Verwaltung, zuletzt Konfiguration und Software. Dieser Leitfaden fasst die häufigsten Störungen in UniFi-Netzen zusammen – Geräte offline, WLAN-Probleme, kein Internet, VPN- und DNS-Fehler, Netzwerkschleifen – und zeigt für jede die Prüfschritte in sinnvoller Reihenfolge, die Bedeutung der LED-Anzeigen und wie man Support-Dateien für den Hersteller erstellt.
Grundregeln
- Was hat sich geändert? Die meisten Störungen folgen einer Änderung: neuer Switch, umgesteckte Kabel, geänderte Port-Profile, neues VLAN, Update. Das Änderungsprotokoll und das Log Admin Made Config Changes zuerst ansehen.
- Eine Ebene nach der anderen. Nicht gleichzeitig Kabel tauschen, Einstellungen ändern und Geräte zurücksetzen.
- Werksreset ist das letzte Mittel, nicht das erste – danach fehlen Hinweise auf die Ursache.
LED-Anzeigen von Switches und Access Points
| LED | Bedeutung | nächster Schritt |
|---|---|---|
| aus | kein Strom | Kabel, PoE-Port, Netzteil prüfen |
| weiß blinkend (halbe Sekunde) | startet | warten |
| weiß dauerhaft | Werkszustand, bereit zur Adoption | adoptieren |
| blau dauerhaft | adoptiert, in Betrieb | – |
| blau, alle 5 s kurz aus | keine Netzverbindung, AP sucht Funk-Uplink | Kabel, VLAN, IP-Adresse prüfen |
| weiß/blau schnell wechselnd | Firmware-Update läuft | nicht unterbrechen |
| blau schnell blinkend | Locate aus UniFi Network aktiv | – |
| weiß-blau-aus im Wechsel | TFTP-Wiederherstellungsmodus | Reset-Taste klemmt? sonst Recovery |
| weiß/aus flackernd | Fehlerzustand | Strom trennen und neu starten, sonst Support |
Switch-Displays können nach einem Update einige Minuten dunkel bleiben.
Fall 1: Gerät ist „Offline“
- Strom und Kabel: LED oder Display an? Kabel tauschen, anderen Port bzw. anderes PoE-Netzteil probieren. Beschädigte Kabel sind eine der häufigsten Ursachen.
- Hat das Gerät eine IP-Adresse?
- in UniFi Network unter Settings › Networks › IP Leases des Netzes,
- mit der WiFiman-App im Tab Discovery,
- oder ein Notebook an dasselbe Kabel stecken und prüfen, ob es eine Adresse bekommt (nicht 169.254.x.x).
- Keine Adresse oder 192.168.1.20 (Ausweichadresse der UniFi-Geräte): VLAN-Konfiguration der Ports auf dem Weg zum Gateway und Network Override prüfen, nach Netzwerkschleifen suchen, siehe UniFi: VLANs einrichten.
- Unerwartete Adresse (falsches Netz): Es gibt vermutlich einen fremden DHCP-Server im Netz – DHCP Guarding prüfen.
- Richtige Adresse: Erreichen sich Gerät und UniFi Network über TCP 8080? Firewalls, Virenscanner auf selbst gehosteten Servern und Layer-3-Adoption prüfen, siehe UniFi: Geräte adoptieren und zurücksetzen.
- AP „Isolated“: Der AP hat die Verbindung zur Verwaltung verloren, ein anderer AP sieht ihn noch. Clients arbeiten mit der letzten Konfiguration weiter. Letzte Änderungen an Ports, Netzen und Firewall zurücknehmen.
- Erst wenn alles andere scheitert: Gerät zurücksetzen und neu adoptieren.
Fall 2: Viele Geräte gleichzeitig gestört
Typisch für eine Netzwerkschleife oder einen Broadcast-Sturm: Geräte gehen reihenweise offline, das Netz wird langsam, LEDs blinken dauerhaft.
- Unter Ports nach blockierten Ports und auffälligem Broadcast-Verkehr suchen.
- Zuletzt gesteckte Kabel, neue Switches, Mesh-Verbindungen und Sonos-Geräte prüfen.
- Notfalls vom Netzrand her Verbindungen trennen, bis sich das Netz beruhigt.
Details und Vorbeugung: UniFi: Spanning Tree und Loop-Schutz.
Fall 3: WLAN-Probleme
| Symptom | Prüfen |
|---|---|
| Gerät kommt nicht ins WLAN | Passwort; bei Enterprise RADIUS-Server erreichbar?; Signal besser als −70 dBm?; VLAN der SSID auf allen Ports bis zum Gateway getaggt?; AP-Firmware und Client-Treiber aktuell? |
| Altgerät/IoT verbindet nicht | eigene SSID mit WPA2, nur 2,4 GHz, ohne Fast Roaming, BSS Transition, MLO, Band Steering, PMF |
| langsam, Abbrüche | Signalstärke, Funkauslastung (Radios › AirView), Störungen durch Nachbarnetze, Multicast-Last, zu viele Clients an einem AP |
| Roaming klappt nicht | überlappende Abdeckung zwischen APs (−65 bis −70 dBm am Rand), Fast Roaming und BSS Transition |
Werkzeuge und Messverfahren beschreibt UniFi: WLAN messen mit WiFiman und WiFi Agent, die Einstellungen UniFi: WLAN einrichten und optimieren.
Fall 4: Kein Internet
- Dashboard: WAN-Status und ISP-Werte (Latenz, Paketverlust) ansehen; im Log WAN Failover oder Packet Loss Detected suchen.
- Liegt eine öffentliche oder eine private WAN-Adresse an? Bei PPPoE Zugangsdaten und VLAN-ID prüfen.
- Erreicht das Gateway das Internet, die Clients aber nicht: DNS prüfen (siehe Fall 6), Firewall-Richtlinien und Policy-Based Routes mit Kill Switch kontrollieren.
- Nur einzelne Netze betroffen: Netzeinstellungen, Inhaltsfilter und Richtlinien dieses Netzes prüfen.
Fall 5: VPN-Probleme
- Client-VPN baut nicht auf: öffentliche IP am Gateway oder Portweiterleitung am vorgelagerten Router; UDP blockiert (Hotel-WLAN)? DynDNS-Name aktuell?
- Verbunden, aber kein Zugriff: Firewall-Zone VPN, DNS-Server in der VPN-Konfiguration, Überschneidung mit dem Heimnetz des Benutzers.
- Site-to-Site: Parameter beider Seiten vergleichen; hinter NAT Authentication ID; immer von Client zu Client testen; bei SD-WAN fehlende Routen durch blockiertes OSPF.
Siehe UniFi: VPN für den Fernzugriff einrichten und UniFi: Standorte per Site-to-Site-VPN verbinden.
Fall 6: DNS-Probleme
nslookupgegen das Gateway und gegen einen öffentlichen Server vergleichen.- UDP 53 darf weder vom Gateway noch vom Provider blockiert sein; als Upstream zuverlässige Server wie 1.1.1.1 verwenden.
- Interne Namen nicht auflösbar: Inhaltsfilter leitet DNS zum Gateway um – Forward-Domain-Regel für die AD-Domäne anlegen, siehe UniFi: DNS-Einträge und lokale Hostnamen.
- Updates und Fernzugriff gestört: Das Gateway muss ui.com-Namen auflösen können; keine internen DNS-Server als Upstream eintragen.
Fall 7: Updates schlagen fehl
Internetzugang, DNS und UDP 123 (Zeit) prüfen; bei Netzen ohne Internet den Update Cache nutzen, siehe UniFi: Updates und Firmware verwalten.
Support-Dateien für den Hersteller
| Gerät | Weg |
|---|---|
| Konsole (Cloud Gateway, CloudKey) | Site Manager › Management › Support File › Download |
| Switch, AP, Gateway-Gerät | UniFi Network › Gerät › Settings › Manage › Generate Support File |
| ausführlichere Geräte-Logs | auf Anfrage des Supports: Settings › CyberSecure › Traffic Logging › Activity Logging (Syslog) › Internally Stored |
Support-Dateien enthalten detaillierte Informationen über das Netz. Sie werden zwar teilweise bereinigt, gehören aber nicht in öffentliche Foren.
Notizen für den Ernstfall
- Lokaler Zugang ohne Internet:
http://unifi/oder IP-Adresse des Gateways; Zugangsdaten im Passwort-Tresor. - Konsolen-SSH ist ab Werk aus; Geräte-SSH-Zugangsdaten stehen in UniFi Network und sollten zusätzlich im Tresor liegen.
- Backups (Cloud und offline) und eine aktuelle Port- und Adressdokumentation sparen im Störungsfall die meiste Zeit.
- Bei Störungen, Ursachenanalyse und Rufbereitschaft für Ihr UniFi-Netz unterstützen Sie die Managed Services von m.a.x. it.
Siehe auch
- Ubiquiti UniFi – Überblick und alle Artikel der Reihe
- UniFi: WLAN messen mit WiFiman und WiFi Agent
- UniFi: Geräte adoptieren und zurücksetzen
- UniFi: Syslog, SIEM und SNMP anbinden
Links und Quellen
Über m.a.x. it Die m.a.x. Informationstechnologie AG ist seit über 30 Jahren IT-Partner mittelständischer und großer Unternehmen in München und bietet maßgeschneiderte Lösungen und Services in den Bereichen Cloud, Cybersecurity, Netzwerk, Windows, Linux und Softwareentwicklung. Sie haben eine Frage zu diesem Artikel oder brauchen Unterstützung?
