Assurer des sauvegardes fiables est essentiel pour protéger votre infrastructure, que vous utilisiez Proxmox VE ou n'importe quelle système Linux
Avec Proxmox Backup Client, vous pouvez créer des sauvegardes complètes ou partielles et les stocker en toute sécurité sur un Proxmox Backup Server (PBS), y compris Cloud-PBS.
Pourquoi utiliser Proxmox Backup Client ?
Proxmox Backup Client est un outil léger qui peut être installé sur n'importe quelle distribution Linux, ou presque.
En quelques minutes, il vous permet de sauvegarder votre système directement sur une instance PBS et donc sur Cloud-PBS. Même si vos serveurs ne fonctionnent pas sur un hôte Proxmox VE, vous pouvez toujours bénéficier de la même infrastructure de sauvegarde.
Cet article vous guide à travers un exemple simple et fonctionnel pour vous aider à démarrer la sauvegarde de n’importe quel système Linux.
Pour suivre ce tutoriel, vous devez avoir Proxmox Backup Client installé et fonctionnel sur votre serveur. Vous pouvez lire notre guide d’installation ici.
💡 Si vous sauvegardez directement un hôte Proxmox VE, vous n’avez pas besoin d’installer le client, il est déjà intégré.
Fonctionnalités principales de Proxmox Backup Client
- Sauvegardes incrémentielles et dédupliquées – Rapides et économes en espace de stockage
- Chiffrement à la source – Les données sont chiffrées avant de quitter votre serveur
- Flexible – Sauvegardez n’importe quel dossier spécifique ou l’ensemble de votre système de fichiers
Comment sauvegarder votre système Linux ?
Création d'un token d'API
Créez d’abord un jeton API restreint sur votre datastore Cloud-PBS. Nous recommandons fortement de limiter les permissions au strict nécessaire. Dans ce cas, attribuez uniquement le rôle DatastoreBackup.

Assurez-vous d’enregistrer le nom et le secret du jeton dans un endroit sécurisé, vous en aurez besoin plus tard.
Configuration de votre serveur Linux
Sur votre hôte Linux, créez un répertoire de travail dans le dossier /etc
, puis placez-vous dedans :
mkdir /etc/pbc cd /etc/pbc
Créez maintenant un fichier config
contenant les variables d’environnement nécessaires au fonctionnement de Proxmox Backup Client :
export PBS_HOST="MY_PBS_URL" export PBS_PORT="8007" export PBS_USERNAME="MY_TOKEN_NAME" export PBS_PASSWORD="MY_TOKEN_SECRET" export PBS_DATASTORE="MY_DATASTORE" export PBS_NAMESPACE="" export PBS_FINGERPRINT="" export PBS_REPOSITORY="${PBS_USERNAME}@${PBS_HOST}:${PBS_PORT}:${PBS_DATASTORE}"
- Remplacez les valeurs d’exemple par vos informations.
- Tous les champs ne sont pas obligatoires (par exemple,
PBS_NAMESPACE
peut être laissé vide).
Ces variables d’environnement seront chargées avant l’exécution du script de sauvegarde.
Assurez-vous de protéger ce fichier en raison des données sensibles qu’il contient, comme la variable PBS_PASSWORD.
chmod 400 /opt/pbc/config
Références des variables
Variable | Description |
---|---|
PBS_HOST | L'IP ou FQDN de votre instance Cloud-PBS |
PBS_PORT | Le port PBS. Par défaut 8007 |
PBS_USERNAME | Le nom de votre token API. Dans notre exemple root@pam!proxmox-backup-client |
PBS_PASSWORD | Le secret de votre token |
PBS_DATASTORE | Le nom de votre datastore Cloud-PBS. (pbs sur les instances dédiées, une chaîne aléatoire sur les instances mutualisées). |
PBS_NAMESPACE | Namespace : optionnel pour organiser vos sauvegardes. Si vous le laissez vide, la sauvegarde sera stockée dans l’espace de noms à la racine de votre instance PBS. |
PBS_FINGERPRINT | L’empreinte SSL de votre Cloud-PBS (ou PBS). Si vous êtes utilisateur de Cloud-PBS, vous n’avez pas besoin de définir cette variable. |
Vous pouvez trouver l’empreinte PBS dans l’interface web de PBS si nécessaire.

Création du script de sauvegarde
Créez un script dans /etc/pbc/
pour exécuter vos sauvegardes :
touch /etc/pbc/run_pbc chmod u+x /etc/pbc/run_pbc
Éditez /etc/pbc/run_pbc
avec votre éditeur préféré et collez le contenu suivant
#!/usr/bin/env bash set -euo pipefail PBC_CFG_FILE="/etc/pbc/config" if [ "$( stat -c '%a' ${PBC_CFG_FILE} )" -ne "400" ]; then echo "permissions on ${PBC_CFG_FILE} need to be 400" exit 1 fi source ${PBC_CFG_FILE} proxmox-backup-client backup --ns="$PBS_NAMESPACE" root.pxar:/ 2>&1
Démarrez votre première sauvegarde
/etc/pbc/run_pbc
Votre hôte est maintenant entièrement sauvegardé, vous pouvez le vérifier dans le tableau de bord Cloud-PBS ou via l’interface web de PBS :

👉 Par défaut, Proxmox Backup Client ignore automatiquement certains points de montage (par ex. : /boot, /dev, /proc, /sys, /tmp).
Restauration d'une sauvegarde
Vous pouvez parcourir et restaurer vos sauvegardes soit via l’interface web de Proxmox Backup Server, soit directement en CLI avec Proxmox Backup Client.
Si vous souhaitez utiliser la CLI de PBC, vous devrez charger votre fichier de configuration afin de cibler automatiquement votre datastore.
List your snapshots first :
# Source your configuration file . /etc/pbc/config # List all backups proxmox-backup-client snapshot list # List last snapshots proxmox-backup-client list
La dernière commande doit retourner quelque chose comme

Parcourir et restaurer une sauvegarde
Ouvrez un snapshot
proxmox-backup-client catalog shell host/pve01-36/2025-08-25T09:58:35Z root.pxar
Une fois dans le shell, vous pouvez parcourir l'archive à l'aide de commandes Linux habituelles comme cd, find, ls, pwd
Pour restaurer l'archive complète dans /tmp/restore
pxar:/ > restore /tmp/restore
Selon la taille de votre sauvegarde, une restauration complète peut prendre un certain temps. Une fois terminée, vous pouvez quitter le shell et commencer à explorer vos fichiers restaurés dans le répertoire /tmp/restore
.
Il est également possible de restaurer un seul fichier avec la commande select dans le shell de Proxmox Backup Client (exemple avec le fichier /etc/hostname
)
proxmox-backup-client catalog shell host/rocky9/2025-06-24T21:31:16Z root.pxar pxar:/ > select /etc/hostname added path: "/etc/hostname" pxar:/ > restore-selected /tmp/restore-hostname
Vous retrouverez ensuite votre fichier /etc/hostname
dans le répertoire /tmp/restore-hostname
de votre hôte
root@pve01-36 /etc/pbc # tree /tmp/restore-hostname/ /tmp/restore-hostname/ └── etc └── hostname 2 directories, 1 file
Conclusion
En seulement quelques étapes, vous pouvez protéger n’importe quel système Linux (Proxmox ou non) en utilisant Proxmox Backup Server et Cloud-PBS.
Proxmox Backup Client rend les sauvegardes efficaces, automatisables et fiables. Que vous ayez besoin de restaurer un système complet ou un seul fichier, tout est accessible en une simple commande.