„No space left on device“ trotz freiem Platz: Inodes
Kurz gesagt: Wenn ein Linux-Server „No space left on device“ meldet, obwohl df -h noch Gigabytes frei zeigt, sind meist nicht die Bytes aufgebraucht, sondern die Inodes. Jede Datei und jedes Verzeichnis belegt einen solchen Verwaltungseintrag, und auf vielen Dateisystemen ist ihre Zahl beim Anlegen festgelegt. Millionen winziger Dateien, etwa Sitzungsdateien, Cache-Schnipsel oder Mail-Warteschlangen, können die Inodes aufbrauchen, lange bevor die Platte voll ist. Mit df -i sehen Sie das in Sekunden. Danach geht es darum, den Verursacher zu finden, sicher aufzuräumen und dafür zu sorgen, dass er nicht nachwächst.
Was Inodes sind und warum sie ausgehen
Ein Dateisystem speichert den Inhalt einer Datei in Datenblöcken. Die Angaben über die Datei, also Eigentümer, Rechte, Zeitstempel und wo die Blöcke liegen, stehen in einem eigenen Eintrag, dem Inode. Die Linux-Handbuchseite inode(7) beschreibt diese Metadaten im Detail, darunter Inode-Nummer, Dateityp und Modus. Der Dateiname selbst steht übrigens nicht im Inode, sondern im Verzeichnis, das auf ihn verweist.
Auf dem verbreiteten Dateisystem ext4 wird die Anzahl der Inodes beim Formatieren festgelegt. Ist sie erreicht, kann keine neue Datei mehr entstehen, egal wie viel Platz frei ist. Das System liefert dann denselben Fehlercode wie bei voller Platte: ENOSPC, laut Handbuchseite errno(3) „No space left on device“. Genau deshalb ist die Meldung so irreführend.
Andere Dateisysteme verhalten sich anders. XFS und Btrfs vergeben Inodes dynamischer, dort tritt das Problem seltener in dieser Form auf. Welches Dateisystem Ihr Server nutzt, zeigt df -T.
Die Diagnose in zwei Befehlen
Der erste Blick gilt dem Vergleich von Bytes und Inodes:
df -h /
df -i /
Laut Handbuchseite df(1) listet die Option -i bzw. --inodes Inode-Informationen statt der Blockbelegung. Interessant ist die Spalte IUse%. Steht dort 100 Prozent, während Use% bei df -h deutlich darunter liegt, ist die Ursache klar.
Im zweiten Schritt suchen Sie das Verzeichnis mit den meisten Einträgen. Ein bewährter Weg ist, die Dateien pro Unterverzeichnis zu zählen, beginnend oben und dann Ebene für Ebene tiefer:
sudo find /var -xdev -type f | cut -d/ -f2-3 | sort | uniq -c | sort -n | tail
Neuere Versionen von GNU du können mit --inodes direkt Inodes statt Bytes zählen, etwa du --inodes -x -d 2 /var | sort -n | tail. Ob Ihre Version das kann, zeigt du --help. Der Befehl kann auf großen Verzeichnisbäumen eine Weile laufen, planen Sie ihn daher nicht mitten in der Hauptlast.
Typische Verursacher auf Web-Servern
In der Praxis tauchen immer wieder dieselben Kandidaten auf:
- PHP-Sitzungsdateien: Wenn die automatische Bereinigung alter Sitzungen nicht läuft, sammeln sich im Sitzungsverzeichnis Hunderttausende kleiner Dateien.
- Cache-Verzeichnisse von CMS und Plugins: Seiten-, Bild- oder Fragment-Caches legen oft für jede Variante eine eigene Datei an.
- Mail-Warteschlangen: Ein Formular, das an eine ungültige Adresse sendet, kann die Warteschlange des lokalen Mailservers mit unzustellbaren Nachrichten füllen.
- Temporäre Dateien von Uploads und Exporten, die nach einem Abbruch liegen bleiben.
- Alte Release-Ordner oder Abhängigkeiten, etwa viele Kopien von
node_modules, die jeweils Zehntausende Dateien enthalten. - Protokolle in sehr kleinen Stücken, wenn eine Anwendung pro Ereignis eine Datei schreibt.
Sicher aufräumen
Löschen Sie nie auf Verdacht ganze Verzeichnisse. Prüfen Sie zuerst, was dort liegt, wie alt es ist und welcher Dienst es schreibt. Ein Blick auf Beispieldateien mit ls -lt | head hilft.
Für alte Dateien ist find mit Altersgrenze das Werkzeug der Wahl, zuerst nur zur Anzeige:
find /pfad/zum/cache -type f -mtime +7 | head
find /pfad/zum/cache -type f -mtime +7 -delete
Bei Mail-Warteschlangen nutzen Sie die Werkzeuge des Mailservers, statt Dateien von Hand zu entfernen, sonst bleiben verwaiste Einträge zurück. Bei Sitzungsdateien sollten Sie nur deutlich abgelaufene Sitzungen entfernen, damit eingeloggte Kunden nicht plötzlich abgemeldet werden.
Beachten Sie: Ein rm mit sehr vielen Argumenten scheitert gern an der Meldung „Argument list too long“. Das -delete von find umgeht dieses Problem.
Dafür sorgen, dass es nicht wieder passiert
Aufräumen allein hilft nur für ein paar Wochen. Entscheidend ist, den Nachschub abzustellen:
- Aktivieren oder reparieren Sie die Bereinigung der Sitzungen. Bei manchen Linux-Distributionen übernimmt das ein eigener Zeitplan statt PHP selbst, prüfen Sie, ob er läuft.
- Begrenzen Sie Caches in der Konfiguration des CMS oder Plugins, oder lagern Sie sie in einen Speicher wie Redis aus, wenn Ihre Anwendung das unterstützt.
- Richten Sie für das Cache-Verzeichnis einen regelmäßigen Aufräumauftrag mit Altersgrenze ein.
- Beheben Sie die Ursache unzustellbarer Mails, etwa eine falsche Empfängeradresse im Formular.
- Nehmen Sie den Inode-Füllstand in Ihre Überwachung auf. Viele Monitoring-Werkzeuge melden standardmäßig nur die Belegung in Bytes.
Wird ein Dateisystem neu angelegt, lässt sich bei ext4 die Inode-Dichte beim Formatieren festlegen. Das ist aber eine Entscheidung für neue Server oder Datenträger, nicht für den laufenden Betrieb.
Beispiel zur Veranschaulichung
Ein Hamburger Onlinehändler (Beispiel zur Veranschaulichung) bekommt morgens die Nachricht, dass keine Bestellungen mehr eingehen. Im Fehlerprotokoll steht „No space left on device“, df -h zeigt aber 40 Prozent frei. df -i meldet 100 Prozent Inode-Belegung. Die Suche führt zum Bild-Cache eines Plugins, das für jede Größe und jedes Format eine eigene Datei angelegt hat, ohne je alte zu löschen. Nach dem Entfernen von Dateien, die älter als 30 Tage sind, läuft der Shop wieder. Ein nächtlicher Aufräumauftrag und ein Alarm ab 80 Prozent Inode-Belegung kommen dazu.
Typische Fehler
- Nur
df -hprüfen und daraus schließen, dass genug Platz da ist. - Unter Zeitdruck ganze Verzeichnisse löschen, ohne zu wissen, wer sie nutzt.
- Sitzungen aufräumen und damit alle angemeldeten Kunden abmelden.
- Das Symptom beheben, aber den Dienst, der Dateien erzeugt, unverändert lassen.
- Keine Überwachung der Inodes, sodass das Problem beim nächsten Mal wieder überraschend kommt.
Häufige Fragen
Kann ich die Zahl der Inodes im laufenden Betrieb erhöhen?
Bei ext4 in der Regel nicht ohne Neuformatieren. Realistisch sind Aufräumen, das Auslagern der vielen kleinen Dateien oder ein zusätzlicher Datenträger.
Warum zeigt der Server bei voller Inode-Belegung dieselbe Fehlermeldung wie bei voller Platte?
Beide Fälle liefern denselben Fehlercode ENOSPC. Die Anwendung erfährt nur, dass sie keine Datei anlegen kann, nicht warum.
Wie oft sollte ich den Inode-Füllstand prüfen?
Am besten automatisch, mit einer Warnschwelle deutlich unter 100 Prozent, damit Ihnen Zeit zum Handeln bleibt.
Sind Container davon auch betroffen?
Ja. Container teilen sich oft das Dateisystem des Hosts. Viele kleine Dateien in einem Container zählen auf die Inodes dieses Dateisystems.
Wenn Ihr Server trotz freiem Platz keine Dateien mehr anlegen kann und Sie die Ursache dauerhaft abstellen möchten, gehen wir die Diagnose gern gemeinsam durch: Server-Problem schildern.