Warum ändern sich die Dateieigentümer von Containern nach dem Kopieren von App-Daten?

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.

Die Dateibesitzer im Container ändern sich nach einem Kopiervorgang, wenn die numerischen UID-/GID-Werte nicht beibehalten werden oder die Laufzeitumgebung am Ziel sie neu zuordnet oder überschreibt.

Auf einem Heim-NAS kann dieselbe Datei auf dem Host unter einem Benutzernamen und innerhalb eines Containers unter einem anderen angezeigt werden, weil die Besitzverhältnisse als Zahlen gespeichert sind, während jede Umgebung diese Zahlen anhand einer anderen Kontendatenbank auflöst. Kopiervorgänge über eine grafische Benutzeroberfläche, eine SMB-Freigabe, ein Archiv, eine Root-Shell, ein Migrationstool oder einen Container-Einstiegspunkt können die Besitzverhältnisse ebenfalls ersetzen. Prüfen Sie zuerst die numerische Identität und unterscheiden Sie dann zwischen Kopierverhalten, Laufzeitbenutzereinstellungen, Startskripten, User-Namespaces und der Zuordnung des Netzwerkdateisystems, bevor Sie die Berechtigungen im gesamten App-Datenverzeichnisbaum ändern.

Numerische UID und GID vergleichen, bevor Sie Benutzernamen vergleichen

Prüfen Sie Quelle und Ziel anhand der numerischen Besitzverhältnisse, nicht nur der Namen. Erfassen Sie für eine repräsentative Datei und ihr übergeordnetes Verzeichnis sowohl auf dem Host als auch im Container UID, GID, Modus, ACLs, erweiterte Attribute und Dateisystem.

Docker-Bind-Mounts machen Hostdateien für Prozesse zugänglich, die möglicherweise eine andere Benutzerdatenbank verwenden. Eine Diskussion über Berechtigungen in der Docker-Community erklärt, warum ein zuverlässiger Zugriff von der Übereinstimmung der numerischen UID/GID abhängt und nicht allein von übereinstimmenden Benutzernamen.

Sind die Zahlen identisch, aber die angezeigten Namen unterschiedlich, haben sich die Besitzverhältnisse möglicherweise gar nicht geändert. Korrigieren Sie die Dokumentation oder die Kontenzuordnung, statt die Daten rekursiv umzuschreiben. Unterscheiden sich die Zahlen, sichern Sie die Belege und fahren Sie mit den Kopier- und Laufzeitphasen fort.

Ermitteln, ob der Kopiervorgang die Besitzverhältnisse beibehalten oder neu festgelegt hat

Notieren Sie den genauen Kopierweg: Dateimanager des Hosts, cp, rsync, Tar-Archiv, SMB-/NFS-Client, Wiederherstellung eines Backups, Docker-Kopierbefehl oder temporärer Migrationscontainer. Jede Methode verwendet andere Standardwerte für Besitzer, Gruppe, ACLs und erweiterte Attribute.

Ein als Root ausgeführter Kopiervorgang kann bei explizit angegebenen Archivoptionen die numerischen Besitzverhältnisse erhalten, während ein anderes Tool jede Zieldatei mit dem Konto erstellen kann, das den Kopiervorgang ausführt. Ein kürzlich aufgetretenes Problem bei einer Container-Migration zeigt, wie kopierte App-Daten unlesbar werden können, wenn sich die Ziel-UID von der Laufzeitidentität der Anwendung unterscheidet.

Wiederholen Sie den Vorgang mit einem kleinen Testverzeichnis und prüfen Sie die Eigentümerschaft unmittelbar vor dem Start der Anwendung. Sind die Werte bereits falsch, korrigieren Sie die Kopiermethode oder stellen Sie die Flags wieder her. Ändern sie sich erst nach dem Start, lassen Sie die Kopie unverändert und untersuchen Sie den Container-Entrypoint.

Den Benutzer der Container-Runtime auf den Eigentümer des Host-Speichers abstimmen

Prüfen Sie den effektiven Benutzer im laufenden Container und den numerischen Eigentümer des per Bind-Mount eingebundenen Anwendungsdatenverzeichnisses. Prüfen Sie außerdem Compose-user:, zusätzliche Gruppen, PUID/PGID-Variablen der Plattform und alle imagespezifischen Kontoeinstellungen.

Der Betrieb eines Containers als Nicht-Root-Benutzer gewährt nicht automatisch Zugriff auf ein Hostverzeichnis, das einer anderen numerischen Benutzerkennung gehört. In einem Docker-Forum wird die Zugriffsbeschränkung dadurch aufgehoben, dass der Containerbenutzer und die Hostberechtigungen aufeinander abgestimmt werden, statt das Verzeichnis für alle beschreibbar zu machen.

Legen Sie für die Anwendung ein einheitliches Eigentümerschaftsmodell fest und dokumentieren Sie es in Compose. Fügen Sie nur die Gruppen hinzu, die für den gemeinsamen Zugriff erforderlich sind. Vermeiden Sie chmod 777, da dadurch die abweichenden Benutzerkennungen verborgen werden, die Trennung geschwächt wird und künftige Dateien nicht den vorgesehenen Eigentümer erhalten.

Prüfen, ob der Entrypoint beim Start die Eigentümerschaft ändert

Viele Images starten kurzzeitig als Root, erstellen fehlende Verzeichnisse, übernehmen eine konfigurierte UID/GID und ändern rekursiv die Eigentümerschaft, bevor sie die Berechtigungen einschränken. Dadurch kann es so wirken, als würde sich eine korrekte Kopie nach dem ersten Containerstart von selbst ändern.

Container-Runtimes und Images können ebenfalls Mountverhalten zum Ändern der Eigentümerschaft bieten. Ein Podman-Issue weist darauf hin, dass die Option :U die Eigentümerschaft der Quelle ändern kann, während Entrypoint-Skripte beim Start der Anwendung eine ähnliche rekursive Änderung vornehmen können.

Starte den Container einmal mit sichtbaren Logs und überwache einen kleinen Test-Unterbaum. Durchsuche den Entry-Point und die Versionshinweise des Images nach chown, Benutzermigration, PUID/PGID und Schritten zur Berechtigungsanpassung. Deaktiviere oder beschränke dieses Verhalten nur, wenn das Image eine stabile Alternative unterstützt.

Rootless Docker, User-Namespaces und Netzwerkdateisysteme berücksichtigen

Rootless Docker und die User-Namespace-Neuzuordnung übertragen Container-IDs in einen anderen Host-ID-Bereich. NFS-, CIFS- und manche NAS-Mount-Optionen können unabhängig davon Root squashen oder allen Dateien eine festgelegte UID und GID zuweisen.

Ein Berechtigungsbericht zu Rootless Docker zeigt, dass Dateien unerwartete Eigentumsverhältnisse aufweisen, weil die Containeridentität einem untergeordneten Host-ID-Bereich zugeordnet wird. Der diagnostische Hinweis ist die Eigentumszuordnung im User-Namespace, nicht ein herkömmlicher Kopierfehler.

Prüfe, ob der Datenpfad lokal, NFS, CIFS, FUSE oder ein anderes eingehängtes Dateisystem ist, und halte dessen UID/GID-, Root-Squash- und ACL-Verhalten fest. Teste das Anlegen von Dateien mit bestimmten Eigentumsverhältnissen getrennt auf dem Host und im Container. Führe kein rekursives chown auf einer Netzwerkfreigabe aus, bevor die Identitätsrichtlinien auf dem Server geklärt sind.

Eigentumsverhältnisse anhand einer bekannten Anwendungsidentität korrigieren

Stoppe die Anwendung, sichere die aktuellen Metadaten und ermittle die genauen UID- und GID-Werte, Verzeichnismodi, Dateimodi, ACLs und Sicherheitslabels, die das Image erwartet. Korrigiere nur die anwendungseigenen Pfade und schließe gemeinsam genutzte Medien oder nicht zugehörige Datensätze aus.

Der ZimaSpace-Leitfaden zum Unterscheiden zwischen Berechtigungsfehlern und schreibgeschützten Mounts ist der nächste Schritt, wenn trotz korrekter Eigentumsverhältnisse keine Schreibvorgänge möglich sind.

Starte den Container neu und erstelle, ändere und lösche als tatsächlicher Dienstbenutzer eine Testdatei. Erstelle anschließend den Container neu und wiederhole den Test. Die Reparatur ist erst abgeschlossen, wenn die Eigentumsverhältnisse nach dem Kopieren, dem Start, einem Neustart und der Neuerstellung des Containers stabil bleiben und die Anwendung ohne weitreichende Ausnahmen bei den Berechtigungen lesen und schreiben kann.

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.