Es ist irritierend, wenn ein NAS offenbar funktioniert, etwa weil sich seine Webseite öffnen lässt oder ein freigegebener Ordner noch eingebunden ist, während Home Assistant eine Entität als unavailable anzeigt. Beide Beobachtungen können stimmen. Sie können auf unterschiedlichen Prüfungen beruhen, die zu verschiedenen Zeiten über unterschiedliche Netzwerkwege liefen. Wer eine davon für das ganze Bild hält, startet womöglich unnötig den Router neu, ändert eine Firewall-Regel oder baut eine Automation, die fehlende Informationen als NAS-Ausfall wertet.
Diese Anleitung führt dich durch eine gezielte Fehlersuche für ein NAS und eine Home-Assistant-Instanz, die du selbst verwaltest. Sie weist nicht nach, dass das NAS fehlerfrei läuft, und ersetzt weder ein Backup noch das Wiederherstellungsverfahren des Herstellers. Ziel ist, herauszufinden, welche Information fehlt, bevor du etwas änderst.
Besonders nach einem Neustart oder einem erneuten Verbindungsaufbau ist diese Unterscheidung wichtig. Ein Zustand kann sich ändern, bevor alle Integrationen ihre Werte aktualisiert haben. Home Assistant dokumentiert, wie Zustands-Trigger mit ausdrücklich angegebenen from- und to-Werten arbeiten und wie sich dabei unknown und unavailable verhalten. Halte den beobachteten vorherigen und neuen Zustand der Entität, den Zeitstempel und die beteiligte Integration fest. Die abschließende Anzeige im Dashboard allein reicht nicht aus, um auf einen Ausfall zu schließen. Home Assistant: Verhalten von unavailable und unknown in Triggern
Die konkrete Entität hinter dem NAS-Namen
Öffne die Entität, die als unavailable angezeigt wird. Notiere ihre Entitäts-ID, Integration, ihren Zustand, ihre Attribute und den Zeitpunkt der letzten Änderung. Home Assistant bildet eine Entität über einen Zustand und Attribute ab; der Zustand kann eine Zeichenfolge wie unavailable oder unknown sein. Die Dokumentation zum Zustandsobjekt erklärt: last_changed erfasst die letzte Zustandsänderung; last_updated erfasst die letzte Änderung des Zustands oder seiner Attribute. Das ist relevant: Ein veraltetes Attribut ist etwas anderes als eine gerade ausgefallene Verbindung.
Fasse unterschiedliche Beobachtungen nicht allein deshalb zusammen, weil sie denselben NAS-Anzeigenamen tragen. Zu einem NAS können ein binärer Ping-Sensor, eine Speicherintegration, ein MQTT-Sensor, ein REST-Sensor und ein Geräte-Tracker gehören. Einer davon kann nicht verfügbar sein, während ein anderer noch einen alten Wert enthält. Notiere zuerst, welcher davon Probleme macht, bevor du das NAS selbst untersuchst.
Diese Aussagen bedeuten zum Beispiel jeweils etwas anderes:
- Ein binärer Ping-Sensor kann die konfigurierte Prüfung nicht abschließen.
- Eine Integration kann einen Wert über ihre eigene Verbindung oder API nicht aktualisieren.
- Eine Dashboard-Karte zeigt eine Entität an, deren Zustand auf nicht verfügbar gewechselt ist.
- Eine Dateifreigabe ist von einem bestimmten Client zu einem bestimmten Zeitpunkt erreichbar.
Keine einzelne Beobachtung beweist, dass die Festplatten, Dateifreigaben, Backups oder sämtliche Netzwerkwege funktionieren. Wenn du diese Beobachtungen auseinanderhältst, kannst du den nächsten Test enger eingrenzen.
Adress- und Netzwerkprüfung
Vergleiche die Adresse in der Konfiguration der betroffenen Integration mit der aktuellen Adresse des NAS. Nutze dafür Konfigurations- und Routerinformationen, die du einsehen darfst. Verlass dich nicht auf eine Adresse, die du im Kopf hast. DHCP vergibt eine IP-Adresse üblicherweise für eine begrenzte Lease-Dauer; der Lease-Eintrag beschreibt diese Zuweisung, nicht die aktuelle Erreichbarkeit. Er ist kein allgemeiner Nachweis dafür, dass ein Gerät online ist. RFC 2131 beschreibt dieses DHCP-Lease-Modell.
Notiere kurz:
- Den Hostnamen oder die IP-Adresse, die die Home-Assistant-Integration verwendet.
- Die IP- und MAC-Adresse, die der Router oder DHCP-Server aktuell anzeigt.
- Das VLAN, die SSID oder das Subnetz von Home Assistant und vom NAS.
- Den Zeitpunkt jeder Beobachtung und ob eines der beiden Systeme neu gestartet wurde.
Ein NAS mit statischer Adresse kann funktionieren, ohne als aktuelle DHCP-Lease aufzutauchen. Umgekehrt kann ein Router einen Lease-Eintrag behalten, nachdem ein Gerät offline gegangen ist. Vergleiche die NAS-Adresse und die Zeitstempel der Beobachtungen aus deinen Quellen.
Wenn sich die Adresse geändert hat, kläre zuerst den Grund. Eine DHCP-Reservierung kann einem Dienst helfen, der eine feste Adresse braucht. Sie behebt aber nicht jede nicht verfügbare Entität. Ändere die Konfigurationen im Router und in Home Assistant getrennt voneinander. Wenn du beides gleichzeitig bearbeitest, weißt du hinterher nicht, welche Änderung geholfen hat.
Einfache Erreichbarkeitsprüfung
Die Home-Assistant-Integration Ping (ICMP) erstellt einen binären Sensor, der regelmäßig ICMP-Echo-Anfragen sendet. Laut Dokumentation prüft sie, ob ein Host erreichbar ist, und kann dafür einen Hostnamen oder eine IP-Adresse verwenden. Mit der gerade überprüften NAS-Adresse liefert sie dir einen nützlichen, aber begrenzt aussagekräftigen Vergleichswert.
Sie prüft weder SMB oder NFS noch die Weboberfläche des NAS, die Festplatten oder die Zugangsdaten einer Integration. Ein Host kann erreichbar sein, obwohl ein Dienst nicht verfügbar ist. Er kann auch ICMP-Anfragen ablehnen, während ein zugelassener Anwendungsdienst weiterhin funktioniert. Mach diese Einschränkung im Namen und in den Notizen des Sensors deutlich. „NAS per ICMP erreichbar“ ist ein hilfreicherer Name als einfach nur „NAS online“.
Wenn der Ping-Sensor nicht verfügbar oder aus ist, vergleiche das Ergebnis mit einem normalen Dienst, den du ohnehin nutzen darfst, etwa der lokalen Verwaltungsseite des NAS oder einer bestehenden Dateifreigabe. Dafür brauchst du weder einen Portscan noch neue Zugangsdaten oder einen Test aus dem Internet. Du prüfst, ob die Beobachtungen voneinander abweichen. Ein umfassender Sicherheitstest gehört nicht zu dieser Fehlersuche im Heimnetz.
Hinweise aus der Integration vor einem Neustart
Wenn eine einfache Netzwerkprüfung erfolgreich ist, aber eine Entität der Integration nicht verfügbar bleibt, suche bei der Integration weiter. Öffne ihre Logeinträge, die bereits angebotenen Diagnosedaten und den Verlauf der Entität. Suche rund um den Zustandswechsel nach einem Authentifizierungsfehler mit Zeitstempel, einem Verbindungs-Timeout, einer Zertifikatsmeldung, einem Problem bei der Auflösung des Hostnamens oder einem Neuladen der Integration. Ein alter Sensorwert kann neben einem aktuellen Zustand unavailable stehen. Gib einem Ereignis mit Datum und Uhrzeit mehr Gewicht als dem Eindruck aus dem Dashboard.
Die Automationsdokumentation von Home Assistant erklärt, dass Trigger eine Automation starten und anschließend die Bedingungen ausgewertet werden. Wenn unavailable in eine Warnung oder Aktion einfließt, ist diese Reihenfolge wichtig. Prüfe zuerst, ob die Warnung durch genau diesen Zustandswechsel, einen Neustart oder eine andere Entität ausgelöst wurde. Die Referenz zu Automations-Triggern beschreibt Zustands-Trigger und ihre Optionen from und to.
Wenn eine Aktion Folgen hat, ersetze sie für den Test vorübergehend durch eine Benachrichtigung oder einen Logeintrag. Deaktiviere keinen wichtigen Ablauf für Backups, Stromversorgung oder Sicherheit, nur damit eine Warnung verschwindet. Halte in einer kurzen Wartungsnotiz fest, was du wann geändert hast und wie du den ursprünglichen Zustand wiederherstellst. Das ist sicherer, als sich auf das Gedächtnis zu verlassen.
Eine rückgängig machbare Änderung mit anschließender Prüfung
Wähle den kleinsten Test, der zu den vorliegenden Hinweisen passt. Wenn die Integration die alte Adresse verwendet, korrigiere diesen Konfigurationseintrag und warte das normale Update-Intervall ab. Wenn die Adresse stimmt, aber bei der Entität ein Authentifizierungsfehler dokumentiert ist, behebe ihn anhand der Dokumentation der Integration und des NAS. Wenn sowohl die Integration als auch die Erreichbarkeitsprüfung scheitern, untersuche den lokalen Netzwerkweg, den Betriebszustand und die Stromversorgung sowie den Router-Eintrag, bevor du Automationen in Home Assistant änderst.
Notiere nach jeder Änderung den Zeitpunkt, den Zustand der Entität, das Ergebnis des begrenzten Erreichbarkeitsvergleichs und die Meldung der Integration. Eine einzelne, kontrollierte Änderung lässt sich leichter rückgängig machen. Sie verrät dir auch mehr als ein gleichzeitiger Neustart von NAS, Router und Home-Assistant-Host.
Wenn die Entität wieder verfügbar ist, bewahre deine Aufzeichnungen für das nächste Mal auf. Ein lokales Inventar- oder Monitoring-Tool wie DeviceShelf kann eine zusätzliche Beobachtung mit Zeitstempel zu einem Gerät in deinem verwalteten Netzwerk liefern. Es kann nicht feststellen, warum eine bestimmte Home-Assistant-Integration nicht verfügbar war. Nutze es deshalb als ergänzenden Hinweis, nicht als abschließende Bewertung.
Am Ende steht vielleicht eine überschaubare Erkenntnis: Das NAS war erreichbar, aber die Konfiguration einer Integration war veraltet. Oder das Gerät war aus dem Netzwerk von Home Assistant tatsächlich nicht erreichbar. Beides sagt dir mehr, als unavailable schon für eine Diagnose zu halten. Wenn du die Entität genau benennst, die Netzwerkhinweise vergleichst und immer nur eine Sache änderst, erhältst du ein Protokoll, das du nach dem nächsten Neustart oder Adresswechsel wieder heranziehen kannst.