So konfigurieren Sie Btrfs Send und Receive für inkrementelle Offsite-Backups

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Mit Btrfs send und receive lassen sich schreibgeschützte Subvolume-Snapshots zu einer effizienten externen Sicherungskette replizieren. Bei der ersten Übertragung wird ein vollständiger Snapshot gesendet. Bei späteren Übertragungen dient ein zuvor replizierter Snapshot als übergeordneter Snapshot, sodass nur die Änderungen, die zum Wiederherstellen des neuen Snapshots erforderlich sind, über das Netzwerk übertragen werden.

Prüfe unter ZimaOS zunächst, ob sowohl die Quelle als auch das externe Ziel tatsächlich Btrfs-Dateisysteme sind und ob SSH-Zugriff verfügbar ist. ZimaSpaces aktueller Leitfaden zu Datenträgerformaten führt BTRFS-Lese-/Schreibunterstützung auf, und der ZimaOS-SSH-Leitfaden zeigt, wie du den Terminalzugriff im Entwicklermodus aktivierst.

Verstehe die Sicherungskette, bevor du startest

Btrfs send/receive dient der Replikation von Subvolumes und ist kein allgemeiner Befehl zum Kopieren von Verzeichnissen. Die Quelle muss ein Btrfs-Subvolume sein, und jeder mit btrfs send verwendete Snapshot muss schreibgeschützt sein. Ein schreibgeschütztes Mount ist kein Ersatz für einen schreibgeschützten Subvolume-Snapshot.

Die offizielle Dokumentation zu btrfs send beschreibt zwei Modi. Ein vollständiger Sendestream enthält den gesamten Snapshot. Bei einem inkrementellen Sendestream wird -p oder -c mit Snapshots verwendet, die auf Sender und Empfänger im selben Zustand verfügbar sind.

Verwende für eine einfache externe Sicherungskette einen einzelnen expliziten übergeordneten Snapshot mit -p:

snapshot-A  --vollständiges Senden-->  externes snapshot-A
snapshot-B  --send -p A-->  externes snapshot-B
snapshot-C  --send -p B-->  externes snapshot-C

Lösche oder ändere das aktuelle übergeordnete Subvolume nicht, bevor die nächste inkrementelle Übertragung abgeschlossen und überprüft wurde.

Prüfe, ob die Quelle ein Btrfs-Subvolume ist

Ersetze die Beispielpfade durch die tatsächlichen Mountpoints auf deinem System. Das Snapshot-Verzeichnis sollte außerhalb des aktiven Quell-Subvolumes liegen, damit Backup-Snapshots nicht in den zu schützenden Daten verschachtelt werden.

findmnt -no FSTYPE --target /mnt/pool/data
sudo btrfs subvolume show /mnt/pool/data
sudo btrfs version

Der erste Befehl sollte btrfs ausgeben. Der zweite muss /mnt/pool/data erfolgreich als Subvolume erkennen. Wenn es nur ein normales Verzeichnis ist, brich hier ab: btrfs send kann keine beliebigen Verzeichnisse senden.

Führe auf dem externen System dieselbe Dateisystemprüfung für den Empfangspfad aus. btrfs receive muss das replizierte Subvolume auf einem Btrfs-Dateisystem erstellen.

SSH vor dem Streaming-Backup der Daten vorbereiten

Ein extern übertragener Send-Datenstrom enthält binäre Dateisystemdaten. SSH ist ein praktisches Transportmittel, da es Authentifizierung und Verschlüsselung während der Übertragung bietet. Wenn Sie an einem der beiden Endpunkte ZimaOS verwenden, aktivieren Sie zuerst SSH und testen Sie eine normale Anmeldung, bevor Sie einen Btrfs-Datenstrom übertragen.

ssh backup@backup.example.net

Verwenden Sie für unbeaufsichtigte Aufträge die SSH-Authentifizierung per Schlüssel. Das Remote-Konto muss außerdem btrfs receive nicht-interaktiv ausführen können. Lassen Sie nicht zu, dass eine Remote-sudo-Passwortabfrage dieselbe Standardeingabe liest, über die der Btrfs-Datenstrom übertragen wird. Eine eng begrenzte Berechtigungsregel für den erforderlichen Empfangsvorgang ist sicherer als ein umfassender passwortloser Root-Zugriff.

Erstellen Sie das Zielverzeichnis während einer interaktiven Administratorsitzung:

ssh -t backup@backup.example.net \
  'sudo mkdir -p /mnt/backup/btrfs-recv'

Ersten schreibgeschützten Snapshot erstellen

Erstellen Sie einen unveränderlichen, schreibgeschützten Snapshot des aktiven Quell-Subvolumes. Das Flag -r ist wichtig, da Btrfs für inkrementelle Send-Vorgänge Snapshots benötigt, die sich während des Sendevorgangs nicht ändern können.

sudo mkdir -p /mnt/pool/.snapshots

sudo btrfs subvolume snapshot -r \
  /mnt/pool/data \
  /mnt/pool/.snapshots/data-20260831-1000

Bestätigen Sie die Eigenschaft vor dem Senden:

sudo btrfs property get \
  /mnt/pool/.snapshots/data-20260831-1000 ro

Das erwartete Ergebnis ist ro=true.

Ersten vollständigen Snapshot extern sichern

Für die erste Übertragung gibt es keinen übergeordneten Snapshot, daher wird ein vollständiger Send durchgeführt. In einer Bash-kompatiblen Shell sorgt die Aktivierung von pipefail dafür, dass ein Fehler auf einer der beiden Seiten der Pipeline für die aufrufende Shell sichtbar wird.

set -o pipefail

sudo btrfs send \
  /mnt/pool/.snapshots/data-20260831-1000 \
  | ssh backup@backup.example.net \
  'sudo -n btrfs receive /mnt/backup/btrfs-recv'

Wenn sudo -n auf dem Remote-Host fehlschlägt, richten Sie die Remote-Berechtigungen ein, bevor Sie es erneut versuchen. Ersetzen Sie es nicht durch eine Passwortabfrage innerhalb der Streaming-Pipeline.

Die offizielle Dokumentation zu btrfs receive weist darauf hin, dass ein erfolgreich empfangenes Subvolume schreibgeschützt wird. Außerdem warnt sie davor, den Empfangspfad zu ändern, während ein Datenstrom angewendet wird.

Empfangenen Snapshot prüfen, bevor Sie ihn als übergeordneten Snapshot verwenden

Gehen Sie nicht davon aus, dass eine beendete SSH-Sitzung bedeutet, dass die Backup-Kette intakt ist. Prüfen Sie beide Snapshots:

sudo btrfs subvolume show \
  /mnt/pool/.snapshots/data-20260831-1000

ssh backup@backup.example.net \
  'sudo -n btrfs subvolume show \
  /mnt/backup/btrfs-recv/data-20260831-1000'

Notieren Sie auf dem Absender die Snapshot-UUID. Auf dem Empfänger sollte das replizierte Subvolume diese Quellkennung als Received UUID anzeigen. Bestätigen Sie außerdem, dass das empfangene Subvolume schreibgeschützt ist.

Erst nach dieser Prüfung sollte data-20260831-1000 als übergeordneter Snapshot für das nächste inkrementelle Backup dienen.

Den nächsten inkrementellen Snapshot erstellen und senden

Nachdem sich die Live-Daten geändert haben, erstellen Sie einen neuen schreibgeschützten Snapshot:

sudo btrfs subvolume snapshot -r \
  /mnt/pool/data \
  /mnt/pool/.snapshots/data-20260901-0200

Senden Sie anschließend nur die Änderungen seit dem vorherigen Snapshot:

set -o pipefail

sudo btrfs send \
  -p /mnt/pool/.snapshots/data-20260831-1000 \
  /mnt/pool/.snapshots/data-20260901-0200 \
  | ssh backup@backup.example.net \
  'sudo -n btrfs receive /mnt/backup/btrfs-recv'

Das funktioniert, weil der übergeordnete Snapshot aus dem ersten Sendevorgang weiterhin in identischer Form auf beiden Systemen vorhanden ist. Nachdem der neue Snapshot erfolgreich empfangen und überprüft wurde, kann data-20260901-0200 beim nächsten Durchlauf als übergeordneter Snapshot dienen.

Übergeordnete Snapshots unverändert lassen

Am häufigsten wird eine inkrementelle Kette dadurch unterbrochen, dass der Schreibschutzstatus oder der Inhalt eines als übergeordnetem Snapshot verwendeten Snapshots geändert wird. Btrfs erfasst empfangene Snapshots mit einer empfangenen UUID, damit Sender und Empfänger den jeweils zugehörigen Verlauf erkennen können.

Die offiziellen Btrfs-Hinweise zu Subvolume-Flags und empfangenen UUIDs warnen davor, dass das Ändern eines empfangenen Snapshots von schreibgeschützt zu beschreibbar die Voraussetzungen für inkrementelle Sendevorgänge verletzt.

Ändern Sie deshalb den extern empfangenen Snapshot nicht auf beschreibbar, nur um Dateien anzusehen, wiederherzustellen oder zu bearbeiten. Wenn Sie eine beschreibbare Wiederherstellungskopie benötigen, erstellen Sie einen separaten Snapshot des geschützten empfangenen Snapshots:

sudo btrfs subvolume snapshot \
  /mnt/backup/btrfs-recv/data-20260901-0200 \
  /mnt/restore/data-20260901-0200

Der neue Wiederherstellungs-Snapshot ist standardmäßig beschreibbar, während der ursprüngliche empfangene Snapshot für künftige inkrementelle Sendevorgänge unverändert bleibt.

Eine sichere Aufbewahrungsregel für Snapshots verwenden

Sie müssen nicht jeden alten Snapshot für immer aufbewahren, aber auf beiden Systemen muss der übergeordnete Snapshot erhalten bleiben, der für den nächsten Sendevorgang benötigt wird. Eine einfache Rotationsregel lautet:

  1. Erstellen Sie den neuen schreibgeschützten Quell-Snapshot.
  2. Senden Sie ihn mit dem letzten erfolgreichen Snapshot als -p.
  3. Überprüfen Sie den neuen extern empfangenen Snapshot.
  4. Machen Sie den neuen Snapshot zum nächsten übergeordneten Snapshot.
  5. Erst dann entfernen Sie ältere Wiederherstellungspunkte gemäß Ihrer Aufbewahrungsrichtlinie.

Mehrere historische Snapshots aufzubewahren, bietet nützliche Wiederherstellungspunkte. Denken Sie jedoch daran, dass ein Snapshot auf demselben Dateisystem kein unabhängiges Backup ist. Die externe Replik ist wertvoll, weil sie eine weitere Kopie auf einem separaten System an einem anderen Standort ablegt. Der Leitfaden zur 3-2-1-Backup-Regel von ZimaSpace erklärt, warum eine externe Kopie vor Ausfällen schützt, gegen die lokale Redundanz nichts ausrichten kann.

Verschachtelte Btrfs-Subvolumes separat behandeln

Btrfs-Snapshots erfassen verschachtelte Subvolumes nicht rekursiv. Wenn /mnt/pool/data ein weiteres Subvolume enthält, enthält der übergeordnete Snapshot lediglich einen Subvolume-Platzhalter statt eines vollständigen Snapshots der verschachtelten Daten.

Liste die Subvolumes auf, bevor du den Backup-Plan fertigstellst:

sudo btrfs subvolume list /mnt/pool

Wenn wichtige Anwendungsdaten in verschachtelten Subvolumes liegen, erstelle und repliziere für jedes davon eine eigene Kette schreibgeschützter Snapshots.

Wissen, wann -p und wann -c zu verwenden ist

Für einen linearen Backup-Verlauf ist -p die einfachste und am leichtesten überprüfbare Option. Mit der Option -c lassen sich eine oder mehrere Klonquellen hinzufügen, sodass Btrfs passende Extents aus zusätzlichen Snapshots wiederverwenden kann. Diese Klonquellen müssen jedoch auf beiden Seiten exakt im selben Zustand vorhanden sein.

Wenn du nicht sicher nachweisen kannst, dass eine Klonquelle unverändert und auf beiden Systemen vorhanden ist, verwende sie nicht. Für einen externen Backup-Auftrag ist eine einfache Kette mit einem übergeordneten Snapshot in der Regel sicherer.

Optional: Protokoll 2 für komprimierte Extents verwenden

Bei ausreichend aktuellen Linux- und btrfs-progs-Versionen kann das Btrfs-Sendeprotokoll 2 komprimierte Extents mit --compressed-data effizienter übertragen. Laut offizieller Send-Dokumentation erfordert Protokoll 2 btrfs-progs 6.0 oder neuer auf Sender und Empfänger sowie Linux 6.0 oder neuer auf dem Sender.

sudo btrfs send \
  --proto 2 \
  --compressed-data \
  -p /mnt/pool/.snapshots/data-20260831-1000 \
  /mnt/pool/.snapshots/data-20260901-0200 \
  | ssh backup@backup.example.net \
  'sudo -n btrfs receive /mnt/backup/btrfs-recv'

Aktiviere diese Option nicht nur, weil es sie gibt. Prüfe zuerst die Versionen auf beiden Endpunkten und verwende das Standardprotokoll, wenn Kompatibilität wichtiger ist als Optimierung.

Fehler beim inkrementellen Senden und Empfangen beheben

Der Send-Befehl meldet, dass der Snapshot nicht schreibgeschützt ist

Erstelle den Snapshot mit btrfs subvolume snapshot -r neu. Einen beschreibbaren Snapshot nur schreibgeschützt einzuhängen, erfüllt die Voraussetzung für den Send-Vorgang nicht.

Der inkrementelle Send-Vorgang kann den übergeordneten Snapshot nicht finden oder verwenden

Prüfe, ob der genaue übergeordnete Snapshot auf dem Sender noch vorhanden ist und der zugehörige empfangene Snapshot auf dem Empfänger ebenfalls noch existiert. Wenn ein übergeordneter Snapshot gelöscht, geändert oder beschreibbar gemacht wurde, stelle einen passenden wieder her, sofern du einen hast. Andernfalls erstelle einen neuen schreibgeschützten Snapshot und starte eine neue vollständige Basisübertragung.

btrfs receive meldet, dass das Ziel-Subvolume bereits existiert

btrfs receive überschreibt kein vorhandenes Subvolume mit demselben Namen wie das eingehende Subvolume. Das vorhandene Subvolume zuerst überprüfen. Wenn es sich um einen fehlgeschlagenen oder unvollständigen Empfang handelt und du bestätigt hast, dass es gefahrlos entfernt werden kann, das unvollständige Subvolume löschen, bevor du dieselbe Übertragung erneut versuchst.

Der übergeordnete Empfangs-Snapshot wurde nach dem Empfang geändert

Den geänderten Snapshot nicht als Grundlage für einen neuen inkrementellen Stream verwenden. Wenn es keinen unveränderten, passenden Empfangs-Snapshot als übergeordneten Snapshot gibt, eine neue vollständige Backup-Kette beginnen.

Dateien in einem verschachtelten Verzeichnis fehlen im Snapshot

Prüfen, ob das Verzeichnis selbst ein Btrfs-Subvolume ist. Verschachtelte Subvolumes sind nicht rekursiv im Snapshot des übergeordneten Subvolumes enthalten und benötigen eine eigene Send-/Receive-Kette.

Die WAN- oder SSH-Verbindung wird während einer Übertragung unterbrochen

Den Empfang als fehlgeschlagen behandeln, sofern er nicht erfolgreich abgeschlossen wurde und das resultierende Subvolume nicht korrekt verifiziert wurde. Die dokumentierte Btrfs-Schnittstelle für send/receive bietet keine Option zum Fortsetzen eines Streams. Bei unzuverlässigen Fernverbindungen solltest du den Send-Stream in eine Staging-Datei schreiben, diese Datei mit einem fortsetzbaren Übertragungsverfahren übertragen und dann die vollständige, vertrauenswürdige Datei an btrfs receive übergeben.

Die Empfangsseite vor nicht vertrauenswürdigen Streams schützen

Btrfs receive wendet Dateisystemoperationen aus dem eingehenden Stream an. Die offizielle Dokumentation zu receive rät davon ab, Send-Streams aus nicht vertrauenswürdigen Quellen anzunehmen, und empfiehlt, den Empfangspfad während der Verarbeitung eines Streams vor gleichzeitigen Schreibzugriffen zu schützen.

SSH-Hostverifizierung, schlüsselbasierte Authentifizierung, ein dediziertes Backup-Konto und die geringstmöglichen praktikablen Berechtigungen verwenden. Während eines Backups das Empfangsverzeichnis von normalen Benutzer-Schreibpfaden fernhalten.

Diese Checkliste bei jedem inkrementellen Lauf verwenden

  • Bestätigen, dass beide Endpunkte Btrfs verwenden.
  • Den neuen Quell-Snapshot mit -r erstellen.
  • Den zuvor erfolgreichen übergeordneten Snapshot auf beiden Systemen unverändert lassen.
  • Mit btrfs send -p OLD NEW senden.
  • Über eine authentifizierte und verschlüsselte SSH-Verbindung empfangen.
  • Den Erfolg überprüfen und die Quell-UUID mit der Received-UUID des Empfängers vergleichen.
  • Den empfangenen Backup-Snapshot schreibgeschützt lassen.
  • Einen separaten beschreibbaren Snapshot erstellen, wenn du Daten wiederherstellen oder testen möchtest.
  • Alte Snapshots erst rotieren, wenn der neue übergeordnete Snapshot verifiziert wurde.
  • Verschachtelte Subvolumes mit separaten Ketten sichern.

Sobald ein vollständiger Seed-Lauf und ein inkrementeller Lauf manuell erfolgreich waren, automatisiere dieselbe Abfolge mit Protokollierung und expliziten Exit-Status-Prüfungen. Entscheidend ist nicht der Scheduler, sondern bei jedem inkrementellen Schritt auf beiden Seiten einen unveränderten, verifizierten übergeordneten Snapshot zu erhalten.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.