Checkliste zur Zuordnung von Container-Benutzern und -Gruppen für NAS-Freigaben

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.

Am sichersten ist es, die Prüfung der numerischen Identitätszuordnung vom NAS-Export über die Host-Einbindung bis zum laufenden Containerprozess als eine Folge überprüfbarer Prüfschritte zu behandeln, nicht als einzelnen Befehl.

Bei einem Linux-Container-Host mit SMB- oder NFS-gestützten NAS-Freigaben besteht das praktische Risiko darin, dass ein Container zwar einen auf dem NAS eingebundenen Pfad sehen kann, Lese- oder Schreibzugriffe aber mit Berechtigungsfehlern scheitern. Erfassen Sie die aktuelle Identität und den Wiederherstellungspunkt, beginnen Sie mit der am wenigsten invasiven Unterscheidungsprüfung, werten Sie erfolgreiche und fehlgeschlagene Ergebnisse aus, bevor Sie eine weitere Variable ändern, und halten Sie an, wenn der Speicher instabil wird oder die einzige wiederherstellbare Kopie gefährdet wäre. Der folgende Ablauf ist erst abgeschlossen, wenn die ursprüngliche Arbeitslast erfolgreich ausgeführt wird oder die Belege eine Eskalation erfordern.

Tatsächliche Identität des Containerprozesses ermitteln

Prüfen Sie die Dokumentation des Images, die Compose-Einstellung user, die Umgebungsvariablen, das Verhalten des Entrypoints sowie UID, GID und zusätzliche Gruppen des laufenden Anwendungsprozesses. Variablen namens PUID und PGID sind Konventionen bestimmter Images, keine universellen Docker-Funktionen. Prüfen Sie daher, ob dieses Image sie unterstützt.

Ein Fall aus der LinuxServer-Community zu Berechtigungsproblemen mit PUID und PGID in Containern zeigt, dass ein Bind-Mount trotz scheinbar korrekter PUID- und PGID-Werte weiterhin unzugänglich sein kann. Betrachten Sie den Fall als Anlass, den laufenden Prozess und die Einbindung zu prüfen, nicht als Beleg dafür, dass jedes Image dieselbe Initialisierungslogik verwendet.

Erfassen Sie die Zahlenwerte mit id im Container und auf dem Host. Brechen Sie ab, wenn die Anwendung nur deshalb als Root läuft, weil zuvor Berechtigungsprobleme aufgetreten sind; Root-Zugriff verschleiert den Zuordnungsfehler und erhöht die Auswirkungen eines kompromittierten Dienstes.

Eigentümerzuordnung vom NAS bis zur Host-Einbindung nachvollziehen

Prüfen Sie auf dem NAS den numerischen Eigentümer, die Gruppe, den Modus, die ACL und die Standard-ACL des Zielverzeichnisses. Prüfen Sie auf dem Container-Host dieselben eingebundenen Objekte und vergleichen Sie die Zahlenwerte. Wenn sich die Namen unterscheiden, die Zahlen aber übereinstimmen, sind die Bezeichnungen rein kosmetisch; unterscheiden sich die Zahlen, ist der Autorisierungspfad tatsächlich ein anderer.

Geben Sie für NFS die Exportoptionen, die NFS-Version, die ID-Zuordnung, Root-Squashing und die Identität an, unter der der Client das Verzeichnis einbindet. Geben Sie für SMB die Zugangsdaten für das Einbinden, die serverseitig zugeordnete Identität, die Optionen zur Zuordnung von uid oder gid sowie an, ob Unix-Erweiterungen oder eine ACL-Übersetzung verwendet werden.

Ändern Sie nicht gleichzeitig die Server-ACLs und die Client-Einhängeoptionen. Der Testschritt ist bestanden, wenn eine Testdatei einen bekannten numerischen Eigentümer hat und der Host nach dem Aushängen, erneuten Einhängen und Neustart eine stabile Zuordnung anzeigt.

Bind-Mount und Zusatzgruppen testen

Stellen Sie sicher, dass der Quellpfad des Containers dem erwarteten Host-Einhängepunkt entspricht und nicht einem leeren lokalen Verzeichnis, das erstellt wurde, bevor die Netzwerkfreigabe eingebunden wurde. Prüfen Sie die Laufzeit-Einbindung und testen Sie anschließend in einem temporären Unterverzeichnis als Anwendungsbenutzer das Auflisten, Lesen, Erstellen, Umbenennen und Löschen.

Ein Fall auf Server Fault dokumentiert eine Abweichung bei NFS-ACL-Berechtigungen, obwohl Eigentümer und ACL-Einträge übereinzustimmen scheinen. Das veranschaulicht, warum die ACL-Maske, die Serverzuordnung und die effektive Identität geprüft werden müssen. Erfassen Sie die Ausgabe von getfacl sowohl für das Verzeichnis als auch für die erstellte Datei.

Wenn der Gruppenzugriff vorgesehen ist, fügen Sie die unterstützte numerische Zusatzgruppe hinzu und erstellen Sie den Container neu, da die Prozessgruppen beim Start festgelegt werden. Verwenden Sie die ZimaSpace-Anleitung zur Diagnose eines leeren Containerpfads, wenn die Anwendung mit einem leeren Pfad startet; das ist ein Problem mit der Einbindungsreihenfolge, kein ACL-Problem.

Single board computer zimaboard2

Wenden Sie die engstmögliche Korrektur der Identität an und testen Sie erneut

Richten Sie nach Möglichkeit die von der Anwendung unterstützte UID, GID oder ergänzende Gruppe an der NAS-Richtlinie aus. Verwenden Sie eine gemeinsame Gruppe und eine vererbte ACL, wenn mehrere Dienste zusammenarbeiten. Vermeiden Sie weltweit beschreibbare Berechtigungen, rekursive Änderungen der Eigentumsverhältnisse an nicht zusammengehörigen Datensätzen und privilegierte Container als Abkürzung.

Erstellen Sie den Container neu, binden Sie die Freigabe erneut ein, wenn sich die Zuordnungsoptionen geändert haben, und wiederholen Sie dieselben Vorgänge. Starten Sie den Host einmal neu, um zu überprüfen, ob die Reihenfolge beim Einbinden und die numerischen Identitäten den Systemstart überstehen. Stellen Sie sicher, dass neu erstellte Dateien für die vorgesehenen menschlichen Nutzer beschreibbar bleiben, ohne dem Container unnötige Rechte zu gewähren.

Schließen Sie die Checkliste, wenn die App ihre ursprüngliche Arbeitslast bewältigt, verweigerte Vorgänge weiterhin verweigert werden und die Eigentumsverhältnisse nach einem Neustart stabil bleiben. Eskalieren Sie, wenn User-Namespaces, rootless Zuordnungen oder NAS-Identitätsdienste IDs so umschreiben, dass das gewählte Image damit nicht umgehen 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.