Proxmox VE: NFS-Backup stoppt bei Stale file handle

Proxmox VE: NFS-Backup stoppt bei Stale file handle

Bei vielen Kommunen und KMU läuft Proxmox VE mit Backup-Zielen auf NAS-Systemen per NFS. Nach einem Neustart des NAS oder bei unregelmäßigen Timeouts bricht der Backup-Job mit der Meldung Stale file handle (ESTALE) ab. Das Problem ist kein Datenverlust, aber es blockiert automatisierte Sicherungen.

Ursache

Ein Stale file handle entsteht, wenn der NFS-Server seine Inodes neu vergibt, also nach einem Reboot oder Export-Neustart. Der Proxmox-Host behält die alten File-Handles im Kernel-Cache, der Zugriff auf die freigegebene Verzeichnisstruktur scheitert deshalb. Besonders betroffen sind unprivilegierte LXC-Container und Jobs, die lange Mounts offen halten.

Typische Auslöser in der Praxis sind Synology- oder TrueNAS-Boxen, die nachts neu gestartet werden, S.M.A.R.T.-Scans oder Stromsparmodi. Proxmox 8.x mit NFSv4 verstärkt das Problem bei fehlenden stabilen Optionen in /etc/fstab.

Diagnose

Prüfen Sie zunächst den Backup-Log in der Proxmox-Weboberfläche. Dort steht ERROR: backup failed - stale file handle. Auf der Shell zeigt dmesg | grep nfs ESTALE-Einträge.

Führen Sie einen manuellen Mount-Check aus:

showmount -e <NAS-IP>
cat /proc/mounts | grep nfs
mount -t nfs -o vers=4.2,noserverino <NAS-IP>:/volume1/backup /mnt/backup

Wenn ls /mnt/backup nach dem NAS-Reboot hängen bleibt, ist der Handle veraltet. df -h zeigt den Mount weiterhin als aktiv.

Lösung

Entfernen Sie das defekte Mount und bauen Sie es mit stabilen Optionen neu auf. Für Debian-basierte Proxmox-Hosts empfehlen sich:

umount -lf /mnt/backup
mount -t nfs -o vers=4,soft,timeo=600,retrans=3,noserverino <NAS-IP>:/volume1/backup /mnt/backup

Für dauerhafte Einträge in /etc/fstab:

<NAS-IP>:/volume1/backup /mnt/backup nfs vers=4,soft,timeo=600,retrans=3,noserverino,noatime 0 0

Der Parameter noserverino verhindert das Caching von Server-Inodes, soft bricht hängende Operationen nach Timeout ab statt das System zu blockieren. Nach der Änderung den Proxmox-Backup-Speicher neu anlegen und einen Test-Backup-Job starten.

Alternative für bestehende Infrastruktur ist der Wechsel auf SMB3 mit stabilen Shares oder der Einsatz von Proxmox Backup Server über dediziertes Netzwerk. Beides reduziert ESTALE-Fälle deutlich.

Fazit

Stale file handle ist in Proxmox-Umgebungen mit NFS kein Einzelfall, sondern ein bekanntes Betriebsrisiko. Mit korrekten Mount-Optionen, regelmäßigen Health-Checks des NAS und sauberem Unmount nach Wartungsfenstern lässt sich die Fehlerquote senken. Dokumentieren Sie die Änderung im Betriebshandbuch, damit Nachfolger die Konfiguration nachvollziehen können.

Quellen

Proxmox Forum: Deutsch Proxmox Backup funktioniert einmal und danach nicht mehr – 12.12.2023

Proxmox Forum: Backup LXC-Container – noserverino als Lösung für Stale file handle – 28.01.2024

Homeserverlab: NFS vs SMB – Stale file handle nach Server-Neustart – 10.04.2026

Hinweis: Dieser Beitrag wurde mit Unterstützung künstlicher Intelligenz (KI) erstellt.