proxmox-backup-client : guide d'installation pour Debian et Ubuntu

proxmox-backup-client est l’outil en ligne de commande officiel de l’équipe Proxmox pour sauvegarder un hôte Debian ou Ubuntu vers un Proxmox Backup Server. Il est distribué sous forme de paquet Debian sur le miroir APT Proxmox ; cette page est la procédure d’installation canonique.

Si vous utilisez déjà un hôte Proxmox VE ou un Proxmox Backup Server, proxmox-backup-client est déjà installé.

Pas sur Debian ou Ubuntu ? Pour Rocky Linux, AlmaLinux, RHEL, Fedora, Alpine, Arch, openSUSE, voir notre guide étendu : Installer Proxmox Backup Client sur Linux non-Debian.

Ajouter le dépôt Proxmox

En vous basant sur la documentation officielle, vous devez ajouter le dépôt pbs-client correspondant à votre version de Debian. Le même dépôt fonctionne aussi sur la version Ubuntu correspondante.

Version Debian	Ligne du dépôt
12 (bookworm)	deb http://download.proxmox.com/debian/pbs-client bookworm main
11 (bullseye)	deb http://download.proxmox.com/debian/pbs-client bullseye main
10 (buster)	deb http://download.proxmox.com/debian/pbs-client buster main

Par exemple sur un hôte Debian 12 :

echo "deb http://download.proxmox.com/debian/pbs-client bookworm main" \
  > /etc/apt/sources.list.d/pbs-client.list

Ajouter la clé de signature

wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg \
  -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg

Remplacez bookworm par le nom de code correspondant à votre version (bullseye, buster).

Installer le client

apt update
apt install proxmox-backup-client

Le client est désormais prêt à sauvegarder votre hôte Debian ou Ubuntu.

Créer un token API avant de commencer

Avant de lancer votre première sauvegarde, créez un token API PBS sur votre Proxmox Backup Server pour permettre au client de s’authentifier sans interaction. Voir Créer un token pour authentifier votre PVE pour la procédure pas à pas.

Première sauvegarde

Une sauvegarde minimale de / depuis l’hôte :

proxmox-backup-client backup root.pxar:/ \
  --repository user@pbs!token@votre-instance-cloud-pbs:store

Pour la référence complète des commandes (list, restore, prune, mount), voir la documentation officielle Proxmox Backup Client.

Questions fréquentes

Qu’est-ce que proxmox-backup-client ?

proxmox-backup-client est le client en ligne de commande qui dialogue avec un Proxmox Backup Server. Il découpe, déduplique, chiffre optionnellement côté client, et téléverse les données vers un datastore PBS en HTTPS. C’est exactement le même outil qui tourne dans les jobs vzdump sur les hôtes Proxmox VE, packagé séparément pour pouvoir être utilisé depuis n’importe quel hôte Linux.

Où proxmox-backup-client est-il installé ?

Le paquet APT installe le binaire dans /usr/bin/proxmox-backup-client et tire ses dépendances (libssl, librrd, etc.) automatiquement. La configuration est par utilisateur : chaque invocation lit --repository, --ns et les identifiants depuis la ligne de commande ou des variables d’environnement.

Comment vérifier la version de proxmox-backup-client ?

proxmox-backup-client version

Cette commande affiche la version installée et confirme que le binaire est accessible. La branche majeure actuelle est 3.x, alignée sur les releases Proxmox Backup Server.

Quelle est la différence entre proxmox-backup-client et proxmox-backup-client-static ?

proxmox-backup-client (cette page) est le paquet Debian classique, à liaison dynamique, dont les dépendances sont tirées par APT. proxmox-backup-client-static est un paquet distinct qui fournit un binaire à liaison statique sans dépendance d’exécution, prévu pour être copié sur des hôtes Linux non-Debian. Les deux binaires parlent le même protocole PBS ; la différence est purement opérationnelle.

proxmox-backup-client fonctionne-t-il sur Ubuntu ?

Oui. Ubuntu partage la stack APT et la glibc de Debian, donc le même dépôt pbs-client est utilisé. Faites correspondre le nom de code Debian à votre base Ubuntu : bookworm pour Ubuntu 24.04 / 22.04, bullseye pour Ubuntu 20.04. Testé jusqu’à Ubuntu 24.04 LTS au moment de la rédaction.

proxmox-backup-client fonctionne-t-il sur Rocky Linux, Fedora, Alpine ou un autre Linux non-Debian ?

Pas via APT, mais oui via deux voies supportées : copier le binaire proxmox-backup-client-static depuis un hôte Debian, ou exécuter un conteneur Debian. Voir le guide étendu pour Linux non-Debian.

Comment désinstaller proxmox-backup-client ?

apt remove proxmox-backup-client
rm /etc/apt/sources.list.d/pbs-client.list
rm /etc/apt/trusted.gpg.d/proxmox-release-*.gpg
apt update

Ces commandes retirent le binaire et la configuration du dépôt APT. Les sauvegardes existantes côté Proxmox Backup Server ne sont pas touchées par la désinstallation du client.