Was führt dazu, dass ein Container die Systemfestplatte füllt, obwohl seine Daten woanders gespeichert sind?

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 die Systemfestplatte füllen, wenn Protokolle, Caches, temporäre Dateien oder versehentliche Schreibvorgänge im lokalen Docker-Speicher verbleiben.

Das Verschieben einer Medienbibliothek oder eines Datenbank-Volumes in einen anderen Pool verschiebt weder das Container-Image noch die beschreibbare Ebene, das JSON-Protokoll, den BuildKit-Cache, die Metadaten oder Pfade, die in der Liste der Einbindungen fehlen. Auch eine fehlgeschlagene externe Einbindung kann dazu führen, dass das erwartete Host-Verzeichnis leer bleibt und die Anwendung neue Daten auf die Systemfestplatte schreibt, ohne einen offensichtlichen Fehler anzuzeigen.

Den Docker-Stammordner prüfen, bevor Sie Anwendungsdaten untersuchen

Prüfen Sie das Dateisystem, auf dem sich Docker’s Datenstammordner befindet, und vergleichen Sie die Größen der Host-Verzeichnisse mit der Docker-Abrechnung für Images, Container, Volumes und Build-Cache. Halten Sie die Belegung fest, bevor Sie etwas löschen.

Ein Cloudron-Nutzer stellte fest, dass /var/lib/docker/overlay2 mehr Speicherplatz belegte als alle sichtbaren Anwendungsdaten. Das zeigt, warum der Docker-Speicherstammordner unabhängig von externen Bibliotheken überprüft werden muss.

Wenn die Systemfestplatte voll ist, der externe Pool aber noch Platz hat, ermitteln Sie, ob der Speicherplatz in Containern, Overlay-Ebenen, Volumes, Images oder dem Build-Cache belegt wird. Führen Sie keinen pauschalen Bereinigungsvorgang aus, bevor aktive und wiederherstellbare Daten eingeordnet sind.

Unbegrenztes Wachstum von Container-JSON-Protokollen prüfen

Prüfen Sie den Protokolltreiber und die Größe der Protokolldatei jedes Containers. Ein Dienst kann seine primären Daten anderswo speichern, während stdout und stderr im lokalen Containerverzeichnis von Docker unbegrenzt anwachsen.

Code Maven dokumentiert einen Fall, in dem docker system df das Hauptproblem nicht erkennen ließ, weil die Standard-Protokolldatei immer weiter anwuchs und in dieser Übersicht nicht erfasst wurde. Der versteckte Speicherfresser war ein immer weiter wachsendes Containerprotokoll.

Finden und beheben Sie den fehlerhaften Anwendungsvorgang, der die Protokolle aufbläht, bevor Sie sie rotieren oder kürzen. Richten Sie für künftige Container eine begrenzte Protokollrotation ein und prüfen Sie, ob die neuen Dateien nicht über die erwartete Grenze hinaus wachsen.

Daten finden, die in die beschreibbare Ebene des Containers geschrieben werden

Vergleichen Sie die vorgesehenen persistenten Pfade mit den tatsächlichen Verzeichnissen der Anwendung für Cache, Transkodierung, Downloads, Datenbank, Miniaturansichten, Sicherungen und temporäre Dateien. Jeder nicht eingebundene Schreibpfad verbleibt in der beschreibbaren Ebene des Containers auf der Systemfestplatte.

Eine Erklärung in einem Docker-Forum weist darauf hin, dass Schreibvorgänge und geänderte Image-Dateien in der beschreibbaren Ebene gespeichert werden, während große, nicht rotierte Protokolle in den Container-Metadaten liegen. Beides kann dazu führen, dass ein Container fast den gesamten lokalen Speicher belegt, obwohl ein externes Datenvolume eingebunden ist.

Verwenden Sie die Größenangaben pro Container und prüfen Sie die größten geänderten Pfade im Container. Fügen Sie explizite Bind-Mounts oder benannte Volumes nur für Daten hinzu, die erhalten bleiben müssen, und erstellen Sie den Container neu, um veraltete Inhalte der beschreibbaren Ebene zu verwerfen, nachdem Sie alles Wertvolle gesichert haben.

Vergewissern Sie sich, dass der externe Mount beim Start des Containers vorhanden war

Prüfen Sie, ob die SSD, NAS-Freigabe oder der Speicherpool am erwarteten Host-Pfad eingebunden war, bevor Docker den Container gestartet hat. Vergleichen Sie die Gerätekennung und die Mount-Ausgabe mit dem Verzeichnis, das der Container sieht.

Wenn ein externer Mount fehlt, ist das zugrunde liegende leere Verzeichnis auf dem Systemdateisystem möglicherweise weiterhin vorhanden. Der Container kann normal in dieses Ausweichverzeichnis schreiben, wodurch der Systemdatenträger voller wird, während der externe Pool unverändert scheint.

Stoppen Sie den Container, bevor Sie den Speicher über vorhandene Ausweichdaten mounten. Verschieben oder bereinigen Sie die verborgenen Dateien sicher, fügen Sie Mount-Abhängigkeiten oder Startprüfungen hinzu und verhindern Sie den Anwendungsstart, wenn das erwartete Gerät fehlt.

Prüfen Sie Image-Layer, Build-Cache und verwaiste Objekte

Prüfen Sie ungenutzte Images, gestoppte Container, anonyme Volumes und den BuildKit-Cache. Häufige Aktualisierungen oder lokale Builds können zahlreiche Layer ansammeln, selbst wenn die persistenten Anwendungsdaten korrekt an anderer Stelle eingebunden sind.

Eine Erklärung im Moby-Projektforum erläutert, dass Overlay-Mounts die Speicherplatzangaben verwirrend machen können und die Nutzung des zugrunde liegenden Dateisystems sorgfältig interpretiert werden muss. Auch ein separater Fall mit Home Assistant zeigte im Laufe der Zeit ein Wachstum von overlay2 durch Protokolle und Layer.

Entfernen Sie nur Objekte, deren Nichtverwendung durch aktuelle Compose-Projekte und Backups bestätigt wurde. Löschen Sie niemals einzelne overlay2-Verzeichnisse manuell, da dadurch Docker-Metadaten inkonsistent werden können.

Validieren Sie die Korrektur anhand eines Wachstums-Baselines

Erfassen Sie nach der Korrektur des verantwortlichen Pfads während der Arbeitslast, die zuvor das Wachstum verursacht hat, in regelmäßigen Abständen die Docker-Root-Auslastung, Protokollgrößen, beschreibbaren Containergrößen und die Auslastung des externen Pools.

Der ZimaSpace-Workflow zum Vorbereiten einer großen NAS-Datenübertragung bietet eine reproduzierbare Last, um zu bestätigen, dass die Daten auf dem vorgesehenen Pool landen.

Das Problem ist erst dann behoben, wenn das Wachstum des Systemdatenträgers dem erwarteten Verhalten von Image und Protokollen entspricht, persistente Anwendungsdaten auf dem externen Pool wachsen und ein fehlender externer Mount zu einem sicheren Startabbruch statt zu unbemerkten Schreibvorgängen auf dem Root-Dateisystem führt.

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.