So legen Sie Container-UID/GID und Volume-Berechtigungen vor Updates selbst gehosteter Apps fest

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.

Bei Aktualisierungen selbst gehosteter Apps entstehen seltener Dateien im Besitz von Root, wenn die Bereitstellung einen numerischen Benutzervertrag festlegt und die Eigentümerschaft der Volumes prüft, bevor der Container ersetzt wird.

Die vorbeugende Maßnahme besteht darin, den internen Image-Benutzernamen nicht länger als stabile Speicheridentität zu behandeln. Erfassen Sie die effektive UID und GID, mit denen persistente Daten geschrieben werden, ordnen Sie sie den Host-Verzeichnissen oder benannten Volumes zu, übernehmen Sie alle PUID-/PGID- oder Benutzer-Namespace-Einstellungen und testen Sie das neue Image zunächst mit einem kleinen beschreibbaren Pfad, bevor Sie es vollständig ausrollen. So kann eine Image-Aktualisierung nicht unbemerkt den numerischen Eigentümer von Konfigurationen, Uploads, Datenbanken oder Medienmetadaten ändern.

Numerische UID und GID vor der Aktualisierung erfassen

Erfassen Sie den Benutzer des laufenden Prozesses, die primäre Gruppe, ergänzende Gruppen und die numerische Eigentümerschaft repräsentativer Dateien in jedem beschreibbaren Mount. Speichern Sie den Image-Digest oder die Version zusammen mit dieser Eigentümerschaftsreferenz.

Die Anleitung zum Erstellen von Docker-Images besagt, dass explizite IDs Abweichungen bei erneuten Builds vermeiden, da automatisch zugewiesene Image-Benutzer bei erneuten Builds unterschiedliche numerische IDs erhalten können.

Halten Sie die Nummern fest, nicht nur Namen wie app oder media. Ein neues Image kann denselben Benutzernamen wiederverwenden, aber dessen UID ändern. Host-Dateien speichern die Eigentümerschaft als numerische Werte.

Den Laufzeitbenutzer im Bereitstellungsvertrag festlegen

Wenn das Image die direkte Ausführung unter einem Nicht-Root-Konto unterstützt, geben Sie den vorgesehenen Benutzer und die Gruppe explizit in Compose oder der Laufzeitkonfiguration an. Erfordert das Image eine Initialisierungsphase mit Root-Rechten, dokumentieren Sie, welcher nachfolgende Prozess tatsächlich persistente Daten schreibt.

Die Spezifikation für Open-Container-Images definiert User als Laufzeitstandard. Das bedeutet, dass ein geändertes Image die Laufzeitidentität ändern kann, sofern die Bereitstellung diese nicht bewusst überschreibt oder überprüft.

Weisen Sie Images, die ein unterstütztes Initialisierungsmodell erfordern, keine beliebige UID ungleich null zu. Die Konfiguration sollte dem dokumentierten Design der Anwendung folgen und gleichzeitig sicherstellen, dass der Eigentümer der daraus entstehenden persistenten Dateien vorhersehbar ist.

PUID und PGID an die Eigentümerschaft auf dem Host anpassen

Bei Images, die PUID- und PGID-Variablen bereitstellen, sollten diese Werte in einer versionierten Compose- oder Umgebungskonfiguration festgelegt werden. Außerdem muss sichergestellt sein, dass die Verzeichnisse der Host-Volumes dem entsprechenden Dienstkonto gehören.

LinuxServer erklärt, dass PUID Schreibvorgänge im Container zuordnet, damit Dateien in eingebundenen Volumes außerhalb des Containers verwaltbar bleiben.

Vergleichen Sie vor dem Update die konfigurierten IDs mit der Ausgabe von id auf dem Host und mit der bestehenden Dateieigentümerschaft. Übernehmen Sie nicht blind einen Beispielwert wie 1000 auf einen Server, auf dem diese ID einer anderen Person oder einem anderen Dienst gehört.

Single board computer zimaboard2

Benutzernamespaces und Rootless-Zuordnung berücksichtigen

Rootless Docker oder Podman kann einen Prozess im Container als root erscheinen lassen und ihn zugleich einer unprivilegierten UID auf dem Host zuordnen. Halten Sie den Namespace-Modus und die Konfiguration der untergeordneten UID/GID-Bereiche fest, bevor Sie Änderungen der Eigentümerschaft interpretieren.

Die Laufzeitoptionen von Podman zeigen, dass keep-id die Benutzerzuordnung beibehält, wenn ein Container vorhersagbaren Zugriff auf eingebundene Host-Dateien benötigt.

„Korrigieren“ Sie keinen scheinbaren root-Eigentümer im Container, bevor Sie die numerische ID auf dem Host geprüft haben. Root in einem Namespace und root auf dem Host sind nicht immer dieselbe Identität.

Das neue Image vorab mit einem Test-Volume prüfen

Bevor Sie den Produktionscontainer ersetzen, führen Sie das neue Image mit der vorgesehenen UID/GID und einem temporären Verzeichnis aus, das die Produktionsberechtigungen nachbildet. Lassen Sie die Startinitialisierung eine Datei und ein Verzeichnis erstellen und prüfen Sie anschließend deren Eigentümerschaft auf dem Host.

Der Debugging-Leitfaden von Red Hat für Rootless-Volumes zeigt, dass die Eigentümerschaft auf dem Host der UID-Zuordnung folgt, statt dass der im Container angezeigte Benutzername allein als Beleg ausreicht.

Wenn der Canary unerwartete Dateien erstellt, die root gehören oder neu zugeordnet wurden, stoppen Sie den Rollout und vergleichen Sie Image-Benutzer, Entrypoint, Namespace und Mount-Einstellungen. Das ist viel sicherer, als die Änderung erst zu entdecken, nachdem eine rekursive Startmigration einen ganzen Foto- oder Datenbankbaum verändert hat.

Zusätzliche Gruppen und beschreibbare Pfade prüfen

Manche Apps benötigen eine primäre Dienst-UID sowie Zugriff über eine gemeinsame Medien-, Download- oder Gerätegruppe. Halten Sie diese Gruppen-IDs fest und testen Sie alle beschreibbaren Pfade, nicht nur das Konfigurationsverzeichnis.

Kubernetes verwendet explizite runAsUser- und runAsGroup-Steuerungen und veranschaulicht damit dasselbe Linux-Prinzip der Eigentümerschaft auch außerhalb einer einfachen Docker-Compose-Bereitstellung.

Die Update-Richtlinie ist abgeschlossen, wenn das neue Image Dateien mit der erwarteten Eigentümerschaft auf dem Host für alle persistenten Pfade erstellt und eine Neuerstellung des Containers übersteht. Der zugehörige ZimaSpace-Artikel zu Dateien im Besitz von root nach Image-Updates beschreibt den Wiederherstellungsweg, falls ein Rollout bereits Daten erzeugt hat, die root gehören.

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.