✎ tutoriel:resticprofile [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

{{ :logo:restic.png?130|Logo de Restic}}
====== Sauvegarder sur une box Internet grâce à Restic ======

Ce tutoriel décrit comment mettre mettre en place un dépôt de sauvegarde sur un disque dur connecté à une //box// Internet (ici une //freebox//) afin de sauvegarder ses données depuis n'importe où (et idéalement ailleurs, peut-être chez la famille ou chez des ami·e·s).

Pour ce tutoriel nous utiliserons le //[[:restic#wrappers|wrapper]]// **[[https://github.com/creativeprojects/resticprofile|resticprofile]]** afin de nous faciliter l'utilisation de **[[:restic]]**, et **[[:rclone]]** pour nous connecter à la //freebox//.

===== Prérequis =====

**Resticprofile** est un outil qui s'utilise en [[:tutoriel:console_ligne_de_commande|ligne de commande]], il est donc recommandé d'être à l'aise avec le [[:terminal]], ou au moins d'en connaître les [[:tutoriel:console_commandes_de_base|rudiments]].\\ 
Si ce n'est pas le cas mieux vaut commencer par essayer de vous former un minimum en consultant [[:tutoriel:console_ligne_de_commande|cette documentation]], en particulier les chapitres concernant les commandes ''[[:tutoriel:console_ligne_de_commande#ls]]'', ''[[:tutoriel:console_ligne_de_commande#cd]]'', ''[[:tutoriel:console_ligne_de_commande#mkdir]]'', ''[[:tutoriel:console_ligne_de_commande#mv]]'', ''[[:tutoriel:console_ligne_de_commande#cp]]'', et ''[[:tutoriel:console_ligne_de_commande#rm]]''.

<note warning>La plupart de ces outils ne sont malheureusement pas traduits en français pour le moment, ni leurs documentations officielles. N'hésitez pas à demander de l'aide sur le forum si besoin !</note>

==== Nom de domaine ====

//Free// (et peut-être d'autres fournisseurs d'accès) propose de faire pointer un sous-domaine de ''.freeboxos.fr'' vers les connexions de leurs clients. Cette fonctionnalité facilite l'accès à ses services auto-hébergés depuis n'importe où sur Internet : pas besoin de [[:tutoriel:connaitre_son_adresse_ip|noter une adresse IP]] qui est susceptible de changer, et vous pourrez profiter d'un [[:tutoriel:comment_creer_un_certificat_ssl|certificat TLS / RSA]] valide, le tout sans frais supplémentaire.\\ 
Pour l'activer rendez-vous dans les //Paramètres de la Freebox// -> //Nom de domaine//.\\ 
Voir si besoin [[https://www.universfreebox.com/article/53008/le-saviez-vous-vous-pouvez-acceder-aux-contenus-du-freebox-server-depuis-n-importe-ou-avec-un-nom-de-domaine-personnalise|cette documentation]] sur //Univers Freebox//.

Si votre fournisseur d'accès ne propose pas ce service, vous pouvez vous rabattre sur un [[:DNS dynamique]], mais il risque d'être plus compliqué d'installer un certificat valide.

===== Partage de l'espace de stockage =====

Une fois le disque dur connecté à la //freebox//, on accède à la gestion de celle-ci en se rendant sur la page [[http://mafreebox.freebox.fr/]].

Dans //Paramètres de la Freebox// (entrez votre mot de passe si nécessaire) cliquez sur FTP, activez le partage par FTP et renseignez un mot de passe extraordinairement complexe et long, sans mot du dictionnaire : ce sera la seule protection de vos données exposées sur Internet.

Activez ensuite l'accès à distance. En bas de la fenêtre est affichée l'[[:web#URL]] de votre partage :\\ 
> //Votre serveur FTP sera accessible à distance sur ''ftpes:%%//%%freebox@exemple.freeboxos.fr:1234''//\\ 
Notez ces informations :

* ''freebox'' est votre nom d'utilisateur.
  * ''exemple.freeboxos.fr'' est votre hôte.
  * ''1234'' est le numéro de port.
  * notez évidemment aussi votre mot de passe (avec un gestionnaire de mot de passe, tel que [[:KeePassXC]] par ex.)

===== Rclone =====

[[:Rclone]] va nous permettre de nous connecter au stockage de la Freebox depuis n'importe où.

[[:rclone#installation|Installez rclone]] et mettez-le à jour à sa dernière version :
<code>sudo apt install rclone
sudo rclone selfupdate</code>

Créez un fichier de configuration ''~/.config/rclone/rclone.conf'' qui contiendra les informations de connexion :
<file - rclone.conf>[freebox]
type = ftp
host = exemple.freeboxos.fr
user = freebox
port = 1234
pass = hash_du_mot_de_passe
explicit_tls = true</file>

Adaptez évidemment ces informations avec celles recueillies au chapitre précédent !
  * Remplacez ''exemple.freeboxos.fr'' par votre hôte.
  * ''1234'' par votre numéro de port.
  * Pour obtenir le ''hash_du_mot_de_passe'', entrez la commande suivante en remplaçant ''votre_mot_de_passe'' par celui du chapitre précédent :<code> rclone obscure 'votre_mot_de_passe'</code>Le retour de cette commande est votre //hash//. Conserver un espace au début de la commande (avant ''rclone'') permet d'éviter d'enregistrer votre mot de passe en clair dans votre [[:terminal#l_historique_des_commandes|historique]].

À partir de maintenant on n'aura qu'à simplement utiliser l'identifiant ''freebox:'' de **rclone** pour profiter de cette connexion à la //freebox//.

Vous pouvez vérifier que tout fonctionne bien en tapant
  rclone ls freebox:

ou utiliser [[:analyseur_usage_espace_disque#ncdu]] pour explorer le stockage de votre freebox :
  rclone ncdu freebox:
  
===== Restic =====

[[:Restic]] est le moteur de sauvegarde.

[[:restic#installation|Installez-le]] et mettez-le aussi à jour à sa dernière version :
<code>sudo apt install restic
sudo restic self-update</code>

On peut ensuite initier un dépôt restic sur la freebox :
<code>restic -r rclone:freebox:/disque_dur/restic init</code>
  * Remplacez ''disque_dur'' par le nom de votre stockage sur la freebox.
  * On créera ici un nouveau mot de passe **pour restic** qu'on notera pour la suite.
Cette commande y créera un répertoire ''restic'' contenant votre dépôt restic (donc vos sauvegardes).

===== Resticprofile =====

**[[https://github.com/creativeprojects/resticprofile|Resticprofile]]** permet de simplifier l'usage de **restic** et d'automatiser facilement les sauvegardes.

Pour [[https://creativeprojects.github.io/resticprofile/installation/linux/index.html|l'installer]] :
<code>sudo apt install curl
curl -LO https://raw.githubusercontent.com/creativeprojects/resticprofile/master/install.sh
chmod +x install.sh
sudo ./install.sh -b /usr/local/bin
rm install.sh</code>

On peut alors créer un fichier de configuration ''~/.config/resticprofile/profiles.yaml'' :
<file - profiles.yaml>version: "1"

default:
  repository: "rclone:freebox:/disque_dur/restic"
  password-file: "password.txt"

backup:
    source:
      - "/home"
    exclude:
      - "/**/ImapMail/"
      - "/**/cache/"
      - "/**/.cache/"
      - "/**/cache2/"
      - "/**/storage/"
    schedule: '*-*-* 20:00:00'
    retention:
      keep-daily: 7
      keep-weekly: 4
      keep-monthly: 12
      keep-yearly: "unlimited"</file>
  * Remplacez ''/disque_dur/'' par le nom de votre stockage sur la freebox.
  * Vous pouvez ajuster les éléments à sauvegarder (//source// du //backup//) et ceux à exclure (//exclude//) en fonction de vos besoins.
  * Voir la [[https://creativeprojects.github.io/resticprofile/schedules/configuration/index.html#schedule|documentation]] pour l'utilisation de //schedule//, qui permet de **programmer les sauvegardes automatiques** (ici tous les jours à 20h).
  * Voir aussi la [[https://creativeprojects.github.io/resticprofile/reference/profile/retention/index.html|documentation]] concernant la **politique de rétention** : on conserve ici les instantanés quotidiens pendant 7 jours, les hebdomadaires pendant 4 semaines, les mensuels pendant 12 mois et les annuels éternellement.

On peut définir le mot de passe en clair dans un fichier ''password.txt'' :
   echo "mot_de_passe_restic" > ~/.config/resticprofile/password.txt

Attention évidemment à garder ce fichier personnel et secret :
   chmod 400 ~/.config/resticprofile/password.txt

À partir de là on peut utiliser la commande ''resticprofile'' sans avoir besoin de préciser tous les arguments que requiert ''restic'' ni le mot de passe (les [[:restic#utilisation|sous-commandes restic]] sont aussi disponibles avec ''resticprofile'') :

* On pourra ainsi lancer une première sauvegarde avec un simple :<code>resticprofile backup</code>
  * Pour lister tous les instantanés il suffit d'entrer :<code>resticprofile</code>
  * Et par exemple<code>resticprofile ls latest</code>pour lister les fichiers de la dernière sauvegarde.
  * Si tout va bien et que la sauvegarde se passe bien, on peut activer le déclenchement automatique des sauvegardes régulières avec la sous-commande ''[[https://creativeprojects.github.io/resticprofile/schedules/commands/index.html|schedule]]'' :<code>resticprofile schedule --all</code>
  * Pour voir si la programmation des sauvegardes fonctionne bien :<code>resticprofile status</code>

----
//Contributeur : [[:utilisateurs:krodelabestiole]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : F U A C V Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported