Présentation et utilisation de l'outil de sauvegardes Tarsnap
Installation et configuration de Tarsnap sous amd64 et arm64
1 mai 2026
Date de rédaction : 2026-05-01
Date de péremption : 2026-11-01
Bonjour à tous,
J’ai décidé de vous causer de tarsnap aujourd’hui, un programme que j’utilise depuis sa création et auquel je suis toujours fidèle :
- La syntaxe est relativement simple et s'appuie sur celle de bsdtar
- Il est très abordable (particulièrement pour un particulier)
- Le code est en open-source avec un programme de bug bounty
- Il est efficace et relativement simple à utiliser
- Il gère différentes architectures
- Il utilise la déduplication de vos données (permettant ainsi de sauvegarder un gros volume qui change rarement)
- Le chiffrement de vos sauvegardes se fait avec votre clef local !
- L’auteur de Tarsnap se trouve être Colin Percival que j’ai rencontré lorsque j’étais actif pour le projet FreeBSD et il à toute ma confiance.
- Et pleins d'autres raisons que je n'ai pas en tête :)
Je vous copie la présentation disponible sur le site officiel :
Des sauvegardes en ligne pour les plus paranoïaques
Tarsnap est un service de sauvegarde en ligne sécurisé et efficace :
- Chiffrement: vos données ne sont accessibles qu'à l'aide de vos clés personnelles. Nous ne pouvons pas accéder à vos données, même si nous le voulions !
- Code source : le code client est disponible. Vous n'avez pas besoin de nous faire confiance ; vous pouvez vérifier le chiffrement vous-même !
- Déduplication : seules les données uniques entre vos fichiers actuels et vos archives chiffrées sont téléchargées. Cela réduit la bande passante et l'espace de stockage nécessaires, ce qui vous permet de faire des économies !
- Tarsnap fonctionne sur des systèmes d'exploitation de type UNIX (BSD, Linux, macOS, Cygwin, etc.).
————————————————-
Les tarifs de Tarsnap :
Tarsnap utilise un modèle prépayé basé sur l'utilisation réelle :
Stockage :
250 picodollars/octet-mois de données codées : 0,25 $/Go-mois
Bande passante :
250 picodollars/octet de données encodées : 0,25 $/Go
Les données encodées correspondent aux octets réels stockés ou transmis après déduplication, compression et chiffrement des données.
Il n'y a pas d'autres frais :
Tarsnap n'a pas d'abonnements, de coûts fixes ni de frais mensuels minimums.
Vous payez ce que vous utilisez, rien de plus.
Pourquoi les tarifs de Tarsnap sont-ils exprimés en picodollars ?
Il y a trois raisons principales pour lesquelles les tarifs de Tarsnap sont exprimés en picodollars (10 à 12) par octet plutôt qu'en dollars par gigaoctet (à mon avis) :
1/ L'auteur de Tarsnap est un geek. Appliquer des préfixes du Système international à des unités ne faisant pas parties du SI (Système International des poids et mesures), c'est vraiment un truc de geek :D
2/ Si les prix étaient indiqués en dollars par Go plutôt qu'en picodollars par octet, il serait plus difficile d'éviter la confusion autour de la notion de « qu'est-ce qu'un Go » (un Go correspond à 10^9 octets, mais certaines personnes ne comprennent pas les préfixes du SI).
Les picodollars sont parfaitement clairs : personne ne va penser qu'un picodollar équivaut à 2 ou 40 dollars.
3/ Le fait d'indiquer les prix en picodollars souligne bien le fait que si vous avez des sauvegardes de très petite taille, vous pouvez payer des montants vraiment très modestes.
Maintenant que les présentations sont faites, il ne vous reste plus qu’à créer un compte et c’est parti pour l’installation !
Ce tutoriel couvre l’installation de tarsnap sur les architectures amd64 (binaires officiels) et arm64 (compilation depuis les sources, le repo officiel ne distribuant pas de binaires ARM).
Je vous encourage très VIVEMENT à le lire en entier avant de de vous lancer de l'aventure !
Il devrait pouvoir être étendu à toutes architectures permettant de compiler les sources. N'hésitez pas à me contacter pour adapter ce document à votre architecture, cela sera très apprécié ainsi que tout feedback ! :)
0. Pré-installation
- Détection de l'architecture :
# dpkg –print-architecture
- amd64 –> suivre la section A
- arm64 –> suivre la section B
Pour toutes les autres archis (armhf, armel, riscv64, …) -> adapter la voie B en conséquence.
Validation des locales
Tarsnap a besoin de la locale en_US.UTF-8 pour traiter correctement les noms de fichiers non-ASCII.
Sur certaines installations minimales (Debian Trixie netinst, RaspiOS Lite, conteneurs …), seule la locale C.UTF-8 est installée.
# locale -a | grep -E ‘en_US|fr_FR’
Si la locale n’apparait pas, il va falloir l’installer :
# apt install locales
# sed -i ’s/^# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/’ /etc/locale.gen
# sed -i ’s/^# fr_FR.UTF-8 UTF-8/fr_FR.UTF-8 UTF-8/’ /etc/locale.gen # locale-gen
# update-locale LANG=en_US.UTF-8
Si seul C.utf8 apparaît :
# dpkg-reconfigure locales
Choisissez les locales à installer : en_US.UTF8 et en_GB.UTF8 (classique sous Raspberry Pi) et celles propres aux programmes et fichiers que vous manipuler fr_FR.UTF8 pour ma part.
Ensuite choisissez la locale par défaut : en_US.UTF8 qui est la principale locale utilisée dans le monde Linux, l'utiliser pour la compatibilité est une bonne pratique.
Test final, après modifications, dans un nouveau shell :
# exec bash
ou ouvrez une nouvelle session SSH pour vérifier :
# export LC_ALL=en_US.UTF-8 locale
Aucun warning cannot change locale ne devrait apparaitre une fois que le shell à été rechargé !
1. Récupération et vérification de la clef de signature
Via curl (mais wget fonctionne aussi très bien) :
# curl -# -O https://pkg.tarsnap.com/tarsnap-deb-packaging-key.asc
Vérifier ensuite l'empreinte de la clef :
# gpg –show-key tarsnap-deb-packaging-key.asc
Empreinte attendue :
pub rsa4096 2025-11-24 [SC] [expires: 2027-02-01]
FA8A1B4C2B5EF8A457E3D5508F85AE335D4F3E8A
uid Tarsnap .deb packages signing key (Tarsnap Backup Inc.) pkg-deb@tarsnap.com
Convertir, puis installer la clef :
# gpg –dearmor tarsnap-deb-packaging-key.asc
# mv tarsnap-deb-packaging-key.asc.gpg tarsnap-archive-keyring.gpg
# mv tarsnap-archive-keyring.gpg /usr/share/keyrings/
a) Installation sur amd64 (binaires officiels)
a.1) Ajout du dépôt
- Ajouter le dépôt tarsnap:
# echo “deb [signed-by=/usr/share/keyrings/tarsnap-archive-keyring.gpg] http://pkg.tarsnap.com/deb/$(lsb_release -s -c) ./” | tee /etc/apt/sources.list.d/tarsnap.list
# cat /etc/apt/sources.list.d/tarsnap.list
deb [signed-by=/usr/share/keyrings/tarsnap-archive-keyring.gpg] http://pkg.tarsnap.com/deb/trixie ./
- Suppression des traces inutiles de la clef du dépôt :
# rm tarsnap-archive-keyring.gpg tarsnap-deb-packaging-key.asc
a.2) Installation
# apt update
# apt install tarsnap
# which tarsnap # Doit renvoyer /usr/bin/tarsnap
# tarsnap –version # tarsnap 1.0.41 (ou plus)
Passer à la section 4 pour continuer votre installation maintenant!
b) Compilation pour arm64 (et autres architectures non amd64)
Pourquoi ? Le repo officiel pkg.tarsnap.com ne distribue des binaires que pour i386et amd64.
Pour toutes les autres archis (arm64, armhf, etc.), Tarsnap fournit en revanche un dépôt deb-src permettant de générer un .deb natif proprement.
b.1 Ajout du dépôt source
- Ajouter le dépôt source :
# echo “deb-src [signed-by=/usr/share/keyrings/tarsnap-archive-keyring.gpg] http://pkg.tarsnap.com/deb-src ./” | tee /etc/apt/sources.list.d/tarsnap.list
# cat /etc/apt/sources.list.d/tarsnap.list
Doit renvoyer :
deb-src [signed-by=/usr/share/keyrings/tarsnap-archive-keyring.gpg] http://pkg.tarsnap.com/deb-src ./
- Suppression des traces de la clef du dépôt installée :
# rm tarsnap-archive-keyring.gpg tarsnap-deb-packaging-key.asc
b.2 Compilation et installation du paquet
3.1 Mettre à jour la liste des paquets et installer les outils de build :
# apt update
# apt install build-essential devscripts dpkg-dev fakeroot libssl-dev libbz2-dev zlib1g-dev libarchive-dev e2fslibs-dev
3.2 Récupérer les sources dans un dossier dédié :
# mkdir -p /usr/src/tarsnap && cd /usr/src/tarsnap
# apt source tarsnap
# cd tarsnap-1.0.41 (ou plus)
L’avertissement : Download is performed unsandboxed as root est cosmétique : apt préfère habituellement passer par l'utilisateur _apt, mais comme le dossier est root-only, le download est fait en root : Aucun impact.
3.3 Compiler le paquet :
# dpkg-buildpackage -us -uc -b
- -us -uc : pas de signature (utile pour les mainteneur Debian uniquement)
- -b : ne construit que les binaires, pas le source package
Une fois la compilation finie, le fichier .deb est dans le dossier parent.
3.4 Installation du fichier .deb :
# cd .. dpkg -i tarsnap_1.0.41-1_arm64.deb
# which tarsnap # Doit renvoyer /usr/bin/tarsnap
# tarsnap –version # tarsnap 1.0.41 ou +
3.5 Nettoyage post-build :
Une fois le paquet installé et fonctionnel, on peut faire le ménage.
Avant de supprimer quoi que ce soit : sauvegarder le .deb !
il pourra être réutilisé sur d'autres machines arm64 sans avoir à tout recompiler.
Suppression des sources et restes de build :
# rm -rf /usr/src/tarsnap
3.6 Désinstallation des outils de build (optionnel) :
Sur un Raspberry Pi avec une carte SD limitée en taille ou en cycles d'écriture, c'est loin d'être anecdotique : build-essential et ses dépendances pèsent plusieurs centaines de Mo.
Pour une suppression en profondeur vous pouvez supprimer les outils de développement, mais les garder en place permet de récupérer simplement les nouvelles sources lors des mises à jour et de les recompiler sans avoir à tout réinstaller.
# apt autoremove –purge build-essential devscripts dpkg-dev fakeroot libssl-dev libbz2-dev zlib1g-dev libarchive-dev e2fslibs-dev
3.7 Suppression du dépôt deb-src (déconseillé !!!)
# rm /etc/apt/sources.list.d/tarsnap.list
# apt update
Il vous faudra alors surveiller https://www.tarsnap.com/news.html ou la mailing-list tarsnap-announce pour être averti des nouvelles versions !
Passer à la section 4 pour continuer votre installation maintenant !
4. Génération de la clef de chiffrement
A partir de maintenant la procédure est la même sous architecture amd64 et arm64 !
Création de votre clef servant à chiffrer vos sauvegardes :
# tarsnap-keygen –keyfile /root/tarsnap.key –user john@doh.net –machine $(hostname)
Enter tarsnap account password: ****
Une fois la clef de votre compte Tarsnap entrée vous devriez avoir votre clef :
# ls -l /root/tarsnap.key
-rw——- 1 root root 4929 Mar 5 14:30 /root/tarsnap.key
⚠️ Externaliser /root/tarsnap.key en lieu sûr immédiatement ! Sans elle, vos archives seront définitivement perdues !!! ⚠️
5. Test initial avec un snapshot temporaire
Note importante : tarsnap supprime les / en tête des chemins dans l'archive. (En fait il utilise la même syntaxe que tar)
Les patterns –exclude ne doivent donc pas être préfixées d’un / avant les chemins sources.
Pour les noms de fichiers contenant des caractères non-ASCII (ex : certificats CA hongrois, fichiers accentués), forcer la locale UTF-8 avec
# LANG=en_US.UTF-8.
5.1 Vérifier la config :
# tarsnap –verify-config
Ne renvoie rien si tout est OK
# tarsnap –dump-config
Sortie attendue :
Command-line: tarsnap –dump-config
Reading from config file: /root/.tarsnaprc
Reading from config file: /root/.config/tarsnap/tarsnap.conf
Reading from config file: /etc/tarsnap.conf cachedir /usr/local/tarsnap-cache keyfile /root/tarsnap.key nodump print-stats checkpoint-bytes 1G
5.2 Créer un snapshot temporaire, appelé snapshot-test qui va sauvegarder les répertoires suivants :
Pour vous familiariser un peu avec Tarsnap on va également d’exclure le contenu de :
Ajuster les locales et les chemins pour votre snapshot de test, il sera de toutes manières détruit à la fin du test :
# export LANG=en_US.UTF-8 && tarsnap -c -f “snapshot-test” –exclude 'var/www/html/secret’ /etc /home /var/www /root
Et voilà, si vous n'avez pas eu d'erreur on va vérifier ce que Tarsnap à sauvegarder sur ses serveurs.
Afficher les statistiques détaillés du dépôt et des sauvegardes :
# tarsnap –print-stats -f ’*’
Afficher les différents snapshots sauvegardés :
# tarsnap –list-archives h
Liste les fichiers contenus dans le snapshot :
# tarsnap -t -f snapshot-test
Puis supprimer le snapshot de test :
# tarsnap -d -f snapshot-test
Pour finir valider l'intégrité du dépôt :
# tarsnap –fsck
Phase 1: Verifying metadata validity
Phase 2: Verifying metadata/metaindex consistency
Phase 3: Reading chunk list
Phase 4: Verifying archive completeness
Phase 5: Identifying unreferenced chunks
Vérifier que le dépôt est vide :
# tarsnap –print-stats -f ’*’
Total size Compressed size
All archives 0 0
(unique data) 0 0
PS : Un script fournissant des statistiques au format humain est fourni à la section 11
6. Exemple de script de sauvegarde :
Créer le script de sauvegardes /root/tarsnap-backup.sh
(modifier le pour correspondre à vos besoins !) :
!/bin/sh
# Robustness settings
set -eu
# Garde-fou : on s'assure que la locale est bien dispo
if ! locale -a 2>/dev/null | grep -qix 'en_US.utf-\?8’; then
echo “ERREUR: locale en_US.UTF-8 non générée sur ce système” >&2
exit 1
fi
# Locale UTF-8 disponible, on continue
# évites que GNU gettext surcharge LC_MESSAGES
unset LANGUAGE
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
# Sauvegarde de la liste des paquets installés
dpkg –get-selections > /root/pkg-selections.txt
apt list –installed 2>/dev/null > /root/pkg-list.txt
# Construction du nom de l'archive
computer=$(uname -n)
now=$(date +%Y-%m-%d_%H-%M-%S)
name=${computer}-${now}
# Mode verbose pour debug : remplacer –quiet par -v
/usr/bin/tarsnap –quiet -c -f “${name}”
–exclude=’/tmp/’
–exclude=’/core/’
–exclude=’/.swp/*
/root /boot /var/lib/tor/keys /home
Pour développer n'hésitez pas à utiliser l'argument –dry-run qui simule simplement une sauvegarde !!
Explications :
- Les lignes commençant par –exclude= :
Elles contiennent tous les motifs, fichiers et dossiers qui doivent être exclus des sauvegardés
- La dernière ligne : /root /boot /var/lib/tor/keys /home
Elle contient l'ensemble des répertoires et fichiers à sauvegarder !
Mise en place du script en crontab :
Avant de mettre le script en crontab, simuler l'environnement minimal de cron
- Récupérer l'environnement de cron :
# grep PATH /etc/crontab PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
- Il suffit de recopier l'ensemble de la ligne PATH pour obtenir exactement le même environnement que celui de cron :
# env -i HOME=/root
Le env -i supprime toutes les variables d'environnement et ne garde que ce qu'on déclare explicitement. Si ça passe, le cron passera :)
- Simuler l'environnement de la crontab :
# PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
Maintenant que l'environnement est identique on peut tester notre script :
# chmod +x tarnsap-backup.sh
# .//root/tarsnap-backup.sh
Mise en place dans /etc/crontab :
Pour une sauvegarde quotidienne à 00:02 :
02 00 * * * root /root/tarsnap-backup.sh
Utiliser un MAILTO=root pour vous avertir si la sauvegarde échoue !
Je vous renvoie vers man crontab pour mettre ça en place :-)
7. Statistiques des archives
Afficher les statistiques détaillés du dépôt et des sauvegardes :
# tarsnap –print-stats -f ’*’
Afficher vos différents snapshots disponibles :
# tarsnap –list-archives
Exemples de sorties :
root@foobar:~# tarsnap –print-stats -f ’*’
Total size Compressed size
All archives 619097771068 592894149532
(unique data) 9208103551 8566525658
foobar-2026-08-08_00-02-03 14064110871 13468368807
(unique data) 244816 122879
foobar-2026-08-23_00-02-03 14064110399 13468368719
(unique data) 87900 42415
foobar-2026-08-07_00-02-02 14064110871 13468368807
(unique data) 244816 122879
foobar-2026-07-28_00-02-03 14063886679 13468126823
(unique data) 87900 42415
foobar-2026-07-30_00-02-02 14063887191 13468126951
…
root@foobar:~#
root@foobar:~# tarsnap –list-archives | sort
foobar-2026-07-25_00-02-04
foobar-2026-07-26_00-02-02
foobar-2026-07-27_00-02-05
foobar-2026-07-28_00-02-03
foobar-2026-07-29_00-02-03
foobar-2026-07-30_00-02-02
…
foobar-2026-08-29_00-02-03
foobar-2026-08-30_00-02-02
foobar-2026-08-31_00-02-05
foobar-2026-09-01_00-02-02
foobar-2026-09-02_00-02-03
root@foobar:~#
8. Vérification d'intégrité
L'option fsck permet de s'assurer de l'intégrité de vos archives et de les réparer si nécessaire :
# tarsnap –fsck
Sortie attendue :
root@foobar:~# tarsnap –fsck
Phase 1: Verifying metadata validity
Phase 2: Verifying metadata/metaindex consistency
Phase 3: Reading chunk list
Phase 4: Verifying archive completeness Archive ½… Archive 2/2… Phase 5: Identifying unreferenced chunks
root@foobar:~#
Je vous conseille de la lancer périodiquement pour vous assurer que le dépôt distant et le cache local ne sont pas corrompus, cela peut par exemple être dû à une coupure réseau ou de l'alimentation de la machine durant la sauvegarde.
Je n'ai jamais eu besoin de l'utiliser depuis que Tarsnap existe soit 7 ans et plus d'une dizaine de machines d'architectures différentes sauvegardées !
Si une archive est corrompue et ne peut pas être récupérée il va vous falloir l'effacer de votre cache avec l'option :
root@foobar:~# tarsnap –fsck-prune
À lancer périodiquement (mensuellement par exemple) pour s'assurer que le dépôt distant n’est pas corrompu, même si c’est quasiment impossible, à part peut être lors d’une coupure réseau en pleine sauvegarde.
9. Suppression d'un snapshot
Lister les sauvegardes disponibles :
# tarsnap –list-archives
foobar-2026-03-05_15-55-32
Supprimer l'archive souhaitée :
# tarsnap -d -f foobar-2026-03-05_15-55-32
Total size Compressed size
All archives 0 0
(unique data) 0 0
This archive 299348234 165377794
Deleted data 299333898 165371314
Vérifier ensuite que l'archive à bien été supprimée :
root@foobar:~# tarsnap –list-archives
root@foobar:~#
Comme il n'y avait qu'une seule archive le dépôt est maintenant vide :
# root@foobar:~# tarsnap –print-stats -f ’*’
Total size Compressed size
All archives 0 0
(unique data) 0 0
root@foobar:~#
10. Suppression de toutes les données (DANGER)
⚠️ Irréversible ⚠️
Supprime toutes les archives de la machine sur les serveurs Tarsnap.
# tarsnap –nuke
Please type 'No Tomorrow’ to continue
No Tomorrow
#
11. Tests de validation rapide
Tests à passer après l'installation pour s'assurer que tout est fonctionnel :
- Binaire présent : which tarsnap -> /usr/bin/tarsnap
- Version correcte : tarsnap –version -> tarsnap 1.0.41
- Locale OK : locale -a | grep en_UU –> en_US.utf8
- LC_ALL utilisable : LC_ALL=en_US.UTF-8 bash -c 'echo OK’ –> OK (sans warning)_
- Config valide : tarsnap –verify-config –> Aucune erreur
- Clef présente : ls -l /root/tarsnap.key –> Doit avoir les permissions -rw——-
- Dépôt joignable : tarsnap –print-stats -f ’*’ –> affichage des stats
12. Script de récupération des statistiques, puis affichage sous une forme humaine
#!/bin/sh
# Nombre d'archives (appel réseau séparé, inévitable)
NARCHIVES=$(tarsnap –list-archives | wc -l | awk ’{print $1}’)
tarsnap –print-stats | awk -v narchives=“$NARCHIVES” ’
function format_bytes(bytes) {
if (bytes < 1024) return sprintf(“%.0f B”, bytes)
if (bytes < 10241024) return sprintf(“%.2f KB”, bytes / 1024) if (bytes < 102410241024) return sprintf(“%.2f MB”, bytes / (10241024))
if (bytes < 1024102410241024) return sprintf(“%.2f GB”, bytes / (102410241024)) return sprintf(“%.2f TB”, bytes / (1024102410241024))
}
NR == 2 {
printf “All archives:\n”
printf “ Snapshots: %d\n”, narchives + 0
printf “ Total size: %s\n”, format_bytes($3)
printf “ Compressed size: %s\n”, format_bytes($4)
printf “ Ratio: %.1f%%\n\n”, ($4 / $3) * 100
}
NR == 3 {
encoded = $4
cost = encoded * 250e-12
printf “Unique data:\n”
printf “ Total size: %s\n”, format_bytes($3)
printf “ Encoded size: %s\n”, format_bytes(encoded)
printf “ Ratio: %.1f%%\n\n”, (encoded / $3) * 100
printf “Storage cost:\n”
printf “ Monthly: $%.4f\n”, cost
printf “ Daily: $%.6f\n”, cost / 30
printf “ (250 pUSD/byte/month on encoded data)\n”
}
’
Et voici la sortie attendue :
root@foobar:~# ./tarsnap-stats.sh
All archives:
Snapshots: 44
Total size: 576.58 GB
Compressed size: 552.18 GB
Ratio: 95.8%
Unique data:
Total size: 8.58 GB
Encoded size: 7.98 GB
Ratio: 93.0%
Storage cost:
Monthly: $2.1416
Daily: $0.071388
(250 pUSD/byte/month on encoded data)
root@foobar:~#
Cette sortie à pris 27 secondes à générer donc : pas de panique si le script ne rends pas la main immédiatement !
J’espère que ce petit tuto vous aidera à installer ainsi que paramétrer vos sauvegardes avec tarsnap ! :)
Pour plus d'informations utiles je vous renvoies vers le site de tarsnap :
et directement sa documentation :