| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| restic [Le 07/12/2025, 06:27] – [Explorer les sauvegardes] + --allow-other=true krodelabestiole | restic [Le 26/02/2026, 01:41] (Version actuelle) – [Restauration] réécriture - développement krodelabestiole |
|---|
| ====== Restic ====== | ====== Restic ====== |
| |
| **[[https://github.com/restic/restic|Restic]]** est un logiciel libre de [[:sauvegarde]] multiplateforme ([[:distributions|Linux]], macOS, Windows) qui offre toutes les fonctionnalités qu'on attend d'un logiciel de sauvegarde moderne : incrémentation((la [[wpfr>Sauvegarde_(informatique)#Sauvegarde_incrémentielle_ou_incrémentale|sauvegarde incrémentielle]] permet de conserver les anciennes versions des fichiers sauvegardées, sans nécessiter de téléverser de nouveau les fichiers inchangés)), chiffrement((le chiffrement empêche tout tiers d'accéder à vos données, y compris le propriétaire de la solution de stockage)), compression, déduplication((la compression et la déduplication accélèrent les transferts et permettent aux sauvegardes d'occuper un minimum d'espace)), etc. | **[[https://github.com/restic/restic|Restic]]** est un logiciel libre de [[:sauvegarde]] multiplateforme ([[:distributions|Linux]], macOS, Windows) qui offre toutes les fonctionnalités qu'on attend d'un logiciel de sauvegarde moderne : incrémentation((La [[wpfr>Sauvegarde_(informatique)#Sauvegarde_incrémentielle_ou_incrémentale|sauvegarde incrémentielle]] évite de téléverser de nouveau les fichiers inchangés.)), //versioning//((Le //versioning// permet de conserver les anciennes versions des fichiers sauvegardées.)), chiffrement((Le chiffrement empêche tout tiers d'accéder à vos données, y compris le propriétaire de la solution de stockage.)), compression, déduplication((La compression et la déduplication accélèrent les transferts et permettent aux sauvegardes d'occuper un minimum d'espace.)), etc.((Voir si besoin le chapitre //[[:sauvegarde#Petit glossaire]]//.)) |
| |
| Il permet de sauvegarder sur : | Il permet de sauvegarder sur : |
| * un système de fichiers local | * un système de fichiers local |
| * [[:ssh#monter_un_repertoire_distant_navigation_via_sftp_secure_file_transfer_protocol|SFTP]] ([[:SSH]]) | * [[:SFTP]] ([[:SSH]]) |
| * [[https://github.com/restic/rest-server|serveur HTTP REST]] | * [[https://github.com/restic/rest-server|serveur HTTP REST]] |
| * OpenStack Swift | * OpenStack Swift |
| - Il faut ensuite simplement [[:permissions|rendre le fichier exécutable]] :<code>chmod +x ~/.local/bin/restic</code> | - Il faut ensuite simplement [[:permissions|rendre le fichier exécutable]] :<code>chmod +x ~/.local/bin/restic</code> |
| |
| <note tip>Avec cette méthode on peut ensuite [[#mise à jour|mettre à jour]] **restic** sans [[:sudo|permission d'administrateur]].</note> | <note tip>Grâce à cette méthode la commande ''[[man>restic]]'' est directement accessible à l'[[:utilisateur]] courant, et il peut aussi [[#mise à jour|mettre à jour]] **restic**, le tout sans [[:permissions administrateur|permission administrateur]].</note> |
| |
| === Installer pour tous les utilisateurs === | === Installer pour tous les utilisateurs === |
| |
| Si on préfère que tous les utilisateurs puissent utiliser **restic**, on peut ensuite déplacer l'exécutable dans un répertoire du système avec les [[:sudo|permissions d'administrateur]] : | Si on préfère que tous les utilisateurs puissent utiliser **restic**, on peut ensuite déplacer l'exécutable dans le répertoire système adéquat avec les [[:permissions administrateur]] : |
| sudo mv ~/.local/bin/restic /usr/local/bin | sudo mv ~/.local/bin/restic /usr/local/bin |
| |
| |
| **Restic** ne s'utilise qu'en ligne de commande, et ne propose pas directement de configuration.\\ | **Restic** ne s'utilise qu'en ligne de commande, et ne propose pas directement de configuration.\\ |
| On peut tout de même automatiser son utilisation en configurant des tâches [[:systemd]] ou [[:cron]]\\ | On peut tout de même automatiser son utilisation en configurant des tâches [[:systemd]] ou [[:cron]].\\ |
| Il existe aussi de nombreux //[[#wrappers]]// qui permettent d'étendre les fonctionnalités de **restic**, par exemple justement en implémentant des fichiers de configuration pour faciliter son utilisation et automatiser les sauvegardes. | Il existe aussi de nombreux //[[#wrappers]]// qui permettent d'étendre les fonctionnalités de **restic**, par exemple justement en implémentant des fichiers de configuration pour faciliter son utilisation et automatiser les sauvegardes. |
| |
| Dans le cadre de l'utilisation native de **restic**, on peut afficher la liste des commandes disponibles en tapant simplement ''restic'' dans un [[:terminal]]. | Dans le cadre de l'utilisation native de **restic**, on peut afficher la liste des commandes disponibles en tapant simplement ''restic'' dans un [[:terminal]]. |
| |
| **Restic** permet de réaliser toutes sortes d'opérations mais on utilisera principalement ''init'' pour créer un dépôt lors de la première configuration, puis régulièrement la commande ''backup'' pour déclencher chaque sauvegarde. Comme on peut conserver plusieurs versions des fichiers sauvegardés à différents moments (voir [[wpfr>Sauvegarde_(informatique)#Sauvegarde_incrémentielle_ou_incrémentale|sauvegarde incrémentielle]]), pour désigner les sauvegardes en parle aussi d'**instantanés** (ou **//snapshots//** en anglais). | **Restic** permet de réaliser toutes sortes d'opérations mais on utilisera principalement ''init'' pour créer un dépôt lors de la première configuration, puis régulièrement la commande ''backup'' pour déclencher chaque sauvegarde. Comme on peut conserver plusieurs versions des fichiers sauvegardés à différents moments (voir //[[:sauvegarde#petit_glossaire|versioning]]//), pour désigner les sauvegardes en parle aussi d'**instantanés** (ou **//snapshots//** en anglais). |
| |
| Le paramètre ''-r'' (ou ''%%--%%repo'' en version longue) est très important : il permet de spécifier le dépôt (//**R**epository// en anglais) sur lequel on souhaite travailler. | Le paramètre ''-r'' (ou ''%%--%%repo'' en version longue) est très important : il permet de spécifier le dépôt (//**R**epository// en anglais) sur lequel on souhaite travailler. |
| ==== Initialisation ==== | ==== Initialisation ==== |
| |
| Pour commencer à utiliser **restic** il faut en premier lieu initialiser un dépôt avec la commande ''[[https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html|restic init]]''. C'est sur celui-ci qu'on effectuera les sauvegardes. Sur le dépôts les sauvegardes sont organisées par [[:chemins|chemin]] local (celui des données qu'on sauvegarde, sur la machine locale) et nom d'hôte (le nom de la machine locale). On peut donc sauvegarder plusieurs fois un chemin similaire depuis différentes machines sur un même dépôt sans risque de tout mélanger. | Pour commencer à utiliser **restic** il faut en premier lieu initialiser un dépôt avec la commande ''[[https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html|restic init]]''. C'est sur celui-ci qu'on effectuera les sauvegardes. Sur le dépôt les sauvegardes sont organisées par [[:chemins|chemin]] local (celui des données qu'on sauvegarde, sur la machine locale) et nom d'hôte (le nom de la machine locale). On peut donc sauvegarder plusieurs fois un chemin similaire depuis différentes machines sur un même dépôt sans risque de tout mélanger. |
| |
| Entrez la commande suivante dans un [[:terminal]] : | Entrez la commande suivante dans un [[:terminal]] : |
| Adaptez ''sftp:serveur:/chemin/restic-repo'' selon votre solution de stockage distant : | Adaptez ''sftp:serveur:/chemin/restic-repo'' selon votre solution de stockage distant : |
| |
| ''sftp:'' selon le protocole choisi, ou ''rclone:'' pour un dépôt [[:rclone]], puis ''serveur:'' pour le nom d'hôte. | ''sftp:'' selon le protocole choisi, ou ''rclone:'' pour un dépôt [[:rclone]], puis ''serveur:'' pour le nom d'hôte. Si vous utilisez un système de fichiers local (pour des sauvegardes sur un support externe par exemple), n'indiquez simplement pas de protocole, mais un [[:chemins|chemin]] de préférence [[:chemins#chemin_absolu|absolu]]. |
| |
| ==== Sauvegarde ==== | ==== Sauvegarde ==== |
| |
| C'est la commande ''[[https://restic.readthedocs.io/en/stable/040_backup.html|restic backup]]'' qui permet de délencher une sauvegarde. | C'est la commande ''[[https://restic.readthedocs.io/en/stable/040_backup.html|restic backup]]'' qui permet de déclencher une sauvegarde. |
| | |
| En ligne de commande, **restic** s'utilise un peu comme [[:rsync]] ou [[:rclone]]. | |
| |
| | En ligne de commande, **restic** s'utilise un peu comme [[:rsync]] ou [[:rclone]] : |
| <code>restic -r sftp:serveur:/chemin/restic-repo backup /chemin</code> | <code>restic -r sftp:serveur:/chemin/restic-repo backup /chemin</code> |
| |
| <code>restic -r sftp:serveur:/chemin/restic-repo ls latest /</code> | <code>restic -r sftp:serveur:/chemin/restic-repo ls latest /</code> |
| * On peut remplacer le mot clé ''latest'' (pour explorer le dernier instantané) par un identifiant récupéré grâce à la commande ''[[https://restic.readthedocs.io/en/stable/045_working_with_repos.html#listing-all-snapshots|snapshots]]'' précédente. | * On peut remplacer le mot clé ''latest'' (pour explorer le dernier instantané) par un identifiant récupéré grâce à la commande ''[[https://restic.readthedocs.io/en/stable/045_working_with_repos.html#listing-all-snapshots|snapshots]]'' précédente. |
| * ''/'' est le répertoire qu'on souhaite lister, ici la racine de cette sauvegarde. Ne pas indiquer de chemin permet de lister l'intégralité des fichiers sauvegardés où qu'ils se trouvent dans cet instantané. | * ''/'' est le répertoire qu'on souhaite lister, ici la [[:arborescence#racine]] de cette sauvegarde. Ne pas indiquer de chemin permet de lister l'intégralité des fichiers sauvegardés où qu'ils se trouvent dans cet instantané. |
| |
| À partir de la version **0.17** il est possible d'utiliser la commande ''[[:analyseur_usage_espace_disque#ncdu]]'' (après avoir [[:tutoriel:comment_installer_un_paquet|installé localement le paquet]] ''[[apt>ncdu]]'') pour explorer l'espace occupé par chaque répertoire dans un instantané : | À partir de la version **0.17** il est possible d'utiliser la commande ''[[:analyseur_usage_espace_disque#ncdu]]'' (après avoir [[:tutoriel:comment_installer_un_paquet|installé localement le paquet]] ''[[apt>ncdu]]'') pour explorer l'espace occupé par chaque répertoire dans un instantané : |
| === Montage === | === Montage === |
| |
| On peut aussi monter l'intégralité d'un dépôt en système local grâce à [[:FUSE]] afin d'explorer ses sauvegardes avec le [[:gestionnaire de fichiers]] de son choix, à commencer par [[:nautilus|GNOME Fichiers]] sur Ubuntu. | On peut aussi monter l'intégralité d'un dépôt en système local grâce à [[:FUSE]] afin d'explorer ses sauvegardes avec le [[:gestionnaire de fichiers]] de son choix, à commencer par **[[:nautilus|GNOME Fichiers]]** sur Ubuntu. |
| |
| Il faut pour cela créer un répertoire - ici ''/mnt/restic'' - et s'autoriser à le modifier : | Il faut pour cela créer un répertoire - ici ''/mnt/restic'' - et s'autoriser à le modifier : |
| Après quelques secondes, sous le [[:chemins|chemin]] ''/mnt/restic'' devraient se trouver les répertoires suivants : | Après quelques secondes, sous le [[:chemins|chemin]] ''/mnt/restic'' devraient se trouver les répertoires suivants : |
| * ''hosts'' contient la liste des instantanés triés par **noms d'hôtes** sauvegardés, | * ''hosts'' contient la liste des instantanés triés par **noms d'hôtes** sauvegardés, |
| * ''ids'' contient la liste des instantanés triés par **identifiant** (voir § [[#Explorer les sauvegardes]]), | * ''ids'' contient la liste des instantanés triés par **identifiant** (voir § //[[#Explorer les sauvegardes]]//), |
| * ''snapshots'' les liste par date, | * ''snapshots'' les liste par date, |
| * ''tags'' (//étiquettes// en français) est utile si on utilise [[https://restic.readthedocs.io/en/stable/manual_rest.html#manage-tags|cette fonctionnalité]]. | * ''tags'' (//étiquettes// en français) est utile si on utilise [[https://restic.readthedocs.io/en/stable/manual_rest.html#manage-tags|cette fonctionnalité]]. |
| Vous pouvez ainsi explorer vos sauvegardes avec l'outil de votre choix et copier-coller n'importe quel contenu pour le restaurer où vous voulez. | Vous pouvez ainsi explorer vos sauvegardes avec l'outil de votre choix et copier-coller n'importe quel contenu pour le restaurer où vous voulez. |
| |
| Pour terminer le montage, appuyez sur la touche ''C'' en laissant enfoncé la touche ''Ctrl'' dans la fenêtre de terminal que vous venez d'utiliser. | Pour terminer le montage, appuyez sur la touche ''C'' en laissant enfoncée la touche ''Ctrl'' (''Ctrl''+''C'') dans la fenêtre de terminal que vous venez d'utiliser. |
| |
| ==== Restauration ==== | ==== Restauration ==== |
| |
| La commande ''[[https://restic.readthedocs.io/en/stable/050_restore.html|restic restore]]'' permet de restaurer n'importe quel instantané précis. | Il existe plusieurs méthodes pour restaurer des données : |
| | * La commande ''[[https://restic.readthedocs.io/en/stable/050_restore.html|restic restore]]'' permet de restaurer n'importe quel instantané précis à l'emplacement de son choix, voir [[#Si l'arborescence originale correspond à l'arborescence actuelle|ci-dessous]]. |
| | * En utilisant la fonctionnalité de [[#montage]] présentée ci-dessus, on peut aussi copier précisément n'importe quel contenu à restaurer, depuis un répertoire monté vers un répertoire local, avec n'importe quelle technique de copie ou [[:gestionnaire de fichiers]], tel que **[[:nautilus|GNOME Fichiers]]**. |
| | * La commande ''[[https://restic.readthedocs.io/en/stable/050_restore.html#printing-files-to-stdout|restic dump]]'' décrite [[#explorer_les_sauvegardes|au-dessus]] permet d'afficher le contenu d'un fichier, ponctuellement, et de copier-coller depuis celui-ci. |
| | |
| | <note>Si possible, voir aussi la [[https://restic.readthedocs.io/en/stable/050_restore.html|documentation officielle]] en anglais à ce sujet.</note> |
| | |
| | === Si l'arborescence originale correspond à l'arborescence actuelle === |
| |
| <code>restic -r sftp:serveur:/chemin/restic-repo restore identifiant_instantané --target /chemin</code> | <code>restic -r sftp:serveur:/chemin/restic-repo restore identifiant_instantané --target /chemin</code> |
| |
| * L%%'%%''identifiant_instantané'' est un numéro à 8 chiffres hexadécimaux, récupéré en listant les sauvegardes avec la commande ''[[https://restic.readthedocs.io/en/stable/045_working_with_repos.html#listing-all-snapshots|snapshots]]'' (voir chapitre précédent). | * L%%'%%''identifiant_instantané'' est un numéro à 8 chiffres hexadécimaux, récupéré en listant les sauvegardes avec la commande ''[[https://restic.readthedocs.io/en/stable/045_working_with_repos.html#listing-all-snapshots|snapshots]]'' (voir [[#Explorer les sauvegardes|chapitre précédent]]). |
| * Le ''/chemin'' n'est ici pas celui du contenu sauvegardé, mais celui vers lequel on veut restaurer la sauvegarde. | |
| |
| On peut ainsi restaurer n'importe quelle sauvegarde à l'emplacement de son choix. | * Le ''/chemin'' de l'option ''%%--%%target'' n'est pas celui du contenu sauvegardé, mais celui vers lequel on veut restaurer la sauvegarde.\\ Si on souhaite restaurer un contenu "sur place" (à l'endroit d'où il vient, pour le rétablir à une version précédente), on indique avec l'option ''%%--%%target'' le chemin du champs ''Path'' tel que renseigné dans la [[#explorer_les_sauvegardes|liste des snapshots]] (celui-ci correspond à la //source// de la sauvegarde telle qu'on l'a configurée lors de sa [[#sauvegarde|mise en place]]). |
| |
| <note> | Pour restaurer un répertoire en particulier on peut utiliser l'option ''%%--%%include''. |
| En utilisant la fonctionnalité de [[#montage]] présentée ci-dessus, on peut aussi copier précisément n'importe quel contenu à restaurer, depuis un répertoire monté vers un répertoire local, avec n'importe quelle technique de copie ou [[:gestionnaire de fichiers]], tel que [[:nautilus|GNOME Fichiers]]. | |
| </note> | Par exemple si on sauvegarde depuis la [[:arborescence#racine]] ''/'', et qu'on souhaite seulement restaurer le répertoire ''/home'' et son contenu : |
| | <code>restic -r sftp:serveur:/chemin/restic-repo restore 12345678 --target / --include /home</code> |
| | |
| | On peut ainsi restaurer seulement un répertoire et son contenu. |
| | |
| | === Si l'arborescence originale diffère de l'arborescence actuelle === |
| | |
| | Si le chemin utilisé pour la sauvegarde diffère du chemin sur lequel on souhaite restaurer les données, on peut aussi spécifier le chemin à restaurer après l'identifiant de l'instantané, séparé par deux points '':''. |
| | |
| | Par exemple pour restaurer un répertoire ''/home/alice/Documents'' (à l'origine) vers ''/mnt/data/Documents'' (en destination), entrer une commande du type : |
| | <code>restic -r sftp:serveur:/chemin/restic-repo restore 12345678:/home/alice/Documents /mnt/data/Documents</code> |
| |
| ===== Interfaces graphiques ===== | ===== Interfaces graphiques ===== |
| ===== Wrappers ===== | ===== Wrappers ===== |
| |
| Les //wrappers//((pas de traduction tangible en français... emballage ?)) permettent d'étendre les fonctionnalités de **restic** en l'utilisant comme "moteur" sous-jacent plus ou moins visible. | Les //wrappers//((pas de traduction pertinente en français... //emballeurs// ?)) permettent d'étendre les fonctionnalités de **restic** en l'utilisant comme "moteur" sous-jacent plus ou moins visible. |
| |
| * **[[https://github.com/creativeprojects/resticprofile|Resticprofile]]** complète **restic** à la perfection, en implémentant un [[https://creativeprojects.github.io/resticprofile/configuration/index.html|fichier de configuration]] pour faciliter l'usage de la ligne de commande avec **restic**. Il permet aussi de [[https://creativeprojects.github.io/resticprofile/schedules/index.html|programmer]] très facilement des sauvegardes récurrentes aux moments de son choix (en utilisant [[:systemd]] en arrière-plan, ou [[:cron]] dans le cas étonnant ou celui-ci ne serait pas disponible), et de définir une politique de [[https://creativeprojects.github.io/resticprofile/reference/profile/retention/index.html|rétention]] pour ces instantanés. Sa [[https://creativeprojects.github.io/resticprofile/index.html|documentation]] est en anglais mais vous pouvez si besoin vous aider de [[:tutoriel:resticprofile#resticprofile|notre tutoriel]]. | * **[[https://github.com/creativeprojects/resticprofile|Resticprofile]]** complète **restic** à la perfection, en implémentant un [[https://creativeprojects.github.io/resticprofile/configuration/index.html|fichier de configuration]] pour faciliter l'usage de la ligne de commande avec **restic**. Il permet aussi de [[https://creativeprojects.github.io/resticprofile/schedules/index.html|programmer]] très facilement des sauvegardes récurrentes aux moments de son choix (en utilisant [[:systemd]] en arrière-plan, ou [[:cron]] dans le cas étonnant ou celui-ci ne serait pas disponible), et de définir une politique de [[https://creativeprojects.github.io/resticprofile/reference/profile/retention/index.html|rétention]] pour ces instantanés. Sa [[https://creativeprojects.github.io/resticprofile/index.html|documentation]] est en anglais mais vous pouvez si besoin vous aider de [[:tutoriel:resticprofile#resticprofile|notre tutoriel]]. |
| * **[[https://github.com/cupcakearmy/autorestic|Autorestic]]** propose à peu près les mêmes fonctionnalités que **resticprofile**, mais sans faciliter l'usage de **restic** en ligne de commande. Il ne fonctionne que de manière déclarative - par l'usage de fichiers de configuration, de manière un peu plus directive (avoir moins de choix à disposition peut aussi permettre de simplifier la [[https://autorestic.vercel.app|documentation]]). Il facilite si besoin la gestion de dépôts multiples (par ex. pour sauvegarder sur un disque dur en même temps que sur le [[:cloud]]). | * **[[https://github.com/cupcakearmy/autorestic|Autorestic]]** propose à peu près les mêmes fonctionnalités que **resticprofile**, mais sans faciliter l'usage de **restic** en ligne de commande. Il ne fonctionne que de manière déclarative - par l'usage de fichiers de configuration, de manière un peu plus directive (avoir moins de choix à disposition peut aussi permettre de simplifier la [[https://autorestic.vercel.app|documentation]]). Il facilite si besoin la gestion de dépôts multiples (par ex. pour sauvegarder sur un disque dur en même temps que sur le //[[:cloud]]//). |
| |
| Voir aussi [[https://github.com/rubiojr/awesome-restic?tab=readme-ov-file#wrappers|cette liste]] plus complète. | Voir aussi [[https://github.com/rubiojr/awesome-restic?tab=readme-ov-file#wrappers|cette liste]] plus complète. |
| * **//(en)//** [[https://github.com/restic/restic|sources et site officiel]] | * **//(en)//** [[https://github.com/restic/restic|sources et site officiel]] |
| * **//(en)//** [[https://restic.readthedocs.io/en/stable/|documentation]] | * **//(en)//** [[https://restic.readthedocs.io/en/stable/|documentation]] |
| * //[[:tutoriel:resticprofile|Sauvegarder sur une box Internet grâce à Restic]]// : tutoriel décrivant la mise en place de sauvegarde régulière et automatisées au moyen de **restic**, **[[:rclone]]** et **[[#wrappers|resticprofile]]**.\\ On peut l'adapter facilement pour sauvegarder sur l'un des innombrables [[https://github.com/rclone/rclone#storage-providers|services cloud et protocoles réseau]] que supporte **[[:rclone]]** ! | * //[[:tutoriel:resticprofile|Sauvegarder sur une box Internet grâce à Restic]]// : tutoriel décrivant la mise en place de sauvegardes régulières et automatisées au moyen de **restic**, **[[:rclone]]** et **[[#wrappers|resticprofile]]**.\\ On peut l'adapter facilement pour sauvegarder sur l'un des innombrables [[https://github.com/rclone/rclone#storage-providers|services cloud et protocoles réseau]] que supporte **[[:rclone]]** ! |
| |
| ---- | ---- |
| //Contributeur : [[:utilisateurs:krodelabestiole]]// | //Contributeur : [[:utilisateurs:krodelabestiole]]// |