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.
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.
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 SHA256SUMSLa vérification doit afficher OK. Installez ensuite le binaire :
bunzip2 "$FILE"
sudo install -m 755 "${FILE%.bz2}" /usr/local/bin/restic
restic versionSi bunzip2 est absent, installez-le avec sudo apt install -y bzip2.
Préparer la configuration
-
Créez le dossier de configuration et le mot de passe du dépôt :
Terminalsudo install -d -m 700 /etc/restic sudo sh -c 'umask 077; openssl rand -base64 32 > /etc/restic/password' sudo cat /etc/restic/password -
Créez le fichier d'environnement :
Terminalsudo install -m 600 /dev/null /etc/restic/restic.env sudo nano /etc/restic/restic.envConfigurationRESTIC_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'. -
Listez les dossiers à sauvegarder. N'indiquez que des chemins existants :
Terminalsudo nano /etc/restic/pathsTexte/etc /home /root /var/www /var/backups -
Listez ce qui doit être ignoré :
Terminalsudo nano /etc/restic/excludesTexte/home/*/.cache /root/.cache /var/www/*/cache **/node_modules *.tmp -
Créez une petite commande qui charge cette configuration :
Terminalsudo nano /usr/local/sbin/restic-envTerminal#!/bin/sh set -a . /etc/restic/restic.env set +a exec /usr/local/bin/restic "$@"Terminalsudo chmod 700 /usr/local/sbin/restic-env
Créer le dépôt et lancer une première sauvegarde
-
Initialisez le dépôt :
Terminalsudo restic-env init -
Simulez la sauvegarde pour contrôler les fichiers retenus :
Terminalsudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --dry-run --verbose -
Lancez la sauvegarde :
Terminalsudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --tag auto -
Vérifiez le résultat :
Terminalsudo restic-env snapshots sudo restic-env ls latest /etc/hostname sudo restic-env checkcheckdoit se terminer parno 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
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
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/shadowSeuls 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 :
sudo rm -rf /var/tmp/restic-testNiveau 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 :
-
Installez Restic comme ci-dessus.
-
Recréez
/etc/restic/restic.env,/etc/restic/passwordet/usr/local/sbin/restic-envà partir de vos copies externes. -
Restaurez dans un dossier dédié, sans écraser le système :
Terminalsudo restic-env snapshots --host web01 sudo restic-env restore latest --host web01 --target /var/restore -
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
-
Créez le service de sauvegarde :
Terminalsudo nano /etc/systemd/system/restic-backup.serviceConfiguration[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 -
Créez son minuteur :
Terminalsudo nano /etc/systemd/system/restic-backup.timerConfiguration[Unit] Description=Daily Restic backup [Timer] OnCalendar=*-*-* 03:30:00 RandomizedDelaySec=20min Persistent=true [Install] WantedBy=timers.target -
Créez le service de maintenance, qui applique la rétention puis contrôle le dépôt :
Terminalsudo nano /etc/systemd/system/restic-maintenance.serviceConfiguration[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é. -
Créez son minuteur :
Terminalsudo nano /etc/systemd/system/restic-maintenance.timerConfiguration[Unit] Description=Weekly Restic maintenance [Timer] OnCalendar=Sun *-*-* 05:00:00 RandomizedDelaySec=20min Persistent=true [Install] WantedBy=timers.target -
Activez les deux minuteurs et lancez une sauvegarde par ce biais :
Terminalsudo 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 :
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 :
sudo restic self-update
restic versionVos 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 :
pgrep -a restic
sudo restic-env list locksRetirez ensuite uniquement les verrous périmés :
sudo restic-env unlockSignatureDoesNotMatch, 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 :
curl -I https://s3.lyn.io.hostmyservers.netToute 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.