Comment configurer la synchronisation depuis un Proxmox Backup Server distant
Dernière mise à jour: 2 juin 2025
Introduction
Avec Proxmox Backup Server, vous pouvez configurer la synchronisation pour permettre à un serveur distant de récupérer (pull) ou pousser (push) des sauvegardes depuis un autre serveur.
Par exemple :
-
Vous utilisez Proxmox Backup Server on premise comme datastore principal
-
Vous avez également une instance Cloud-PBS. Vous pouvez ajouter un utilisateur spécifique sur votre instance Cloud-PBS, attribuer des permissions à cet utilisateur et configurer une synchronisation planifiée depuis votre propre Proxmox Backup Server vers Cloud-PBS.
La synchronisation bidirectionnelle (pull et/ou push) n’est disponible que sur les instances dédiées. Si vous souhaitez récupérer (pull) des données depuis votre serveur vers Cloud-PBS.com, préférez une instance dédiée. Pull ET push : Instances dédiées Push uniquement : Offres Datastore
Configuration On Premise vers Cloud-PBS
Cette configuration vous permet d’exporter facilement vos données Proxmox Backup Server existantes vers Cloud-PBS, rendant vos données encore plus sécurisées.
C’est la configuration la plus courante chez les utilisateurs Cloud-PBS. Elle vous permet de pousser vos données depuis votre serveur vers Cloud-PBS.
Le push est une fonctionnalité très intéressante, car elle est facile à implémenter et nécessite peu de modifications réseau (au maximum, autoriser le port 8007 vers votre instance Cloud-PBS).
Commençons par nous connecter à votre serveur PBS et configurer la partie Remote :

-
Sélectionnez l’onglet Remotes.
-
Ajoutez une nouvelle cible distante.
-
Entrez un Remote ID, ajoutez le nom de votre choix.
-
Configurez le Host à partir de l’email que vous avez reçu.
-
Dans le champ Auth ID, ajoutez le nom d’utilisateur que vous avez reçu, ou utilisez un token si vous avez activé le 2FA.
-
Enfin, ajoutez votre mot de passe ou le secret de votre token.
Pas besoin de configurer le fingerprint, car votre instance Cloud-PBS utilise des certificats reconnus. L’utilisateur Cloud-PBS configuré a besoin au minimum de la permission
Datastore.Backuppour pousser sur votre instance (le nom d’utilisateur par défaut fonctionne déjà).
Maintenant, il ne reste plus qu’à configurer la tâche de push comme sur l’écran ci-dessous :

-
Sélectionnez votre datastore on prem
-
Sélectionnez l’onglet Sync Jobs
-
Ajoutez une nouvelle tâche
-
Sélectionnez votre Local User
-
Choisissez la fréquence de synchronisation. Par défaut : 1 heure
-
Sélectionnez votre Target Remote. C’est la cible configurée à l’étape précédente
-
Puis sélectionnez votre Target Datastore.
-
Ajoutez votre tâche de synchronisation et voilà.
Une fois la tâche configurée, vous pouvez la lancer manuellement en utilisant le bouton Run now dans l’onglet Sync Job
Référence de configuration d’un sync job
La configuration d’un sync job Proxmox Backup Server couvre quatre domaines : le datastore source, la cible distante (remote) et son datastore, la planification, et les options de transfert. Chaque paramètre listé ci-dessous correspond directement à la commande CLI proxmox-backup-manager sync-job et à l’entrée associée dans /etc/proxmox-backup/sync.cfg.
| Paramètre | Description | Valeur par défaut |
|---|---|---|
id | Identifiant unique du sync job | requis |
store | Datastore source sur le PBS local | requis |
remote | Cible distante configurée | requis |
remote-store | Datastore cible sur le PBS distant | requis |
ns / remote-ns | Namespace source / cible | namespace racine |
schedule | Calendar event systemd | exécution manuelle |
owner | Utilisateur PBS propriétaire des données synchronisées | root@pam |
remove-vanished | Supprime les snapshots qui n’existent plus à la source | false |
transfer-last | Ne synchronise que les N groupes de backup les plus récents | illimité |
rate-in / rate-out | Limite de bande passante du sync, en octets par seconde | illimité |
comment | Description libre affichée dans l’interface | vide |
Pour la référence complète, consultez la documentation officielle de Proxmox Backup Server sur les sync jobs : pbs.proxmox.com/docs/sync.html.
Format de planification et fréquence
Le paramètre schedule accepte tout calendar event systemd. Motifs courants :
hourly: toutes les heures à l’heure piledaily: tous les jours à 00:00*-*-* 02:00:00: tous les jours à 02:00 heure localeMon..Fri 09:00:00: du lundi au vendredi à 09:00*:0/15: toutes les 15 minutes
Validez une planification avant de la déployer :
systemd-analyze calendar "votre-planification"
Le scheduler de Proxmox Backup Server relit /etc/proxmox-backup/sync.cfg toutes les minutes. Un changement de planification est donc effectif au plus tard une minute après que proxmox-backup-manager sync-job update ait retourné.
Sync jobs en mode pull vs push
Proxmox Backup Server prend en charge deux directions de synchronisation :
- Push : le PBS source initie la connexion et envoie les sauvegardes vers le remote. Seul le TCP 8007 sortant depuis la source est requis. Le push est disponible sur toutes les offres Cloud-PBS (Shared, Dedicated, on-premise).
- Pull : le PBS cible initie la connexion et télécharge les sauvegardes depuis le remote. Le TCP 8007 entrant sur la source est requis. Sur Cloud-PBS, le mode pull est disponible uniquement sur les offres Dedicated.
Si votre objectif est d’envoyer des données depuis un PBS on-premise vers Cloud-PBS, le mode push est la configuration standard décrite dans la section précédente. Pour répliquer entre deux instances Cloud-PBS ou entre deux serveurs PBS on-premise, les deux modes fonctionnent.
La forme CLI est identique :
# Sync job push
proxmox-backup-manager sync-job create push-vers-cloudpbs \
--store local-store \
--remote cloud-pbs \
--remote-store remote-store \
--schedule "daily" \
--sync-direction push
# Sync job pull
proxmox-backup-manager sync-job create pull-depuis-cloudpbs \
--store local-store \
--remote cloud-pbs \
--remote-store remote-store \
--schedule "daily" \
--sync-direction pull
Dépannage des sync jobs
Erreurs courantes lors de la configuration d’un sync job :
failed to authenticate: le token API ou le mot de passe utilisé dans la configuration du remote a expiré ou ne dispose pas du privilègeDatastore.Backup. Recréez le token et accordez le privilège au niveau du datastore sur le remote.connection refused: le TCP 8007 sortant est bloqué à la source. Ouvrez-le dans le pare-feu de la source et vérifiez le routage vers l’instance Cloud-PBS.backup owner check failed: couvert en détail dans notre guide dédié.- Le sync s’exécute mais ne transfère rien : vérifiez le paramètre
ns(namespace) des deux côtés. Une incompatibilité de namespace ignore silencieusement tous les groupes. - Le sync est lent : vérifiez
rate-inetrate-outsur la tâche, ainsi que la bande passante réseau sous-jacente. Les endpoints régionaux Cloud-PBS sont documentés dans l’email de bienvenue.
Pour le catalogue complet des erreurs et la référence CLI, consultez la documentation officielle des sync jobs Proxmox Backup Server à pbs.proxmox.com/docs/sync.html et la page de manuel man proxmox-backup-manager.