Aller au contenu

PBS : restaurer un fichier unitaire

RB-13Toutes architecturesNiveau 15 à 10 minQui : Client / Client / MSP

Objectif. Récupérer un fichier ou un dossier depuis une sauvegarde, sans restaurer toute la VM.

Étapes depuis l'interface PVE (VM et conteneurs)

  1. Stockage PBS → Backups, sélectionner la sauvegarde à la bonne date.
  2. Cliquer File Restore. Une arborescence s'affiche : disques, puis partitions, puis dossiers.
  3. Naviguer jusqu'au fichier ou au dossier, puis Download. Un dossier est téléchargé sous forme d'archive (zip ou tar.zst au choix).
  4. Remettre le fichier en place dans la VM (partage réseau, SCP, glisser-déposer dans la session distante).

Pour une VM, l'ouverture prend 10 à 30 secondes : PBS démarre une petite machine de lecture temporaire qui monte les disques en lecture seule.

Depuis l'interface PBS (conteneurs et sauvegardes de fichiers d'hôte)

Datastore → Content → déplier la sauvegarde → icône de dossier (Browse) sur l'archive .pxar.

CLI (avancé)

proxmox-file-restore list "vm/101/2026-10-22T22:00:00Z" / --repository <user@realm>@<pbs>:<datastore>
proxmox-file-restore extract "vm/101/2026-10-22T22:00:00Z" /drive-scsi0.img.fidx/part/2/home/user/fichier.docx /tmp/ --repository ...

Systèmes de fichiers. Les systèmes courants sont lisibles (ext4, XFS, NTFS, ainsi que LVM et ZFS dans la plupart des cas).

Vérifications

Le fichier récupéré s'ouvre et date bien du point de restauration attendu.

Pièges vus en support

  • Volumes chiffrés dans la VM (BitLocker, LUKS) : contenu illisible depuis File Restore. Restaurer la VM sous un nouvel ID (RB-12) et récupérer le fichier depuis l'OS.
  • Disques dynamiques Windows ou Storage Spaces : même contournement.
  • Pour un fichier très récent, vérifier l'heure de la sauvegarde : un fichier créé après la dernière sauvegarde n'existe dans aucune.
  • Les droits NTFS ou POSIX ne sont pas conservés par le téléchargement : les réappliquer après remise en place.

Quand ouvrir un ticket iTop

File Restore qui échoue sur toutes les sauvegardes d'une VM, fichier introuvable dans la rétention locale (la copie MSP peut aller plus loin dans le temps, voir RB-15) : P3. Joindre l'ID de la VM, le chemin du fichier, la date visée.

Ouvrir un ticket iTop pour RB-13 Que joindre au ticket ?


Rubrique : Proxmox Backup Server · Architecture : Toutes · Rédigé pour PVE 9.x, PBS 4.x, Ceph 19.2 · Brouillon à valider en lab avant publication · Documentation officielle : PVE · PBS