ERPC

SLV Backup - Démarrage rapide

🗄️ SLV Backup

SLV Backup crée des sauvegardes chiffrées et incrémentales de votre nœud à l'aide de restic. Toutes les données sont chiffrées côté client en AES-256 avant l'envoi — le serveur ne voit jamais vos données en clair.
Mode hérité : SLV prend aussi en charge les sauvegardes tar+zstd non chiffrées (sans --restic). Nous recommandons vivement d'utiliser --restic pour toutes les nouvelles sauvegardes.

Prérequis

  • SLV CLI installé sur le nœud cible
  • Accès sudo (requis pour la sauvegarde complète du disque)
  • Connexion effectuée (slv login) avec un abonnement de stockage actif
  • restic installé (apt install restic)

Créer une sauvegarde chiffrée

bash
sudo slv backup create --restic --yes
🗄️  SLV Backup (restic mode)

  Region:    default
  Retention: 7 days

⚠️  Restic encryption password generated and saved to:
   /home/solv/.slv/restic-password
   BACK UP THIS FILE — without it, backups cannot be restored.

🔧 Initializing restic repository (if needed)...
📦 Creating restic backup...

Files:       151263 new,     0 changed,     0 unmodified
Dirs:        22486 new,     0 changed,     0 unmodified
Added to the repository: 4.107 GiB (1.837 GiB stored)

processed 151263 files, 4.366 GiB in 0:50
snapshot b6925e6d saved

✅ Restic backup complete
🧹 Applying retention policy (keep within 7 days)...
✅ Backup complete.

Ce qui se passe à la première exécution

  1. Un mot de passe de chiffrement aléatoire est généré et enregistré dans ~/.slv/restic-password (mode 0600)
  2. Un dépôt restic est initialisé sur ERPC Cloud Storage
  3. L'intégralité de votre disque est sauvegardée (hors pseudo-systèmes de fichiers du système)

Exécutions suivantes

Seuls les fichiers modifiés sont envoyés (sauvegarde incrémentale). La déduplication permet de limiter les coûts de stockage.

Lister les sauvegardes

bash
sudo slv backup list
Affiche à la fois les snapshots restic et les sauvegardes tar du mode hérité présentes dans le stockage cloud.

Restaurer depuis une sauvegarde

Restaurer le dernier snapshot :
bash
sudo slv backup restore latest
Restaurer un snapshot précis :
bash
sudo slv backup restore b6925e6d
Restaurer une sauvegarde tar du mode hérité :
bash
sudo slv backup restore backup-mynode-20260318.tar.zst

Vérifier l'intégrité des sauvegardes

Pour exécuter restic check vous-même, connectez-vous avec une clé d'accès au stockage. Les clés d'API RPC ne sont pas acceptées sur cet endpoint.
  1. Ouvrez la page Storage, allez dans Clés d'accès au stockage, puis cliquez sur Émettre une clé. Lecture seule suffit pour check.
  2. Copiez l'URL du dépôt restic affichée juste après la création de la clé. Elle n'est affichée qu'une seule fois : si vous la perdez, révoquez la clé et émettez-en une nouvelle.
  3. Exécutez check avec cette URL :
bash
sudo restic -r '<RESTIC_REPOSITORY_URL>' \
  --password-file ~/.slv/restic-password check

Configurer des sauvegardes automatiques (Cron)

bash
sudo slv backup create --restic --cron daily
IntervalleDescription
dailyExécution une fois par jour
weeklyExécution une fois par semaine
monthlyExécution une fois par mois
offSupprime la tâche cron

Rétention

Par défaut, les snapshots de plus de 7 jours sont supprimés automatiquement :
bash
sudo slv backup create --restic --retention 14

Personnaliser les exclusions

Afficher la liste d'exclusions actuelle :
bash
slv backup create --list-excludes
Ajouter des chemins à exclure :
bash
sudo slv backup create --restic --exclude /home/solv/ledger --exclude /home/solv/snapshots

Chiffrement et sécurité

FonctionnalitéDétail
ChiffrementAES-256-CTR + Poly1305-AES (côté client)
IntégritéStockage adressé par le contenu (SHA-256)
DéduplicationDécoupage en blocs défini par le contenu
Visibilité côté serveurAucune — le serveur ne voit que des blobs chiffrés
Fichier de mot de passe~/.slv/restic-password (mode 0600)
Exclus de la sauvegarde~/.slv/restic-password, ~/.slv/api.yml, ~/.slv/backup.env
⚠️ IMPORTANT : sauvegardez séparément votre fichier ~/.slv/restic-password. Sans lui, vos sauvegardes sont irrémédiablement perdues.

Référence des options

OptionDescription
--resticUtilise restic pour une sauvegarde incrémentale chiffrée (recommandé)
-r, --region <region>Région de stockage (par défaut : eu)
--exclude <path>Chemins supplémentaires à exclure (répétable)
--include <path>Retire un chemin des exclusions par défaut (répétable)
--list-excludesAffiche la liste d'exclusions actuelle puis quitte
--retention <days>Supprime les snapshots de plus de N jours (par défaut : 7)
--cron <interval>Configure une tâche cron (daily/weekly/monthly/off)
-y, --yesIgnore les demandes de confirmation
--uploadMode hérité : envoie la sauvegarde tar vers le stockage cloud
-o, --output <path>Mode hérité : chemin du fichier de sortie de la sauvegarde tar

Mode hérité (tar+zstd)

Pour assurer la rétrocompatibilité, les sauvegardes tar non chiffrées restent prises en charge :
bash
sudo slv backup create --upload --yes     # Unencrypted tar backup
Remarque : les sauvegardes du mode hérité ne sont pas chiffrées. Nous recommandons de passer à --restic pour toutes les nouvelles sauvegardes.
PrécédentServeurs / Global Storage / Augmenter ou réduire le stockageSuivantRestaurer depuis une sauvegarde