Aller au contenu principal

Le client lionbackup

La sauvegarde s'effectue via un client léger écrit en Go, fourni en tant que client open source.

Ce que fait le client​

Le client prend en charge toute la partie locale d'une sauvegarde :

  1. Compresser les données sélectionnées,
  2. Chiffrer — avec le chiffrement de bout en bout côté client activé, seul du texte chiffré quitte votre système,
  3. Transférer vers une Citadelle disponible de la Storage Zone choisie.

Si un point de terminaison échoue pendant le transfert, le client bascule automatiquement vers une autre Citadelle disponible.

Plateformes​

Le client prend en charge Linux, Windows et macOS (bêta). Des binaires précompilés sont disponibles au téléchargement ; le code source est consultable publiquement.

Configuration​

Pour le fonctionnement, vous renseignez dans la configuration locale :

  • le jeton d'accès lié au projet,
  • avec le chiffrement côté client, le matériel de clés,
  • les chemins ou sources de données à sauvegarder.
Open source

Le client étant open source, il est possible de vérifier comment se déroulent la compression, le chiffrement et le transfert — une transparence en phase avec l'orientation souveraine de lionbackup.

Un déroulé complet de la connexion à la première sauvegarde est disponible sous Premiers pas.

Plusieurs tâches de sauvegarde sur une même machine​

Un projet peut avoir plusieurs configurations, par exemple une exécution quotidienne pour les documents et une hebdomadaire pour la base de données. Chaque configuration nomme sa tâche avec name: :

lionbackup:
name: daily-docs

Le nom apparaît dans la sortie et dans le nom du fichier journal (lionbackup-<name>-YYYYMMDD.log). Plusieurs configurations peuvent ainsi partager un même log_directory sans que leurs lignes se mélangent dans un seul fichier. Si name: manque, le client le déduit du nom de fichier de la configuration (daily-docs.yaml → daily-docs). Il est recommandé de garder le nom de fichier et name: identiques.

Erreurs de lecture, dossiers spéciaux Windows et transparence​

Depuis le client v0.1.2 :

  • Les jonctions héritées de Windows (liens de compatibilité cachés comme « Mes images » dans le profil) sont toujours ignorées – illisibles par conception, elles ne contiennent aucune donnée.
  • Les erreurs de lecture sous une source (accès refusé, fichier supprimé pendant l'exécution) donnent par défaut un avertissement + saut ; le client indique à la fin le total des éléments ignorés. Une source absente ou illisible interrompt toujours l'exécution.
  • Le comportement se règle via on_read_error dans lionbackup.yaml : warn (défaut) ou abort pour échouer à la première erreur.
on_read_error: warn # ou : abort

Le client commente ses étapes (« Étape 1/3 : vérification des sources … », progression du scan chaque seconde) : même sur de très gros répertoires, on voit immédiatement ce qui se passe.

Windows : fichiers ouverts via cliché instantané​

Sous Windows, le client lit les fichiers qu'un programme tient ouverts en exclusivité depuis un cliché instantané (VSS) du lecteur. C'est activé par défaut (use_vss: true) et nécessite des droits d'administrateur. Sans ces droits, le client ignore les fichiers verrouillés, sauvegarde le reste et les signale dans le journal. Pour les sauvegardes via le Planificateur de tâches, choisissez donc « Exécuter avec les autorisations maximales ».

Le cliché instantané lit certes les fichiers d'une base de données en cours d'exécution, mais sans solliciter la base de données. Ce qui est fiable, c'est une sauvegarde écrite par la base de données elle-même, par exemple via une commande pre_backup (voir ci-dessous) dans un dossier que le client sauvegarde.

VM Hyper-V​

À partir du client 0.2.0, le client sauvegarde des VM entières sur un Windows Server doté du rôle Hyper-V. La configuration ne contient que leurs noms, tels que Get-VM les affiche ; à chaque exécution, le client demande à Hyper-V quels fichiers en font partie.

lionbackup:
hyperv:
vms:
- FILESRV01
- DC01 # ou "*" pour toutes les VM de l'hôte
files: # facultatif, peut être omis
- D:\Partages
  • Cohérence applicative, sans arrêt. Le cliché instantané est créé via DiskShadow avec le writer Hyper-V. Avec le service d'intégration de sauvegarde (cliché instantané de volume) dans l'invité, il s'agit d'une sauvegarde en ligne, au cours de laquelle des applications comme SQL Server deviennent elles aussi cohérentes ; sans lui, Hyper-V met brièvement la VM en état enregistré.
  • Une sauvegarde par VM, structurée comme une exportation Hyper-V. Après la restauration, Import-VM l'importe comme copie avec un nouvel ID.
  • Sauvegarde complète. Chaque exécution sauvegarde la VM entière. Nous relevons sur demande la limite standard de 100 Go par sauvegarde (voir Limites).
  • Prérequis. Windows Server 2025 ou 2022, client exécuté en tant qu'administrateur, fichiers des VM sur des volumes locaux d'un hôte autonome. Le client refuse avec un message les VM sur des Cluster Shared Volumes ou des partages SMB, les disques pass-through et les VHD Sets. Sans DiskShadow (Windows 10/11), ou si le writer Hyper-V échoue, il ne sauvegarde qu'avec une cohérence de type crash et avertit ; on_writer_error: abort interrompt à la place.
  • Points de contrôle plus anciens après l'importation. Un point de contrôle qui existait déjà avant la sauvegarde ne démarre avec Secure Boot dans la VM importée qu'après avoir redéfini le modèle Secure Boot (Set-VMFirmware -VM $vm -EnableSecureBoot On -SecureBootTemplate MicrosoftWindows). Après une importation depuis l'exportation propre à Hyper-V, c'est pareil.

Un guide pas à pas avec test de restauration se trouve sur le blog : Sauvegarder des VM Hyper-V sans les éteindre et Restaurer une VM Hyper-V depuis le cloud.

Commandes avant et après la sauvegarde​

À partir du client 0.2.0, le client exécute vos propres commandes indiquées sous hooks:, par exemple un dump de la base de données avant la sauvegarde :

lionbackup:
hooks:
pre_backup:
- 'C:\Scripts\sauvegarder-base.cmd'
post_backup:
- 'C:\Scripts\apres-sauvegarde.cmd'
timeout_sec: 3600 # par commande, 3600 par défaut
ÉtapeQuandSi la commande échoue
pre_backupavant tout le reste, avant même la vérification des sourcesL'exécution ne sauvegarde rien.
post_snapshotdès que le cliché instantané existe, sinon après la lectureLa sauvegarde continue, mais se termine par une erreur.
post_backuptoujours à la fin, même après des erreursL'exécution se termine par une erreur.

Placez les commandes entre apostrophes simples : sinon, un deux-points suivi d'une espace ou un # dans la commande casse le YAML. Sous Windows, elles s'exécutent via cmd.exe /C, sous Linux et macOS via /bin/sh -c.

Les commandes s'exécutent avec les droits du client

Quiconque peut modifier la configuration peut s'en servir pour exécuter des commandes, sur un serveur souvent en tant qu'administrateur. Enregistrez la configuration de sorte que seuls les administrateurs puissent la modifier. Sous Linux et macOS, le client refuse hooks: dans une configuration modifiable par le groupe ou par tous.