Warum erstellt Home Assistant fehlende Dateien mit dem falschen Besitzer neu?

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Home Assistant wählt beim erneuten Erstellen einer Datei keinen benutzerfreundlichen Host-Benutzernamen aus. Die neue Datei übernimmt normalerweise die numerische UID, GID, Umask, ACL und die Dateisystemregeln des Prozesses, der sie im Container erstellt hat.

Bei einem Bind-Mount wird dies sichtbar, weil Linux numerische Identitäten speichert, während Host und Container derselben Zahl unterschiedliche Namen zuordnen können. Bevor Sie Berechtigungen ändern, stoppen Sie Home Assistant, notieren Sie die alten und neuen numerischen Besitzer, ermitteln Sie den Laufzeitprozess und stellen Sie fest, ob die Datei von Home Assistant, einem Einstiegspunkt, einem Sicherungstool oder dem Host erstellt wurde.

Feststellen, welcher Prozess die Datei erstellt hat

Vergleichen Sie den Erstellungs- oder Änderungszeitpunkt der Datei mit dem Start, der Wiederherstellung oder Aktualisierung des Containers oder mit einem Add-on-Auftrag. Prüfen Sie dann die numerische UID und GID auf dem Host sowie die Identität des Home-Assistant-Prozesses im Container. Benutzernamen können abweichen; die Zahlen sind der verlässliche Vergleich.

Das zugrunde liegende Containerproblem besteht darin, dass Dateien in Bind-Mounts unter der Identität des Containerprozesses erstellt werden. Eine unabhängige Erklärung der Abweichung beim Besitzer des Host-Dateisystems zeigt, warum übereinstimmende Namen allein Unterschiede bei numerischen UIDs und GIDs nicht beheben.

Wenn der neue Besitzer dem Containerprozess entspricht, ist die Hauptursache bestätigt. Entspricht er root oder einem anderen Hilfsprozess, prüfen Sie den Einstiegspunkt, das Wiederherstellungstool, den geplanten Auftrag oder das Skript auf dem Host, bevor Sie den Laufzeitbenutzer von Home Assistant ändern.

Mount, ACL und Dateisystemgrenze prüfen

Vergewissern Sie sich, dass der Pfad der vorgesehene Bind-Mount ist und kein benanntes Volume oder ein durch den Mount verdecktes Image-Verzeichnis. Prüfen Sie den Besitzer und Modus des übergeordneten Verzeichnisses, die Standard-ACL und ob das Dateisystem lokal, NFS, SMB oder ein anderer netzwerkbasierter Pfad ist.

Ein Prozess kann eine Datei nur mit den Berechtigungen und Zuordnungen erstellen, die das Dateisystem bereitstellt. NFS-Identitätszuordnung, Root-Squashing, SMB-Mount-Optionen, Standard-ACLs und eine restriktive Umask können den angezeigten Besitzer oder Schreibzugriff ändern, selbst wenn die Container-UID korrekt ist.

Wenn eine temporäre Datei, die mit der Laufzeit-UID erstellt wurde, den erwarteten Eigentümer erhält, fahren Sie mit dem anwendungsspezifischen Ersteller fort. Erhält sie den falschen Eigentümer, beheben Sie zuerst die Mount- oder Dateisystemzuordnung. Änderungen an der Home-Assistant-Konfiguration setzen diese Ebene nicht außer Kraft.

Nur die bestätigte Abweichung beim Eigentümer beheben

Stoppen Sie Home Assistant, bevor Sie den Eigentümer aktiver Datenbank-, Registry- oder Konfigurationsdateien ändern. Erstellen Sie ein Backup oder einen Snapshot und ändern Sie dann nur den betroffenen Pfad auf die verifizierte Dienst-UID und -GID. Behalten Sie Ausführungsbits, ACLs und Sonderberechtigungen bei, statt eine weitreichende Berechtigung wie Schreibzugriff für alle zu vergeben.

Aktualisieren Sie die Deployment-Definition so, dass nach einer Neuerstellung dieselbe Laufzeitidentität verwendet wird, oder dokumentieren Sie, warum das Image mit seiner Standardidentität ausgeführt werden muss, und passen Sie den Host-Pfad daran an. Vermeiden Sie es, bei jedem Start den Eigentümer des gesamten Verzeichnisbaums mit chown zu ändern. Das kann langsam sein, Designfehler verschleiern und Dateien verändern, die anderen Diensten gehören.

Die Anleitung von ZimaSpace zum Verhindern von Berechtigungsabweichungen enthält eine umfassendere Checkliste zu Mounts, Eigentümern, Schreibtests und Wiederherstellungsverhalten, nachdem die unmittelbare Abweichung beim Eigentümer behoben wurde.

Single board computer zimaboard2

Eigentümer nach Neuerstellung und einem echten Schreibvorgang überprüfen

Starten Sie Home Assistant und lösen Sie genau den Vorgang aus, durch den die Datei erstellt wurde. Vergewissern Sie sich, dass die neue Datei den vorgesehenen numerischen Eigentümer hat, Home Assistant sie aktualisieren kann und der Backup-Prozess auf dem Host sie lesen kann. Ein erfolgreicher Start ohne Schreibvorgang beweist nicht, dass das Problem behoben ist.

Starten Sie einmal neu und erstellen Sie den Container anhand der gespeicherten Konfiguration erneut. Eigentümer, ACL und Schreibverhalten müssen nach beiden Vorgängen stabil bleiben. Prüfen Sie die Protokolle auf Meldungen wie „Zugriff verweigert“, schreibgeschützte Datenbank, fehlgeschlagenes Backup oder Fehler beim Einrichten der Integration.

Wenden Sie sich an den Image-Maintainer oder den Speicheradministrator, wenn sich die erstellende Identität zwischen Versionen unerwartet ändert, ein Netzwerkdateisystem die Eigentümerangaben umschreibt oder ein erforderlicher Dienst den Pfad nicht sicher gemeinsam nutzen kann. Halten Sie die numerischen IDs, die Mount-Definition, den Dateisystemtyp und eine minimale Reproduktion fest.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.