Zum Hauptinhalt springen

Der lionbackup-Client

Die Sicherung erfolgt über eine schlanke, in Go geschriebene Client-Software, die als quelloffener Client bereitgestellt wird.

Was der Client tut​

Der Client übernimmt den gesamten lokalen Teil eines Backup-Laufs:

  1. Komprimieren der ausgewählten Daten,
  2. Verschlüsseln – bei aktivierter clientseitiger Ende-zu-Ende-Verschlüsselung verlässt nur Geheimtext Ihr System,
  3. Übertragen an einen verfügbaren Citadel der gewählten Storage-Zone.

Schlägt während der Übertragung ein Endpunkt fehl, wechselt der Client selbsttätig auf einen anderen verfügbaren Citadel.

Plattformen​

Der Client unterstützt Linux, Windows und macOS (Beta). Vorgebaute Binärdateien stehen zum Download bereit; der Quellcode ist öffentlich einsehbar. Zusätzlich gibt es eine grafische Oberfläche, den lionbackup Wizard.

Konfiguration​

Für den Betrieb hinterlegen Sie in der lokalen Konfiguration:

  • das projektbezogene Zugriffstoken,
  • bei clientseitiger Verschlüsselung das Schlüsselmaterial,
  • die zu sichernden Pfade bzw. Datenquellen.
Open Source

Da der Client quelloffen ist, lässt sich nachvollziehen, wie Komprimierung, Verschlüsselung und Übertragung ablaufen – Transparenz, die zur souveränen Ausrichtung von lionbackup passt.

Ein vollständiger Ablauf vom Login bis zum ersten Lauf steht unter Erste Schritte.

Mehrere Sicherungsaufträge auf einem Rechner​

Ein Projekt kann mehrere Konfigurationen haben – etwa einen täglichen Lauf für Dokumente und einen wöchentlichen für die Datenbank. Jede Konfiguration benennt ihren Auftrag über name::

lionbackup:
name: daily-docs

Der Name erscheint in der Ausgabe und im Namen der Logdatei (lionbackup-<name>-YYYYMMDD.log). Mehrere Konfigurationen können sich damit ein log_directory teilen, ohne dass ihre Zeilen in einer Datei durcheinandergeraten. Fehlt name:, leitet der Client ihn aus dem Dateinamen der Konfiguration ab (daily-docs.yaml → daily-docs). Es empfiehlt sich, Dateinamen und name: gleich zu halten.

Lesefehler, Windows-Sonderordner und Ablauf-Transparenz​

Seit Client v0.1.2 gilt beim Sichern:

  • Windows-Legacy-Junctions (versteckte Kompatibilitäts-Verweise wie „Eigene Bilder" im Profilordner) werden immer übersprungen – sie sind systemseitig unlesbar und enthalten keine Daten.
  • Lesefehler unterhalb einer Quelle (Zugriff verweigert, Datei während des Laufs entfernt) führen standardmäßig zu einer Warnung + Überspringen; am Ende meldet der Client die Summe der übersprungenen Einträge. Eine fehlende oder unlesbare Quelle selbst bricht weiterhin ab.
  • Über on_read_error in der lionbackup.yaml ist das Verhalten wählbar: warn (Default) oder abort für den harten Abbruch beim ersten Fehler.
on_read_error: warn # oder: abort

Der Client erklärt seine Schritte („Schritt 1/3: Quellen prüfen …", „Quelle 2/5: …", Scan-Zwischenstand jede Sekunde), sodass auch bei großen Verzeichnissen sofort sichtbar ist, was gerade passiert.

Windows: geöffnete Dateien per Schattenkopie​

Was ein Programm gerade exklusiv geöffnet hält, liest der Client unter Windows aus einer Schattenkopie (VSS) des Laufwerks. Das ist standardmäßig eingeschaltet (use_vss: true) und braucht Administratorrechte. Fehlen sie, überspringt der Client gesperrte Dateien, sichert den Rest und nennt sie im Protokoll. Für Sicherungen über die Aufgabenplanung deshalb „Mit höchsten Privilegien ausführen" wählen.

Die Dateien einer laufenden Datenbank liest die Schattenkopie zwar, fragt die Datenbank dabei aber nicht. Verlässlich ist eine Sicherung, die die Datenbank selbst schreibt, etwa per pre_backup-Befehl (siehe unten) in einen Ordner, den der Client sichert.

Hyper-V-VMs​

Ab Client 0.2.0 sichert der Client auf einem Windows Server mit Hyper-V-Rolle ganze VMs. In der Konfiguration stehen nur ihre Namen, wie Get-VM sie zeigt; welche Dateien dazugehören, fragt der Client bei jedem Lauf bei Hyper-V nach.

lionbackup:
hyperv:
vms:
- FILESRV01
- DC01 # oder "*" für alle VMs des Hosts
files: # optional, darf fehlen
- D:\Freigaben
  • Anwendungskonsistent, ohne Herunterfahren. Die Schattenkopie entsteht über DiskShadow mit dem Hyper-V-Writer. Mit dem Integrationsdienst „Sicherung (Volumeschattenkopie)" im Gast ist das eine Online-Sicherung, bei der auch Anwendungen wie SQL Server konsistent werden; ohne ihn versetzt Hyper-V die VM kurz in den gespeicherten Zustand.
  • Je VM ein Backup, aufgebaut wie ein Export von Hyper-V. Nach dem Wiederherstellen liest Import-VM es als Kopie mit neuer ID ein.
  • Vollsicherung. Jeder Lauf sichert die ganze VM. Das Standardlimit von 100 GB je Backup (siehe Limits) heben wir auf Anfrage an.
  • Voraussetzungen. Windows Server 2025 oder 2022, Client als Administrator, VM-Dateien auf lokalen Volumes eines eigenständigen Hosts. VMs auf Cluster Shared Volumes oder SMB-Freigaben, Pass-through-Platten und VHD-Sets lehnt der Client mit Meldung ab. Ohne DiskShadow (Windows 10/11) oder wenn der Hyper-V-Writer scheitert, sichert er nur absturzkonsistent und warnt; on_writer_error: abort bricht stattdessen ab.
  • Ältere Prüfpunkte nach dem Import. Ein Prüfpunkt, der schon vor der Sicherung bestand, startet in der importierten VM mit Secure Boot erst, wenn vorher das Secure-Boot-Template neu gesetzt wird (Set-VMFirmware -VM $vm -EnableSecureBoot On -SecureBootTemplate MicrosoftWindows). Nach einem Import aus Hyper-Vs eigenem Export ist das genauso.

Eine Schritt-für-Schritt-Anleitung mit Restore-Test steht im Blog: Hyper-V-VMs sichern und Hyper-V-VM aus der Cloud wiederherstellen.

Befehle vor und nach der Sicherung​

Ab Client 0.2.0 führt der Client unter hooks: eigene Befehle aus, etwa einen Datenbank-Dump vor der Sicherung:

lionbackup:
hooks:
pre_backup:
- 'C:\Skripte\datenbank-sichern.cmd'
post_backup:
- 'C:\Skripte\nach-der-sicherung.cmd'
timeout_sec: 3600 # je Befehl, Default 3600
StufeWannWenn der Befehl scheitert
pre_backupvor allem anderen, noch vor dem Prüfen der QuellenDer Lauf sichert nichts.
post_snapshotsobald die Schattenkopie steht, sonst nach dem LesenDie Sicherung läuft weiter, endet aber mit Fehler.
post_backupimmer zum Schluss, auch nach FehlernDer Lauf endet mit Fehler.

Befehle in einfache Anführungszeichen setzen: Ein Doppelpunkt mit Leerzeichen oder ein # im Befehl bricht sonst das YAML. Ausgeführt wird unter Windows über cmd.exe /C, unter Linux und macOS über /bin/sh -c.

Befehle laufen mit den Rechten des Clients

Wer die Konfiguration ändern darf, kann damit Befehle ausführen, auf einem Server oft als Administrator. Legen Sie die Konfiguration so ab, dass nur Administratoren sie ändern dürfen. Unter Linux und macOS lehnt der Client hooks: in einer Konfiguration ab, die Gruppe oder Welt beschreiben dürfen.