FR

Linux et réseau

Sauvegardes chiffrées avec Restic

Sauvegardez un serveur Linux avec Restic vers un stockage compatible S3 : chiffrement, planification systemd, rétention, vérification et test de restauration.

8 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Ce guide vous explique comment sauvegarder votre VPS ou serveur dédié avec Restic vers un stockage compatible S3. Restic chiffre les données sur le serveur avant leur envoi, ne transfère que ce qui a changé et conserve plusieurs points de restauration, appelés snapshots.

Vous allez configurer une sauvegarde quotidienne, une politique de rétention, un contrôle d'intégrité hebdomadaire et, surtout, un test de restauration. Tant que ce test n'a pas réussi, considérez que vous n'avez pas de sauvegarde.

Prérequis

  • Un serveur sous Debian 12 ou 13, ou Ubuntu 22.04 ou 24.04, avec un accès sudo
  • Un bucket sur un stockage compatible S3, avec une clé d'accès et une clé secrète
  • Une horloge système à l'heure : voir notre guide Configurer NTP
  • Un endroit hors du serveur pour conserver le mot de passe du dépôt, comme un gestionnaire de mots de passe

Aucun port entrant n'est à ouvrir. Le serveur doit seulement pouvoir joindre le stockage en HTTPS sur le port sortant 443.

Choisir le stockage

Les exemples utilisent l'Object Storage HostMyServers, compatible S3, dont le point de terminaison publié sur cette page est https://s3.lyn.io.hostmyservers.net. Le bucket s'appelle mes-sauvegardes et le dossier web01 désigne votre serveur : adaptez ces deux noms.

Pour un autre fournisseur compatible S3, remplacez simplement l'adresse dans RESTIC_REPOSITORY par celle qu'il vous indique.

Installer Restic

Les paquets des distributions peuvent être anciens. Installez le binaire officiel publié par le projet. À la date de rédaction, la dernière version est 0.19.1 : consultez la page des versions et adaptez RESTIC_VERSION si besoin.

Terminal
RESTIC_VERSION="0.19.1"
ARCH="$(dpkg --print-architecture)"
FILE="restic_${RESTIC_VERSION}_linux_${ARCH}.bz2"
cd /tmp
curl -fsSLO "https://github.com/restic/restic/releases/download/v${RESTIC_VERSION}/${FILE}"
curl -fsSLO "https://github.com/restic/restic/releases/download/v${RESTIC_VERSION}/SHA256SUMS"
sha256sum --check --ignore-missing SHA256SUMS

La vérification doit afficher OK. Installez ensuite le binaire :

Terminal
bunzip2 "$FILE"
sudo install -m 755 "${FILE%.bz2}" /usr/local/bin/restic
restic version

Si bunzip2 est absent, installez-le avec sudo apt install -y bzip2.

Préparer la configuration

  1. Créez le dossier de configuration et le mot de passe du dépôt :

    Terminal
    sudo install -d -m 700 /etc/restic
    sudo sh -c 'umask 077; openssl rand -base64 32 > /etc/restic/password'
    sudo cat /etc/restic/password
  2. Créez le fichier d'environnement :

    Terminal
    sudo install -m 600 /dev/null /etc/restic/restic.env
    sudo nano /etc/restic/restic.env
    Configuration
    RESTIC_REPOSITORY='s3:https://s3.lyn.io.hostmyservers.net/mes-sauvegardes/web01'
    RESTIC_PASSWORD_FILE='/etc/restic/password'
    AWS_ACCESS_KEY_ID='VOTRE_CLE_D_ACCES'
    AWS_SECRET_ACCESS_KEY='VOTRE_CLE_SECRETE'

    Si votre fournisseur impose une région, ajoutez AWS_DEFAULT_REGION='VOTRE_REGION'.

  3. Listez les dossiers à sauvegarder. N'indiquez que des chemins existants :

    Terminal
    sudo nano /etc/restic/paths
    Texte
    /etc
    /home
    /root
    /var/www
    /var/backups
  4. Listez ce qui doit être ignoré :

    Terminal
    sudo nano /etc/restic/excludes
    Texte
    /home/*/.cache
    /root/.cache
    /var/www/*/cache
    **/node_modules
    *.tmp
  5. Créez une petite commande qui charge cette configuration :

    Terminal
    sudo nano /usr/local/sbin/restic-env
    Terminal
    #!/bin/sh
    set -a
    . /etc/restic/restic.env
    set +a
    exec /usr/local/bin/restic "$@"
    Terminal
    sudo chmod 700 /usr/local/sbin/restic-env

Créer le dépôt et lancer une première sauvegarde

  1. Initialisez le dépôt :

    Terminal
    sudo restic-env init
  2. Simulez la sauvegarde pour contrôler les fichiers retenus :

    Terminal
    sudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --dry-run --verbose
  3. Lancez la sauvegarde :

    Terminal
    sudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --tag auto
  4. Vérifiez le résultat :

    Terminal
    sudo restic-env snapshots
    sudo restic-env ls latest /etc/hostname
    sudo restic-env check

    check doit se terminer par no errors were found.

Tester la restauration

Faites ce test maintenant, puis au moins une fois par trimestre. Il se déroule en trois niveaux, du plus rapide au plus complet.

Niveau 1 : un fichier

Terminal
sudo rm -rf /var/tmp/restic-test
sudo restic-env restore latest --target /var/tmp/restic-test --include /etc/hostname
sudo diff /etc/hostname /var/tmp/restic-test/etc/hostname && echo "Identical"

Niveau 2 : un dossier complet

Terminal
sudo restic-env restore latest:/etc --target /var/tmp/restic-test/etc-full
sudo diff -r /etc /var/tmp/restic-test/etc-full | head -n 20
sudo stat -c '%U:%G %a %n' /etc/shadow /var/tmp/restic-test/etc-full/shadow

Seuls les fichiers modifiés depuis la sauvegarde doivent apparaître dans diff. Le propriétaire et les droits de shadow doivent être identiques. Effacez ensuite ce dossier, qui contient des données sensibles :

Terminal
sudo rm -rf /var/tmp/restic-test

Niveau 3 : reprise sur un autre serveur

C'est le test qui prouve que vous pourriez repartir après la perte totale du serveur. Sur une autre machine :

  1. Installez Restic comme ci-dessus.

  2. Recréez /etc/restic/restic.env, /etc/restic/password et /usr/local/sbin/restic-env à partir de vos copies externes.

  3. Restaurez dans un dossier dédié, sans écraser le système :

    Terminal
    sudo restic-env snapshots --host web01
    sudo restic-env restore latest --host web01 --target /var/restore
  4. Contrôlez vos fichiers, puis restaurez une base de données depuis ses exports en suivant le guide correspondant.

Notez la date du test et le temps nécessaire : c'est une bonne estimation de votre délai de reprise réel. web01 correspond ici au nom d'hôte du serveur d'origine, affiché par restic-env snapshots.

Planifier les sauvegardes avec systemd

  1. Créez le service de sauvegarde :

    Terminal
    sudo nano /etc/systemd/system/restic-backup.service
    Configuration
    [Unit]
    Description=Restic backup
    Wants=network-online.target
    After=network-online.target
    
    [Service]
    Type=oneshot
    EnvironmentFile=/etc/restic/restic.env
    Environment=HOME=/root
    Environment=RESTIC_CACHE_DIR=/var/cache/restic
    CacheDirectory=restic
    CacheDirectoryMode=0700
    Nice=10
    IOSchedulingClass=idle
    ExecStart=/usr/local/bin/restic backup --retry-lock 1h --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --tag auto
  2. Créez son minuteur :

    Terminal
    sudo nano /etc/systemd/system/restic-backup.timer
    Configuration
    [Unit]
    Description=Daily Restic backup
    
    [Timer]
    OnCalendar=*-*-* 03:30:00
    RandomizedDelaySec=20min
    Persistent=true
    
    [Install]
    WantedBy=timers.target
  3. Créez le service de maintenance, qui applique la rétention puis contrôle le dépôt :

    Terminal
    sudo nano /etc/systemd/system/restic-maintenance.service
    Configuration
    [Unit]
    Description=Restic retention and check
    Wants=network-online.target
    After=network-online.target
    
    [Service]
    Type=oneshot
    EnvironmentFile=/etc/restic/restic.env
    Environment=HOME=/root
    Environment=RESTIC_CACHE_DIR=/var/cache/restic
    CacheDirectory=restic
    CacheDirectoryMode=0700
    Nice=10
    IOSchedulingClass=idle
    ExecStart=/usr/local/bin/restic forget --retry-lock 1h --tag auto --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune
    ExecStart=/usr/local/bin/restic check --retry-lock 1h --read-data-subset=5%%

    Le signe % est doublé car systemd lui donne un sens particulier dans ses fichiers d'unité.

  4. Créez son minuteur :

    Terminal
    sudo nano /etc/systemd/system/restic-maintenance.timer
    Configuration
    [Unit]
    Description=Weekly Restic maintenance
    
    [Timer]
    OnCalendar=Sun *-*-* 05:00:00
    RandomizedDelaySec=20min
    Persistent=true
    
    [Install]
    WantedBy=timers.target
  5. Activez les deux minuteurs et lancez une sauvegarde par ce biais :

    Terminal
    sudo systemctl daemon-reload
    sudo systemctl enable --now restic-backup.timer restic-maintenance.timer
    sudo systemctl start restic-backup.service
    sudo systemctl status restic-backup.service --no-pager
    systemctl list-timers 'restic-*'

Consultez les journaux avec sudo journalctl -u restic-backup.service -n 50 --no-pager. Pensez à surveiller ces services : une sauvegarde qui échoue en silence pendant des semaines est un risque courant. systemctl --failed les fait apparaître en cas d'échec.

Comprendre la rétention

Option Conserve
--keep-daily 7 Le dernier snapshot de chacun des 7 derniers jours qui en ont un
--keep-weekly 4 Le dernier snapshot de chacune des 4 dernières semaines qui en ont un
--keep-monthly 6 Le dernier snapshot de chacun des 6 derniers mois qui en ont un

forget retire des snapshots, et --prune libère ensuite l'espace correspondant. Avant de changer ces valeurs, simulez le résultat :

Terminal
sudo restic-env forget --tag auto --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --dry-run

--read-data-subset=5% télécharge et vérifie à chaque passage un échantillon aléatoire d'environ 5 % des données. Pour tout contrôler, utilisez --read-data, plus long et plus gourmand en transfert.

Limiter les risques

  • Les clés stockées sur le serveur permettent de supprimer le dépôt. Si un attaquant prend le contrôle du serveur, il peut aussi atteindre vos sauvegardes.
  • L'offre HMS annonce le versioning et des règles de cycle de vie sur sa page de présentation. Le versioning permet de récupérer un objet écrasé ou supprimé, mais les versions conservées comptent dans le volume facturé.
  • Une seconde clé de dépôt évite de dépendre d'un seul mot de passe. Ajoutez-la avec sudo restic-env key add, et conservez-la elle aussi hors du serveur.

Mettre à jour Restic

Le binaire officiel se met à jour lui-même, après vérification de sa signature :

Terminal
sudo restic self-update
restic version

Vos données restent dans le dépôt. Après une mise à jour importante, relancez sudo restic-env check et un test de restauration de niveau 1.

En cas de problème

wrong password or no key found

Le contenu de /etc/restic/password ne correspond pas au dépôt. Restaurez le mot de passe depuis votre copie externe. Sans aucun mot de passe valide, les données ne sont pas récupérables.

repository does not exist: unable to open config file

Le dépôt n'a pas été initialisé à cette adresse, ou l'adresse est fausse. Vérifiez RESTIC_REPOSITORY, le nom du bucket et le dossier. Lancez sudo restic-env init uniquement s'il s'agit bien d'un nouveau dépôt.

repository is already locked

Une autre opération est en cours, ou une ancienne opération a été interrompue. Vérifiez d'abord qu'aucun Restic ne tourne sur aucun serveur utilisant ce dépôt :

Terminal
pgrep -a restic
sudo restic-env list locks

Retirez ensuite uniquement les verrous périmés :

Terminal
sudo restic-env unlock

SignatureDoesNotMatch, InvalidAccessKeyId ou AccessDenied

Les clés sont incorrectes, ou n'ont pas accès à ce bucket. Vérifiez AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY et le point de terminaison affiché pour votre service. Si l'erreur mentionne une région, ajoutez AWS_DEFAULT_REGION avec la valeur fournie par votre hébergeur de stockage, ou contactez le support depuis votre espace client.

RequestTimeTooSkewed

L'horloge du serveur est décalée. Contrôlez-la avec timedatectl, puis corrigez-la avec notre guide Configurer NTP.

NoSuchBucket

Le bucket n'existe pas ou son nom est mal écrit. Créez-le depuis votre espace client, puis relancez init.

no such host ou délai dépassé

Vérifiez le point de terminaison, la résolution DNS et la sortie vers le port 443 :

Terminal
curl -I https://s3.lyn.io.hostmyservers.net

Toute réponse HTTP, même une erreur 403, prouve que le service est joignable.

Le service se termine avec le code 3

Le snapshot a été créé, mais certains fichiers n'ont pas pu être lus. Le journal les liste. Corrigez les droits, excluez les fichiers temporaires, puis relancez la sauvegarde.

Le dépôt signale des erreurs à check

Ne lancez ni forget ni prune, conservez l'état actuel et suivez la procédure officielle de dépannage.

Références