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:
- Komprimieren der ausgewählten Daten,
- Verschlüsseln – bei aktivierter clientseitiger Ende-zu-Ende-Verschlüsselung verlässt nur Geheimtext Ihr System,
- Ü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.
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_errorin derlionbackup.yamlist das Verhalten wählbar:warn(Default) oderabortfü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-VMes 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: abortbricht 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
| Stufe | Wann | Wenn der Befehl scheitert |
|---|---|---|
pre_backup | vor allem anderen, noch vor dem Prüfen der Quellen | Der Lauf sichert nichts. |
post_snapshot | sobald die Schattenkopie steht, sonst nach dem Lesen | Die Sicherung läuft weiter, endet aber mit Fehler. |
post_backup | immer zum Schluss, auch nach Fehlern | Der 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.
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.