Externalisation hors ligne des backups Proxmox

Contexte

Pour des raisons de sécurité, les sauvegardes doivent être externalisées sur des disques externes. L’objectif est double :

• garder une copie hors ligne, physiquement isolée du site ;
• pouvoir remonter l’infrastructure rapidement en cas d’incident majeur.

Les contraintes

Contrainte	Détail
Volumétrie	Plus de 20 To de sauvegardes
Cloisonnement	Plusieurs réseaux à sauvegarder séparément
Disponibilité	Le disque ne doit être monté que sur une plage horaire définie

La solution retenue

Les sauvegardes sont découpées en deux namespaces sur le serveur Proxmox Backup Server (PBS) :

1. Reseau A
2. Reseau B

Chaque namespace est externalisé sur son propre disque de 24 To. Deux disques ont donc été achetés — ce qui représente un budget conséquent en 2026.

Portée de cette page

La procédure ci-dessous décrit la mise en place pour un seul disque. Elle est à rejouer à l’identique pour chaque disque supplémentaire (second réseau, disques de rotation, etc.).

Prérequis

Matériel

• Un serveur Proxmox Backup Server opérationnel.
• Un ou plusieurs disques externes dimensionnés pour la volumétrie à externaliser.
• Un accès root en SSH sur le PBS.

Paquets

PBS est basé sur Debian : la plupart des outils sont déjà présents, mais gdisk et les outils du système de fichiers choisi doivent généralement être installés.

apt update
apt install -y gdisk btrfs-progs

Paquet	Fournit	Utilisé pour
gdisk	gdisk	Créer la table de partition GPT
btrfs-progs	mkfs.btrfs, btrfs	Formater et étiqueter le disque
util-linux	lsblk, mount, umount, findmnt, mountpoint, blkid	Identifier et monter le disque (déjà installé)
bsdutils	logger	Journaliser le script d’automatisation (déjà installé)
udev	udevadm	Attendre la détection du disque (déjà installé)
cron	/etc/crontab	Planifier le montage et le démontage (déjà installé)
proxmox-backup-server	proxmox-backup-manager	Piloter les datastores (déjà installé)

Autre système de fichiers

Cette procédure utilise btrfs, qui n’est pas le choix le plus recommandé en production. Pour utiliser un autre système de fichiers, remplacer btrfs-progs par le paquet correspondant :

Système de fichiers	Paquet	Commande de formatage
ext4	e2fsprogs	mkfs.ext4
XFS	xfsprogs	mkfs.xfs
ZFS	zfsutils-linux	zpool create

Étape 1 — Préparer le disque

1. Identifier le nouveau disque

   Insérer le disque dans le serveur PBS, puis lister les périphériques bloc :

   lsblk

   NAME             MAJ:MIN RM  SIZE RO TYPE MOUNTPOINTS
   sda                8:0    0   45G  0 disk
   ├─sda1             8:1    0    1G  0 part /boot
   └─sda2             8:2    0   44G  0 part
     ├─rl_heal-root 253:0    0 40,5G  0 lvm  /
     └─rl_heal-swap 253:1    0  3,5G  0 lvm
   sdb                8:16   0  200G  0 disk

   Dans cet exemple, le nouveau disque est sdb. Adapter toutes les commandes suivantes à ce nom.

   Vérifier deux fois le nom du disque

   Les étapes suivantes effacent intégralement le disque ciblé. S’assurer que le périphérique choisi est bien le disque externe et non un disque système.

2. Créer la table de partition

   gdisk /dev/sdb

   Enchaîner les commandes interactives suivantes :

   Touche	Action
   d	Supprimer les partitions existantes (à répéter s’il y en a plusieurs)
   o	Créer une nouvelle table de partition GPT
   n	Créer une nouvelle partition — valider toutes les valeurs par défaut avec Entrée
   w	Écrire les modifications sur le disque et quitter

3. Formater la partition

   mkfs.btrfs /dev/sdb1

4. Étiqueter le disque

   L’étiquette (label) permet de retrouver le disque quel que soit le nom attribué par le noyau (sdb, sdc…). C’est indispensable pour la rotation, et fortement recommandé même avec un seul disque.

   btrfs filesystem label /dev/sdb1 offline-disk-1

   Vérifier :

   blkid -L offline-disk-1

Étape 2 — Initialiser le datastore PBS

Un datastore PBS a besoin d’une arborescence spécifique (.chunks, .lock…) sur le disque. Cette arborescence est créée automatiquement à la création du datastore dans l’interface.

La marche à suivre diffère selon qu’il s’agit du premier disque ou d’un disque de rotation.

Premier disque

1. Créer le point de montage et monter le disque

   mkdir -p /mnt/datastore/OFFLINE
   mount /dev/sdb1 /mnt/datastore/OFFLINE/

2. Créer le datastore définitif dans l’interface PBS

   Dans l’interface web : Datastore → Add Datastore, en pointant sur /mnt/datastore/OFFLINE.

   

   Le disque est prêt : passer directement à l’Étape 3.

Disque de rotation

Le datastore OFFLINE existe déjà et pointe sur /mnt/datastore/OFFLINE. Le nouveau disque doit donc être initialisé via un datastore temporaire, qui sera supprimé ensuite.

1. Monter temporairement le disque

   mkdir -p /tmp/test
   mount /dev/sdb1 /tmp/test/

2. Créer un datastore temporaire dans l’interface PBS

   Dans l’interface web : Datastore → Add Datastore, en pointant sur /tmp/test.

   

   Datastore temporaire uniquement

   Le datastore TEST monté dans /tmp est volontairement jetable : il ne sert qu’à initialiser l’arborescence sur le disque. Un datastore permanent ne doit jamais être monté dans /tmp, mais dans /mnt/datastore/<MON_DATASTORE>.

3. Mettre le datastore temporaire hors ligne et le démonter

   proxmox-backup-manager datastore update TEST --maintenance-mode offline && \
     sleep 30 && \
     umount /tmp/test

4. Monter le disque sur le datastore définitif

   mount /dev/sdb1 /mnt/datastore/OFFLINE/
   proxmox-backup-manager datastore update OFFLINE --delete maintenance-mode

5. Supprimer le datastore temporaire

   vim /etc/proxmox-backup/datastore.cfg
   # Supprimer la section « datastore: TEST »

Étape 3 — Automatiser le montage et le démontage

Le disque ne doit rester monté que pendant la fenêtre de sauvegarde. Deux tâches planifiées sont nécessaires :

gantt
    title Cycle quotidien du disque d'externalisation
    dateFormat YYYY-MM-DD HH:mm
    axisFormat %Hh
    tickInterval 3hour

    section Disque externe
    Démonté — débranchable          :crit,      2026-01-01 08:00, 9h
    Monté — sur /mnt/datastore      :active,    2026-01-01 17:00, 15h

    section Sauvegardes PBS
    Datastore en maintenance        :crit,      2026-01-01 08:00, 9h
    Fenêtre de sauvegarde           :active,    2026-01-01 17:00, 15h

• 17:00 — montage. Le script détecte le disque branché par son label, le monte, puis lève le mode maintenance du datastore. Les sauvegardes peuvent démarrer.
• 08:00 — démontage. Le datastore passe en maintenance, PBS termine ses tâches en cours, puis le disque est démonté. Il peut alors être débranché et emporté hors site.

Démontage automatique

Le démontage est simple : une seule ligne dans la crontab suffit.

vim /etc/crontab

/etc/crontab

0 8 * * *  root  proxmox-backup-manager datastore update OFFLINE --maintenance-mode offline && sleep 180 && umount /mnt/datastore/OFFLINE

Note

Le sleep 180 laisse aux tâches PBS en cours le temps de se terminer proprement avant le démontage. Ajuster cette valeur selon la charge du serveur.

Montage automatique

Il n’existe pas de solution idéale pour le montage. Les règles udev ont été testées mais se sont révélées trop instables. Le script ci-dessous est la solution retenue : il cherche le disque par son label, vérifie son système de fichiers, le monte et lève le mode maintenance du datastore.

Retours bienvenus

Si vous avez une approche plus propre que ce script pour le montage automatique, les suggestions sont les bienvenues.

1. Déposer le script sur le serveur

   vim /root/auto-mount-backup-disk.sh
   chmod +x /root/auto-mount-backup-disk.sh

   /root/auto-mount-backup-disk.sh

   #!/bin/bash
   
   set -uo pipefail
   
   ################################  CONFIGURATION  ###############################
   
   # Zone -> labels candidats, par ordre de préférence
   declare -A LABELS=(
       [OFFLINE]="offline-disk-1 offline-disk-2 offline-disk-3"
   120 collapsed lines
   )
   
   # Zone -> point de montage (peut différer du nom du datastore)
   declare -A MOUNTPOINT=(
       [OFFLINE]="/mnt/datastore/OFFLINE"
   )
   
   # Zone -> datastore PBS correspondant
   declare -A DATASTORE=(
       [OFFLINE]="OFFLINE"
   )
   
   MOUNTOPTS="rw,relatime,space_cache=v2,max_inline=0,nosuid,nodev,noexec"
   
   WAIT_SECS=30                   # attente max de l'apparition d'un label (remplace le sleep fixe)
   SET_MAINTENANCE_IF_ABSENT=1    # 1 = passe le datastore en maintenance quand le disque est absent
   MAINTENANCE_MSG="Disque externe non branché"
   
   ################################################################################
   
   TAG="auto-mount-backup-disk"
   rc=0
   
   log()  { printf '[%s] %s\n' "$(date '+%F %T')" "$*"; logger -t "$TAG" -- "$*" 2>/dev/null; }
   warn() { printf '[%s] ATTENTION: %s\n' "$(date '+%F %T')" "$*" >&2; logger -t "$TAG" -p user.warning -- "$*" 2>/dev/null; }
   
   find_device() {
       local zone="$1" label dev deadline=$(( SECONDS + WAIT_SECS ))
       while :; do
           for label in ${LABELS[$zone]}; do
               dev="$(blkid -L "$label" 2>/dev/null)"
               if [ -n "$dev" ]; then
                   printf '%s\t%s\n' "$label" "$dev"
                   return 0
               fi
           done
           (( SECONDS >= deadline )) && return 1
           sleep 2
       done
   }
   
   pbs_maintenance_off() {
       local ds="$1"
       proxmox-backup-manager datastore update "$ds" --delete maintenance-mode \
           && log "Datastore $ds : maintenance-mode retiré." \
           || { warn "Datastore $ds : échec du retrait du maintenance-mode."; rc=1; }
   }
   
   pbs_maintenance_on() {
       local ds="$1"
       [ "$SET_MAINTENANCE_IF_ABSENT" -eq 1 ] || return 0
       proxmox-backup-manager datastore update "$ds" \
           --maintenance-mode "type=offline,message=$MAINTENANCE_MSG" \
           && log "Datastore $ds : passé en maintenance (offline)." \
           || warn "Datastore $ds : échec du passage en maintenance."
   }
   
   process_zone() {
       local zone="$1"
       local mp="${MOUNTPOINT[$zone]}" ds="${DATASTORE[$zone]}"
       local found label dev fstype src
   
       # Déjà monté ? on vérifie juste et on lève la maintenance
       if mountpoint -q "$mp"; then
           src="$(findmnt -no SOURCE "$mp")"
           log "[$zone] $mp déjà monté ($src)."
           pbs_maintenance_off "$ds"
           return 0
       fi
   
       if ! found="$(find_device "$zone")"; then
           warn "[$zone] aucun disque trouvé parmi : ${LABELS[$zone]}"
           pbs_maintenance_on "$ds"
           rc=1
           return 1
       fi
       label="${found%%$'\t'*}"
       dev="${found##*$'\t'}"
   
       fstype="$(blkid -o value -s TYPE "$dev" 2>/dev/null)"
       if [ "$fstype" != "btrfs" ]; then
           warn "[$zone] $label ($dev) n'est pas en btrfs (type=$fstype) — montage annulé."
           pbs_maintenance_on "$ds"
           rc=1
           return 1
       fi
   
       # Le disque est-il déjà monté ailleurs ?
       if findmnt -no TARGET --source "$dev" >/dev/null 2>&1; then
           warn "[$zone] $dev est déjà monté sur $(findmnt -no TARGET --source "$dev" | paste -sd' ')."
           rc=1
           return 1
       fi
   
       mkdir -p "$mp"
   
       log "[$zone] montage de $label ($dev) sur $mp..."
       if mount -t btrfs -o "$MOUNTOPTS" "$dev" "$mp"; then
           log "[$zone] montage OK."
           pbs_maintenance_off "$ds"
       else
           warn "[$zone] échec du montage de $dev sur $mp."
           pbs_maintenance_on "$ds"
           rc=1
           return 1
       fi
   }
   
   # --- main ---------------------------------------------------------------------
   
   if [ "$(id -u)" -ne 0 ]; then
       warn "Ce script doit être exécuté en root."
       exit 1
   fi
   
   command -v udevadm >/dev/null && udevadm settle --timeout=10 >/dev/null 2>&1
   
   zones=( "$@" )
   [ ${#zones[@]} -eq 0 ] && zones=( "${!LABELS[@]}" )
   
   for zone in "${zones[@]}"; do
       if [ -z "${LABELS[$zone]:-}" ]; then
           warn "Zone inconnue : $zone (zones définies : ${!LABELS[*]})"
           rc=1
           continue
       fi
       process_zone "$zone"
   done
   
   exit $rc

2. Adapter la configuration

   Seul le bloc CONFIGURATION en haut du script est à modifier :

   Variable	Rôle
   LABELS	Labels des disques acceptés pour la zone, par ordre de préférence (rotation)
   MOUNTPOINT	Point de montage de la zone
   DATASTORE	Nom du datastore PBS correspondant
   MOUNTOPTS	Options de montage
   WAIT_SECS	Durée max d’attente de l’apparition d’un label
   SET_MAINTENANCE_IF_ABSENT	1 = bascule le datastore en maintenance si aucun disque n’est trouvé

   Pour gérer plusieurs réseaux, ajouter une entrée par zone dans les trois tableaux :

   declare -A LABELS=(
       [RESEAU_A]="reseau-a-disk-1 reseau-a-disk-2"
       [RESEAU_B]="reseau-b-disk-1 reseau-b-disk-2"
   )
   
   declare -A MOUNTPOINT=(
       [RESEAU_A]="/mnt/datastore/RESEAU_A"
       [RESEAU_B]="/mnt/datastore/RESEAU_B"
   )
   
   declare -A DATASTORE=(
       [RESEAU_A]="RESEAU_A"
       [RESEAU_B]="RESEAU_B"
   )

   Le script attend du btrfs

   Le script refuse de monter un disque dont le système de fichiers n’est pas btrfs (garde-fou volontaire). En cas d’utilisation d’un autre système de fichiers, adapter le test [ "$fstype" != "btrfs" ] ainsi que l’option mount -t btrfs.

3. Tester le script à la main

   /root/auto-mount-backup-disk.sh
   findmnt /mnt/datastore/OFFLINE

   Il est aussi possible de ne traiter qu’une zone :

   /root/auto-mount-backup-disk.sh RESEAU_A

4. Planifier l’exécution

   vim /etc/crontab

   /etc/crontab

   0 17 * * *  root  /root/auto-mount-backup-disk.sh

Récapitulatif

• Répertoire/mnt/datastore/

  • RépertoireOFFLINE/ point de montage du disque externe

    • …
• Répertoire/root/

  • auto-mount-backup-disk.sh script de montage automatique
• Répertoire/etc/

  • crontab planification montage (17h) / démontage (8h)
  • Répertoireproxmox-backup/

    • datastore.cfg configuration des datastores PBS

Heure	Action	Déclencheur
08:00	Datastore en maintenance puis démontage	cron
17:00	Détection du disque, montage, sortie de maintenance	cron + auto-mount-backup-disk.sh

Dépannage

Symptôme	Piste
aucun disque trouvé parmi : …	Le disque n’est pas branché, ou son label ne correspond pas — vérifier avec blkid -L <label>
n'est pas en btrfs (type=…)	Le disque n’a pas été formaté, ou l’a été dans un autre système de fichiers
est déjà monté sur …	Démonter le disque avant de relancer le script : umount <point_de_montage>
Le datastore reste en maintenance	Lever le mode manuellement : proxmox-backup-manager datastore update OFFLINE --delete maintenance-mode
umount: target is busy	Une tâche PBS tourne encore — augmenter le sleep de la crontab de démontage

Les messages du script sont également envoyés au journal système :

journalctl -t auto-mount-backup-disk -n 50