Einzelne Datei aus VM-Backup wiederherstellen (File Restore)

Klassisches Szenario: Jemand hat eine wichtige Datei in einer VM versehentlich gelöscht. Du willst nicht die ganze VM zurückspielen — nur diese eine Datei. PBS kann VM-Backups öffnen, die Dateisysteme darin lesbar machen und einzelne Dateien extrahieren. Im PVE 8+ geht das direkt aus der GUI.

Voraussetzungen

• Proxmox VE 7.2 oder neuer
• Backup wurde nicht im Live-Restore-Modus erstellt (was beim normalen Backup-Job nie passiert)
• Datei-System der VM ist eines der unterstützten (ext4, xfs, btrfs, NTFS, vfat — die wichtigsten)

File Restore über die PVE-GUI

1. Im PVE-Tree die Backup-Übersicht öffnen — entweder über die VM oder über Storage → \<pbs-storage\> → Content.
2. Den passenden Snapshot auswählen (Datum/Zeit).
3. File Restore klicken (Button unten rechts).

Es öffnet sich ein Dateibrowser:

• Du siehst die Disk-Images des Backups (z.B. drive-scsi0.img).
• Klick auf das Image → Du siehst die Partitionen, dann die Verzeichnisse darin, schließlich die Dateien.
• Pro Datei oder Ordner kannst Du Download anklicken — die Datei wird lokal heruntergeladen.

Bei großen Ordnern wird automatisch ein ZIP gepackt und zum Download bereitgestellt.

File Restore über die CLI

Wenn Du in der Konsole arbeitest oder die GUI gerade nicht verfügbar ist:

# Snapshot finden
proxmox-backup-client snapshot list <datastore> --repository <user>@pbs@<server>:<datastore>

# Mountet das Backup als read-only Filesystem unter /run/proxmox-backup-fuse
proxmox-backup-client mount \
  vm/100/2026-05-08T02:00:00Z \
  drive-scsi0.img \
  --repository 12345@pbs@pbs01.xaweho.de:12345 \
  /tmp/restore-mount/

# Die Datei kopieren
cp /tmp/restore-mount/etc/important.conf /tmp/recovered.conf

# Mount aufheben
proxmox-backup-client unmount /tmp/restore-mount/

Der Mount ist read-only — Du kannst nichts kaputt machen.

File Restore aus verschlüsseltem Backup

Wenn Dein Backup mit clientseitiger Verschlüsselung erstellt wurde, brauchst Du den Schlüssel:

proxmox-backup-client mount \
  vm/100/2026-05-08T02:00:00Z \
  drive-scsi0.img \
  --repository 12345@pbs@pbs01.xaweho.de:12345 \
  --keyfile /etc/pve/priv/storage/xaweho-pbs.enc \
  /tmp/restore-mount/

In der GUI erkennt PBS das automatisch und fragt nach dem Schlüssel-Pfad.

File Restore aus Container-Backups

Bei LXC-Containern ist es einfacher: PBS sichert Container als ein einziges TAR-Archiv. Du kannst es direkt entpacken:

proxmox-backup-client restore \
  ct/200/2026-05-08T02:00:00Z \
  root.pxar \
  /tmp/container-restore/ \
  --repository 12345@pbs@pbs01.xaweho.de:12345

Im Verzeichnis /tmp/container-restore/ liegt dann das komplette Root-Filesystem des Containers — Du suchst die Datei und kopierst sie zurück.

Best Practices

• VM-File-Restore ist read-only. Du kannst aus dem Backup lesen, aber nicht schreiben — was Du extrahierst, kopierst Du in die laufende VM zurück (per SSH, per Drag-and-Drop in der Console, je nach Setup).
• Bei großen Dateien: Download über die GUI ist okay bis ~5 GB. Größere Datenmengen besser per CLI mit Mount + rsync zurück in die VM.
• Bei Windows-VMs: NTFS wird unterstützt, aber NTFS-spezifische Berechtigungen bleiben nicht erhalten. Wenn Du eine ganze Windows-Installation zurückspielen willst — dann doch VM-Restore.
• Mount-Operation hält Disk-Image im PBS-Cache offen. Räume das nach Gebrauch auf (proxmox-backup-client unmount), sonst gibt’s nach längerer Zeit Speicher-Leaks im Browser-Cache.

Häufige Fragen

Welche Filesysteme werden unterstützt? ext2/3/4, xfs, btrfs (read-only), vfat, NTFS (read-only). LVM-Volumes innerhalb der VM werden auch erkannt. Bei verschlüsselten Volumes (LUKS, BitLocker) brauchst Du das VM-interne Passwort — was PBS nicht hat.

Kann ich auch ganze Verzeichnisse herunterladen? Ja. In der GUI auf einen Ordner rechtsklicken → “Download as ZIP”. Bei sehr großen Verzeichnissen (~10 GB+) packt das Browser-Memory zu — dann lieber per CLI mit rsync.

Klappt das auch bei einer laufenden VM? Ja. Der Backup-Snapshot ist immutable — Du arbeitest mit dem Backup-Stand zum Snapshot-Zeitpunkt, die laufende VM ist davon unbeeinflusst.

Mehrere Dateien gleichzeitig — wie? In der GUI: mehrere Dateien selektieren (Strg+Klick), dann “Download as ZIP”. In der CLI: cp -r aus dem Mount.

Kann ich das auch aus einem PBS-Backup eines Windows-Servers? Ja. NTFS-Dateisysteme werden gelesen, Du siehst die Verzeichnisstruktur. Berechtigungen und ACLs gehen aber verloren — beim Zurückkopieren in die laufende VM nimmst Du die Datei in einen Ordner mit korrekten Rechten.

Was, wenn die VM ZFS oder LVM-Thin verwendet hat? ZFS: read-only-Mount funktioniert. LVM-Thin: PBS erkennt LVM-Volumes und zeigt sie. Bei beiden brauchst Du keine VM-interne Mount-Logik — PBS kümmert sich darum.

Weiter geht’s

• Komplette VM zurückspielen
• Backup-Übersicht im PBS verstehen