FRITZ!Box Netzwerk/Fehlerbehebung
Bei jedem Problem helfen zwei Dinge: der Diagnose-Download (Einstellungen → Geräte & Dienste → FRITZ!Box Netzwerk → ⋮ → Diagnose herunterladen) und das Debug-Protokoll (Stufe debug für custom_components.fritzbox_netzwerk). Beides gehört in ein GitHub-Issue.
Home Assistant verlangt wiederholt „Neu authentifizieren“.[Bearbeiten]
Seit 1.7.1 wird die erneute Anmeldung erst nach drei abgelehnten Anmeldungen in Folge verlangt. Tritt es trotzdem auf, prüfe in der Box unter System → Ereignisse, ob zur selben Zeit Anmeldungen fehlschlugen, und verwende ein eigenes Konto nur für die Integration.
Einrichtung: „Das Konto hat keinen Zugriff auf die FRITZ!Box-Einstellungen“.[Bearbeiten]
Beim Konto unter System → FRITZ!Box-Benutzer die Berechtigung FRITZ!Box Einstellungen setzen.
Einrichtung: Der Dienst „Hosts“ fehle.[Bearbeiten]
Unter Heimnetz → Netzwerk → Netzwerkeinstellungen Zugriff für Anwendungen zulassen aktivieren.
Einrichtung: „Unknown error“ trotz richtiger Daten.[Bearbeiten]
Bis 1.6.1 scheiterte die Einrichtung an Modellen, die die Seriennummer-Abfrage mit HTTP 401 ablehnen (beobachtet: FRITZ!Box 5690 Pro). Seit 1.6.2 wird der Fehler abgefangen.
HACS zeigt neue Versionen erst nach „Informationen aktualisieren“.[Bearbeiten]
Das entscheidet HACS. Beim Repository ⋮ → Informationen aktualisieren bzw. Erneut herunterladen. Unabhängig davon zeigt die Integration selbst eine neue Version an.
HACS meldet „Repository structure … is not compliant“.[Bearbeiten]
Das Repository wurde als Dashboard statt als Integration hinzugefügt. Eintrag entfernen, als Integration neu hinzufügen und eine versehentlich angelegte Dashboard-Ressource (/hacsfiles/fritzbox_netzwerk/…) löschen.
Die Karte wird nicht gefunden („Custom element doesn't exist“).[Bearbeiten]
1) Browser hart neu laden (Strg/Cmd+Shift+R), in der Companion-App den Zwischenspeicher leeren. 2) Unter Einstellungen → Dashboards → ⋮ → Ressourcen prüfen, ob /fritzbox_netzwerk/fritzbox-netzwerk-card.js (JavaScript-Modul) eingetragen ist. 3) Sonst manuell hinzufügen und neu laden. Im YAML-Dashboard-Modus den Eintrag in der lovelace:-Konfiguration ergänzen.
Die Karte zeigt „Keine Geräte gefunden“.[Bearbeiten]
Ist der richtige Sensor gewählt (sensor.<name>_gerate mit dem Attribut hosts)? Ist ein Filter oder Suchbegriff aktiv, der nichts trifft? Ist der Sensor „nicht verfügbar“, liegt es an der Integration – Protokoll prüfen.
Offline-Geräte fehlen in der Liste (Issue #24).[Bearbeiten]
Prüfe „Getrennte Geräte ausblenden“ und den Standardfilter der Karte. Bis 1.9.1 leerte die Einstellung auch die Ansichten „Inaktiv“ und „Lange offline“; seit 2.0.0 nicht mehr (mögliche Ursache, nicht bei jedem Melder bestätigt). Der Diagnose-Download nennt unter box_hosts raw_total, raw_active und raw_without_mac.
Die Spalte „Home Assistant“ bleibt leer.[Bearbeiten]
Zugeordnet wird ausschließlich über die MAC-Adresse in der Geräteregistrierung. Viele Integrationen hinterlegen dort keine MAC.
Ein Klick auf die MAC-Adresse kopiert nichts.[Bearbeiten]
Die moderne Zwischenablage braucht HTTPS oder localhost. Alternativ im Popup markieren und mit Strg+C kopieren; nach einem Update Strg+F5.
Die Spalte *Funkband* zeigt nur „—“.[Bearbeiten]
Prüfen: (1) WLAN-Band je Gerät erfassen an? (2) Gerät direkt per WLAN an der Box (LAN, Offline und ungeprüft Repeater-Geräte bekommen keine Angabe)? (3) Debug-Protokoll: „WLAN-Band … nicht ermittelbar“.
Die Spalte „IP-Typ“ zeigt nur „—“ oder „fest“ für DHCP-Geräte.[Bearbeiten]
„—“: Erfassung ausgeschaltet oder seit dem Start noch nicht gelaufen. Seit 1.5.3 gilt dynamisch, wenn die Box DHCP meldet; fest bei Static oder Adresse außerhalb des DHCP-Bereichs. Reservierungen innerhalb des Bereichs erscheinen als dynamisch (seit 2.0.0 zusätzlich Auslese der Weboberfläche, ungeprüft).
Der Filter *Feste IP* zeigt nicht alle Reservierungen.[Bearbeiten]
Siehe Kapitel Dashboard-Karte, Abschnitt Feste IP: Reservierungen im DHCP-Bereich meldet die Box nicht. Hilfe: Popup „reserviert“, mark_devices_reserved oder feste Adressen außerhalb des DHCP-Bereichs vergeben.
Der QR-Code zeigt ein Hauptnetz statt des Gast-WLANs.[Bearbeiten]
Option Gast-WLAN-Dienst auf die richtige Nummer (1–4) stellen. Der Diagnose-Download nennt unter wlan_service_bands, welches Band jeder Dienst meldet.
Der Button *Neu verbinden* meldet einen Fehler (z. B. errorCode: 606).[Bearbeiten]
Seit 1.5.2 wird zuerst TR-064 versucht, UPnP nur als Rückfall. Prüfe die Berechtigung FRITZ!Box Einstellungen und ob die Box die Internetverbindung selbst aufbaut. Hinter einem vorgeschalteten Router oder bei Kabel-Modellen gibt es keine Einwahl, die neu aufgebaut werden könnte.
Umbenennen meldet errorCode: 402 Invalid Args.[Bearbeiten]
Seit 1.6.1 wird die Bezeichnung geändert. Tritt der Fehler weiter auf, ist der Name länger als 64 Zeichen oder dem Konto fehlt das Recht App.
„Alle neu starten“ meldet nicht startbare Repeater.[Bearbeiten]
Die Box wurde trotzdem neu gestartet. Meist lehnt der Repeater die Anmeldung ab: Zugriff für Anwendungen am Repeater erlauben, Kennwort der Box übernehmen. Einzelne Repeater über ihren Neustart-Button testen.
Mesh-Sensor und „Alle neu starten“ fehlen, oder ein zweiter FRITZ!-Router wird nicht als Repeater erkannt.[Bearbeiten]
Beide entstehen erst mit mindestens einem erkannten Repeater und eingeschalteter Option Repeater als eigene Geräte anlegen; der Button braucht die FRITZ!Box-Steuerung. Das Gerät muss als Mesh-Mitglied eingebunden sein.
MAC-Filter-Schalter und Pairing-Button fehlen / Pairing meldet „Filter ist ausgeschaltet“.[Bearbeiten]
Beides nur mit FRITZ!Box-Steuerung und wenn die Box den Filter über TR-064 meldet. Pairing schaltet den Filter temporär aus – ist er schon aus, erst einschalten.
Externe IP, „Online seit“ oder „Internet verbunden“ bleiben „unbekannt“.[Bearbeiten]
Die Box läuft im reinen Access-Point-Betrieb oder meldet den WAN-Dienst nicht.
Die Ereignisse „Neues Gerät“ / „Externe IP geändert“ lösen nicht aus.[Bearbeiten]
Nach Einrichtung und Neustart wird zuerst nur der Ausgangszustand gemerkt (Absicht).
Nach einem Update meldet Home Assistant geänderte Einheiten.[Bearbeiten]
Die Einheit der Zähler folgt seit 1.5.2 der Sprache. Unter Entwicklerwerkzeuge → Statistiken mit Problem beheben bereinigen; Werte bleiben unberührt.
Datenverbrauch: Es erscheinen keine Werte.[Bearbeiten]
Zuerst den Sensor Datenverbrauch Status ansehen; er nennt den Grund. In der Box muss je Gerät „Internet-Datenraten speichern“ aktiv sein. Passen die Zahlen nicht, die Einheit auf Bit/s umstellen.
Das VPN-Gerät oder eine WireGuard-Gegenstelle fehlt.[Bearbeiten]
Seit 2.0.0 bleiben als VPN gekennzeichnete Einträge mit IP als VPN:<IP> erhalten. Ob die Box WireGuard-Gegenstellen so meldet, ist ungeprüft; der Diagnose-Download (box_hosts.without_mac_samples) zeigt die Kennzeichnung.
← Blueprints | Inhaltsübersicht | Bekannte Einschränkungen und Teststand →