imported>TechCorner-Redaktion: Neuer Artikel: LED-Status, Geräte offline, Schleifen, WLAN, Internet, VPN, DNS, Support-Dateien

2026-10-16T00:00:00Z

Neuer Artikel: LED-Status, Geräte offline, Schleifen, WLAN, Internet, VPN, DNS, Support-Dateien

Neue Seite

{{Steckbrief
| gilt_fuer = 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.

[[Datei:UniFi-Fehlersuche.png|thumb|center|750px|Fehlersuche in UniFi von unten nach oben: Strom und Kabel (LED, PoE), IP-Adresse und VLAN (Fallback-Adresse 192.168.1.20, Schleifen, fremder DHCP-Server), Verbindung zur Verwaltung (TCP 8080), Konfiguration und Firmware; daneben die wichtigsten LED-Zustände – weiß dauerhaft: bereit zur Adoption, blau dauerhaft: in Betrieb, blau mit Blinken alle 5 s: keine Netzverbindung, weiß/blau schnell: Update.]]

== 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 ==
{| class="wikitable"
! 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 ==
{| class="wikitable"
! 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 ==
* <code>nslookup</code> gegen 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 ==
{| class="wikitable"
! 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: <code>http://unifi/</code> 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 [https://www.max-it.de/it-services/managed-services/ 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 ==
* [https://help.ui.com/hc/en-us/articles/7258465146519-Troubleshooting-UniFi-Device-Connectivity Ubiquiti Help Center: Troubleshooting UniFi Device Connectivity]
* [https://www.max-it.de/it-services/managed-services/ Managed Services von m.a.x. it]

{{Uebermax}}
[[Kategorie:Netzwerk-Hardware]]

UniFi: Fehlersuche-Leitfaden - Versionsgeschichte

imported>TechCorner-Redaktion: Neuer Artikel: LED-Status, Geräte offline, Schleifen, WLAN, Internet, VPN, DNS, Support-Dateien