Warum beginnt ein Container erst nach einem Image-Update, Dateien zu erstellen, die Root gehören?

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.

Ein Container kann nach einer Image-Aktualisierung Dateien erstellen, deren Besitzer root ist, wenn das neue Image den Laufzeitbenutzer, den Einstiegspunkt oder die Startprozedur zum Ändern der Besitzrechte anpasst.

Das persistente Volume kann unverändert bleiben, während der Ersatzcontainer mit einer anderen numerischen UID startet oder vorübergehend einen Initialisierungsschritt als root ausführt. Ein neuer Einstiegspunkt kann fehlende Verzeichnisse erstellen, die Konfiguration migrieren, Berechtigungen neu schreiben oder die in der vorherigen Version verwendeten Variablen PUID und PGID nicht mehr berücksichtigen. Vergleiche vor rekursiven Änderungen der Besitzrechte eine Datei aus der Zeit vor der Aktualisierung, eine beim Start erstellte Datei und eine von der laufenden Anwendung erstellte Datei.

Belege, dass sich die Besitzrechte erst nach dem Start des aktualisierten Containers ändern

Stoppe den Stack und notiere die numerische UID, GID, den Modus, die ACLs und die Zeitstempel einer vorhandenen Datei und ihres übergeordneten Verzeichnisses. Starte den aktualisierten Container einmal mit sichtbaren Protokollen und prüfe dann denselben Pfad sowie eine neu erstellte Datei.

Die Linux-chown-Systemaufrufe ändern numerische Besitzrechte. Entscheidend sind daher die UID und GID vor und nach dem Start, nicht der auf dem Host angezeigte Benutzername.

Wenn die Besitzrechte bereits vor dem Start auf root gesetzt sind, ist die Aktualisierung nicht die erste Ursache. Untersuche den Aktualisierungskopiervorgang, das Entpacken, die Wiederherstellung des Backups oder den Administratorbefehl, durch den die Dateien geschrieben wurden.

Vergleiche den Image-Benutzer vor und nach der Aktualisierung

Prüfe die Konfiguration des alten und des neuen Images, den effektiven Containerbenutzer, den Einstiegspunkt, den Befehl und die Versionshinweise. Halte fest, ob das Image nun root, ein benanntes Konto oder eine andere numerische UID angibt.

Docker dokumentiert, dass die USER-Anweisung die Laufzeitidentität festlegt – für spätere Image-Anweisungen sowie für den Einstiegspunkt und den Befehl des Containers, sofern sie nicht zur Laufzeit überschrieben wird.

Ein Image kann denselben Anwendungsbenutzernamen beibehalten und gleichzeitig seine numerische UID ändern. Vergleiche die Zahlen in beiden Image-Versionen, da auf dem Host eingebundene Dateien numerische Besitzrechte statt der Benutzerbezeichnung des Images speichern.

Prüfen Sie, ob der neue Entrypoint ein rekursives chown ausführt

Durchsuchen Sie Startprotokolle, Versionshinweise, Entrypoint-Skripte und Prozessspuren nach chown, der Reparatur von Berechtigungen, PUID, PGID, Benutzermigration oder Verzeichnisinitialisierung. Testen Sie dies mit einem kleinen Snapshot oder einem Wegwerf-Volume.

GNU Coreutils definiert rekursives chown als Umschreiben der Eigentümerschaft im ausgewählten Verzeichnisbaum. Dadurch kann es so aussehen, als hätte sich ein korrektes vorhandenes Volume sofort nach dem Start des neuen Images geändert.

Entfernen Sie die Reparatur beim Start nicht unbedacht. Manche Images benötigen sie für neu erstellte Verzeichnisse. Bevorzugen Sie ein dokumentiertes Deaktivierungs-Flag, eine feste Anwendungs-UID oder einen enger gefassten Datenpfad, sofern das Image dies unterstützt.

Single board computer zimaboard2

Prüfen Sie Compose-Benutzerüberschreibungen und entfernte PUID- oder PGID-Variablen

Vergleichen Sie das bereitgestellte Compose-Modell vor und nach dem Update, einschließlich user:, Umgebungsvariablen, ergänzender Gruppen, Profilen, Override-Dateien und den gespeicherten Einstellungen des Stack-Managers.

Kubernetes verwendet explizite numerische Laufzeit- und Volume-Identitäten und veranschaulicht damit dieselbe Container-Grenze: Eine Laufzeitüberschreibung und eine Richtlinie zur Volume-Eigentümerschaft sind separate Einstellungen, die aufeinander abgestimmt bleiben müssen.

Wenn das alte Image die Variablen PUID und PGID umgewandelt hat, die neue Version sie aber entfernt oder umbenannt hat, können die Variablen weiterhin vorhanden sein, ohne den Prozess noch zu steuern. Prüfen Sie die UID des laufenden Prozesses direkt.

Berücksichtigen Sie Rootless- und User-Namespace-ID-Zuordnungen

Halten Sie fest, ob Docker im Rootful- oder Rootless-Modus oder mit User-Namespace-Remapping läuft. Vergleichen Sie die im Container sichtbare UID mit dem auf dem Host sichtbaren Eigentümer desselben Inodes.

Red Hat erklärt, dass Rootless-Container untergeordnete UID- und GID-Bereiche verwenden. Daher erscheint Container-Root nicht unbedingt als Host-UID 0, und ein Update kann eine geänderte Zuordnung oder einen anderen Laufzeitmodus offenlegen.

Führen Sie nicht rekursiv chown auf einem Rootless-Volume als Host-Root aus, ohne die Zuordnung zu verstehen. Dadurch können die Daten für die vorgesehene Container-Identität unzugänglich werden.

Prüfen, ob ein idmapped oder Netzwerk-Mount den angezeigten Besitzer verändert

Ermitteln Sie, ob sich die App-Daten auf einem lokalen Dateisystem, einem idmapped Mount, NFS, SMB, FUSE oder einer NAS-Freigabe befinden. Notieren Sie die Mount-Optionen und vergleichen Sie den Dateibesitz auf dem Server, dem Host und im Container.

Das Modell idmapped Mounts des Linux-Kernels trennt Dateisystembesitz und Mount-Besitz. Daher kann dieselbe Datei unter unterschiedlichen IDs angezeigt werden, ohne den Dateibesitz physisch rekursiv zu ändern.

Wenn sich nach dem Update nur der angezeigte Besitzer ändert, prüfen Sie, ob die Laufzeit nun einen anderen Namespace oder eine andere Mount-Zuordnung verwendet. Korrigieren Sie die Zuordnung, statt alle Inodes neu zuzuweisen.

Eine stabile Laufzeitidentität wiederherstellen und das nächste Update überprüfen

Sichern Sie die Metadaten zum Dateibesitz, stoppen Sie die App, legen Sie die vorgesehene numerische UID und GID fest, korrigieren Sie nur die der App gehörenden Pfade und stellen Sie sie mit einem fixierten Image und dokumentierten Benutzereinstellungen erneut bereit.

Der ZimaSpace-Artikel zu Dateibesitz in Containern nach dem Kopieren von App-Daten behandelt Ursachen durch Kopieren und Migration; dieser Artikel grenzt davon eine Änderung ab, die durch das Ersatz-Image verursacht wird.

Die Reparatur ist abgeschlossen, wenn beim Start, beim Schreiben durch die Anwendung, beim Neuerstellen des Containers, beim Neustart des Hosts und bei einem kontrollierten Image-Update Dateien unter der dokumentierten Identität erstellt werden, ohne dass weitreichende Ausnahmen bei den Berechtigungen nötig sind.

Häufig gestellte Fragen

Beweist eine Datei im Besitz von root, dass der gesamte Container als root läuft?

Nein. Ein Entrypoint kann kurzzeitig als root laufen, um ein Volume zu initialisieren, und anschließend die Rechte abgeben, bevor die Anwendung startet.

Sollte ich das gesamte Volume rekursiv mit chown bearbeiten?

Nicht, bevor die vorgesehene UID, gemeinsam genutzte Pfade, ACLs und die Namespace-Zuordnung ermittelt wurden. Eine umfassende Änderung kann Datenbanken, gemeinsam genutzte Medien oder die Dateibesitzrechte in rootless Containern beschädigen.

Kann ein Image-Update die Anwendungs-UID ändern?

Ja. Wartende können den Benutzer des Images ändern, dessen Kontendatenbank neu erstellen, die Einstellungen für PUID oder PGID umbenennen oder eine Migration der Dateibesitzrechte beim Start hinzufügen.

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.