So beheben Sie einen Docker-Bind-Mount, der plötzlich schreibgeschützt ist

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 Docker-Bind-Mount wird schreibgeschützt, wenn Docker einen schreibgeschützten Pfad erhält oder das Host-Dateisystem keine Schreibvorgänge mehr akzeptiert.

Da ein Bind-Mount einen Host-Pfad direkt im Container bereitstellt, kann der Container einen zugrunde liegenden Datenträger, ein Dateisystem, ein Mount-Flag oder eine Sicherheitsrichtlinie nicht selbst reparieren. Am sichersten ist es, Schreibvorgänge zu stoppen, den Container-Mount mit dem Host-Mount zu vergleichen, festzustellen, ob das schreibgeschützte Verhalten konfiguriert oder durch einen Fehler ausgelöst wurde, und den Zustand des Speichers wiederherzustellen, bevor die Anwendung neu gestartet wird.

Feststellen, welcher Pfad schreibgeschützt ist

Teste einen harmlosen Schreibvorgang im Container am Bind-Ziel und einen weiteren Schreibvorgang auf dem Host am Quellpfad. Notiere die genaue Fehlermeldung, statt anzunehmen, dass jeder Berechtigungsfehler auf ein schreibgeschütztes Dateisystem hindeutet.

Ein Docker-Forenfall zeigt, dass ein schreibgeschützter übergeordneter Bind-Mount Docker daran hindern kann, einen verschachtelten Mount-Punkt zu erstellen, weil das erforderliche Verzeichnis auf dem schreibgeschützten übergeordneten Dateisystem nicht erstellt werden kann.

Wenn der Host schreiben kann, der Container aber nicht, prüfe Docker-Mount-Optionen und Sicherheitskontrollen. Wenn beide mit einem Fehler wegen eines schreibgeschützten Dateisystems scheitern, ändere nicht weiter die Container-Benutzer, sondern setze die Diagnose beim Host-Mount und Speichergerät fort.

Die effektiven Docker-Mount-Flags prüfen

Prüfe die Konfiguration des laufenden Containers und nicht nur die aktuelle Compose-Datei. Bestätige Quelle, Ziel, Propagationsmodus und ob der Mount über :ro, die Langsyntax, eine Override-Datei oder ein Deployment-Tool als schreibgeschützt markiert ist.

Ein Docker-Client-Problem dokumentiert Fälle, in denen eingebundene Pfade schreibgeschützt erschienen, weil die Laufzeitkonfiguration von der vorgesehenen Einrichtung mit Lese- und Schreibzugriff abwich. Entscheidend ist der effektive Mount-Modus des laufenden Containers.

Wenn der Mount absichtlich schreibgeschützt ist, entferne diese Kennzeichnung nur, wenn die Anwendung tatsächlich Schreibzugriff benötigt. Erstelle den Container nach der Änderung der Deklaration neu, da eine Bearbeitung der Compose-Datei einen bestehenden Mount nicht nachträglich ändert.

Feststellen, ob der Host das Dateisystem schreibgeschützt erneut eingehängt hat

Prüfe die Mount-Tabelle des Hosts, das Kernel-Protokoll, das Speicherprotokoll und den Zustand des Dateisystems auf E/A-Fehler, Journal-Fehler, Prüfsummenfehler, Gerätezurücksetzungen oder ein schützendes erneutes Einhängen. Erzwinge kein erneutes Einhängen mit Lese- und Schreibzugriff, bevor du weißt, warum der Schutz aktiviert wurde.

Ein Unraid-Supportfall beschreibt, dass Docker-Appdata nicht mehr funktionierte, nachdem ein Dateisystem schreibgeschützt wurde, einschließlich Fehlern beim Erstellen von Plex-Verzeichnissen. Dieses Muster deutet eher auf einen Fehler im Host-Dateisystem als auf eine Berechtigungseinstellung des Containers hin.

Stoppen Sie betroffene Container und sichern Sie Diagnoseinformationen. Reparieren Sie Festplatte, Pool, Kabel, Dateisystem oder Journal über den vom System unterstützten Wartungsablauf. Vergewissern Sie sich anschließend, dass der Host-Pfad intakt ist, bevor Datenbank- oder Mediencontainer wieder darauf schreiben dürfen.

Single board computer zimaboard2

Verschachtelte und überlappende Mounts prüfen

Führen Sie alle Bind-Mounts und benannten Volumes auf, deren Zielpfad innerhalb eines anderen eingebundenen Verzeichnisses liegt. Überlappende Mounts können Verzeichnisse verdecken, unerwartetes Zugriffsverhalten übernehmen oder erfordern, dass Docker einen Mount-Punkt unter einem schreibgeschützten übergeordneten Verzeichnis erstellt.

Eine Diskussion auf Server Fault erklärt, dass die Überlagerung eines Lese- und Schreib-Mounts mit einem umfassenderen schreibgeschützten Mount an verwandten Container-Pfaden zu verwirrenden Ergebnissen führen kann. Da diese Domain bereits an anderer Stelle in diesem Stapel verwendet wird, gilt hier als praktische Regel: Erfassen Sie den vollständigen Zielverzeichnisbaum, bevor Sie Berechtigungen ändern.

Erstellen Sie erforderliche Host-Verzeichnisse, bevor Sie den Container starten. Vermeiden Sie es, ein beschreibbares Unterverzeichnis unter einem schreibgeschützten übergeordneten Verzeichnis einzubinden, wenn die Laufzeitumgebung es erstellen muss, und geben Sie persistente Pfade in Compose ausdrücklich an. Erstellen Sie den Container neu, nachdem Sie die Mount-Struktur vereinfacht haben.

Schreibgeschützten Zustand von Berechtigungen und Sicherheitsrichtlinien unterscheiden

Vergleichen Sie den Fehler aus einem Schreibtest mit Besitzer, Modus, ACL, SELinux-Label und AppArmor-Profil des Quellverzeichnisses sowie der Benutzer-ID des Containers. „Zugriff verweigert“ und „Dateisystem schreibgeschützt“ sind unterschiedliche Fehler und erfordern unterschiedliche Reparaturen.

Ein Leitfaden zur Speicherfehlerbehebung unterteilt Vorfälle mit schreibgeschützten Volumes in Mount-Flags, Dateisystemfehler, Sicherheitskontexte und Probleme mit Speichertreibern. Diese Einteilung hilft, eine unüberlegte Reaktion mit chmod 777 bei einem schreibgeschützten Zustand auf Speicherebene zu vermeiden.

Bei falschen Berechtigungen korrigieren Sie Besitzer oder ACLs auf dem Host mithilfe der vorgesehenen Container-UID und -GID. Ist das Dateisystem selbst schreibgeschützt, schlagen Berechtigungsänderungen fehl und dürfen nicht als Ersatz für eine Dateisystemreparatur dienen.

Anwendung erst neu starten, wenn ein Schreibtest auf dem Host erfolgreich ist

Schreiben, synchronisieren, lesen und löschen Sie eine temporäre Datei im Host-Pfad. Wiederholen Sie den Test anschließend in einem kurzlebigen Testcontainer mit derselben Mount-Deklaration und demselben Benutzer. Vergewissern Sie sich, dass das erwartete Dateisystem nach einem Neustart weiterhin eingebunden ist.

Wenn die Anwendung weiterhin in einer Neustartschleife läuft, nachdem der Speicher wieder beschreibbar ist, ist als Nächstes der ZimaSpace-Leitfaden zum Ermitteln einer Abhängigkeit für Container-Neustarts zu prüfen.

Die Reparatur ist erst abgeschlossen, wenn das Host-Dateisystem intakt ist, der effektive Docker-Mount konstruktionsbedingt Lese- und Schreibzugriff erlaubt, die Anwendung ihre persistenten Dateien aktualisieren kann und auch bei längerer Nutzung keine neuen E/A- oder Dateisystemfehler auftreten.

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.