Så konfigurerar du Btrfs Send och Receive för inkrementella säkerhetskopior på annan plats

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Med Btrfs send och receive kan du skapa en effektiv replikeringskedja utanför platsen av skrivskyddade ögonblicksbilder av subvolymer. Den första överföringen skickar en fullständig ögonblicksbild. Senare överföringar använder en tidigare replikerad ögonblicksbild som överordnad, så att bara ändringarna som behövs för att återskapa den nya ögonblicksbilden skickas över nätverket.

Bekräfta först att både källan och destinationen utanför platsen faktiskt är Btrfs-filsystem och att SSH-åtkomst är tillgänglig i ZimaOS. ZimaSpaces aktuella guide till diskformat listar stöd för läsning och skrivning av BTRFS, och ZimaOS SSH-guiden visar hur du aktiverar terminalåtkomst från utvecklarläget.

Förstå säkerhetskopieringskedjan innan du börjar

Btrfs send/receive är replikering av subvolymer, inte ett generiskt kommando för att kopiera kataloger. Källan måste vara en Btrfs-subvolym, och varje ögonblicksbild som används av btrfs send måste vara skrivskyddad. En skrivskyddad montering ersätter inte en skrivskyddad ögonblicksbild av en subvolym.

Den officiella dokumentationen för btrfs send beskriver två lägen. En fullständig sändning innehåller hela ögonblicksbilden. En inkrementell sändning använder -p eller -c med ögonblicksbilder som är tillgängliga i samma tillstånd på både avsändaren och mottagaren.

För en enkel kedja utanför platsen använder du en uttrycklig överordnad ögonblicksbild med -p:

snapshot-A  --full send-->  ögonblicksbild-A utanför platsen
snapshot-B  --send -p A-->  ögonblicksbild-B utanför platsen
snapshot-C  --send -p B-->  ögonblicksbild-C utanför platsen

Ta inte bort eller ändra den aktuella överordnade ögonblicksbilden förrän nästa inkrementella överföring har slutförts och verifierats.

Verifiera att källan är en Btrfs-subvolym

Ersätt exempelsökvägarna med de faktiska monteringspunkterna på ditt system. Ögonblicksbildskatalogen ska ligga utanför den aktiva källsubvolymen, så att säkerhetskopiornas ögonblicksbilder inte hamnar inuti de data som skyddas.

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

Det första kommandot ska rapportera btrfs. Det andra ska identifiera /mnt/pool/data som en subvolym. Om det bara är en vanlig katalog ska du stanna här: btrfs send kan inte skicka en godtycklig katalog.

Kör samma filsystemscheck på systemet utanför platsen för mottagningsplatsen. btrfs receive måste skapa sin replikerade subvolym på ett Btrfs-filsystem.

Förbered SSH innan du strömmar säkerhetskopieringsdata

En sändningsström till en extern plats består av binära filsystemdata. SSH är ett praktiskt transportprotokoll eftersom det ger autentisering och kryptering under överföringen. Om du använder ZimaOS på någon av ändpunkterna ska du aktivera SSH först och testa en vanlig inloggning innan du försöker överföra en Btrfs-dataström.

ssh backup@backup.example.net

För obevakade jobb använder du SSH-autentisering med nyckel. Fjärrkontot måste också kunna köra btrfs receive utan interaktion. Låt inte en lösenordsfråga från fjärrsidans sudo läsa från samma standardindata som transporterar Btrfs-dataströmmen. En snävt avgränsad behörighetsregel för den nödvändiga mottagningsåtgärden är säkrare än bred lösenordsfri root-åtkomst.

Skapa målkatalogen under en interaktiv administratörssession:

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

Skapa den första skrivskyddade ögonblicksbilden

Skapa en fast skrivskyddad ögonblicksbild av den aktiva källans underordnade volym. Flaggan -r är viktig eftersom Btrfs inkrementell sändning är beroende av ögonblicksbilder som inte kan ändras under pågående sändning.

sudo mkdir -p /mnt/pool/.snapshots

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

Bekräfta egenskapen innan du skickar:

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

Det förväntade resultatet är ro=true.

Skicka den första fullständiga ögonblicksbilden till en extern plats

Den första överföringen saknar en överordnad, så det är en fullständig sändning. I ett Bash-kompatibelt skal gör aktivering av pipefail att ett fel på endera sidan av pipelinen blir synligt för det anropande skalet.

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'

Om sudo -n misslyckas på fjärrvärden ska du åtgärda konfigurationen för fjärrbehörigheter innan du försöker igen. Ersätt det inte med en lösenordsfråga i dataströmspipelinen.

Den officiella dokumentationen för btrfs receive anger att en underordnad volym som har tagits emot utan fel blir skrivskyddad. Den varnar också för att användare inte bör ändra mottagningssökvägen medan en dataström tillämpas.

Verifiera den mottagna ögonblicksbilden innan du använder den som överordnad

Utgå inte från att en avslutad SSH-session innebär att säkerhetskopieringskedjan är intakt. Granska båda ögonblicksbilderna:

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'

Anteckna ögonblicksbildens UUID på avsändaren. På mottagaren ska den replikerade underordnade volymen visa källans identifierare som dess Received UUID. Bekräfta också att den mottagna underordnade volymen är skrivskyddad.

Först efter den här kontrollen ska data-20260831-1000 bli förälder för nästa inkrementella säkerhetskopia.

Skapa och skicka nästa inkrementella ögonblicksbild

När livedata har ändrats skapar du en ny skrivskyddad ögonblicksbild:

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

Skicka sedan endast ändringarna sedan föregående ögonblicksbild:

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'

Detta fungerar eftersom föräldraögonblicksbilden från den första sändningen fortfarande finns i samma skick på båda systemen. När den nya ögonblicksbilden har tagits emot och verifierats kan data-20260901-0200 bli förälder för nästa körning.

Behåll identiska föräldraögonblicksbilder

Det vanligaste sättet att bryta en inkrementell kedja är att ändra skrivskyddsstatusen eller innehållet i en ögonblicksbild som används som förälder. Btrfs spårar mottagna ögonblicksbilder med ett mottaget UUID, så att avsändaren och mottagaren kan identifiera motsvarande historik.

Den officiella Btrfs-vägledningen om undervolymflaggor och mottagna UUID:er varnar för att om en mottagen ögonblicksbild ändras från skrivskyddad till skrivbar bryts antagandena som används vid inkrementell sändning.

Av den anledningen ska du inte göra den mottagna externa ögonblicksbilden skrivbar bara för att bläddra, återställa eller redigera filer. Om du behöver en skrivbar återställningskopia skapar du en separat ögonblicksbild från den skyddade mottagna ögonblicksbilden:

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

Den nya återställningsögonblicksbilden är skrivbar som standard, medan den ursprungliga mottagna ögonblicksbilden förblir orörd för framtida inkrementella sändningar.

Använd en säker regel för lagring av ögonblicksbilder

Du behöver inte behålla alla gamla ögonblicksbilder för alltid, men du måste behålla den förälder som krävs för nästa sändning på båda systemen. En enkel rotationsregel är:

  1. Skapa den nya skrivskyddade ögonblicksbilden på källan.
  2. Skicka den med den senast lyckade ögonblicksbilden som -p.
  3. Verifiera den nya externa mottagna ögonblicksbilden.
  4. Gör den nya ögonblicksbilden till nästa förälder.
  5. Ta först därefter bort äldre återställningspunkter enligt din lagringspolicy.

Att behålla flera historiska ögonblicksbilder kan ge användbara återställningspunkter, men kom ihåg att en ögonblicksbild på samma filsystem inte är en oberoende säkerhetskopia. Den externa repliken är värdefull eftersom den placerar en kopia till på ett separat system och en annan plats. ZimaSpaces guide till 3-2-1-säkerhetskopiering förklarar varför en extern kopia skyddar mot fel som lokal redundans inte kan hantera.

Hantera nästlade Btrfs-subvolymer separat

Btrfs-ögonblicksbilder omfattar inte rekursivt nästlade subvolymer. Om /mnt/pool/data innehåller en annan subvolym innehåller den överordnade ögonblicksbilden en platshållare för subvolymen i stället för en fullständig ögonblicksbild av de nästlade data.

Lista subvolymer innan du slutför säkerhetskopieringsplanen:

sudo btrfs subvolume list /mnt/pool

Om viktiga programdata finns i nästlade subvolymer skapar och replikerar du en separat kedja av skrivskyddade ögonblicksbilder för var och en.

Veta när du ska använda -p och när du ska använda -c

För en linjär säkerhetskopieringshistorik är -p det enklaste alternativet och lättast att granska. Alternativet -c kan lägga till en eller flera klonkällor som låter Btrfs återanvända matchande extentar från ytterligare ögonblicksbilder, men dessa klonkällor måste också finnas i exakt samma skick i båda ändar.

Om du inte kan verifiera att en klonkälla är oförändrad och finns på båda systemen ska du inte använda den. En enkel kedja med en överordnad ögonblicksbild är oftast säkrare för en säkerhetskopiering till en annan plats.

Valfritt: Använd protokoll 2 för komprimerade extentar

Med tillräckligt nya versioner av Linux och btrfs-progs kan Btrfs-överföringsprotokoll 2 överföra komprimerade extentar mer effektivt med --compressed-data. Den officiella dokumentationen för överföring anger att protokoll 2 kräver btrfs-progs 6.0 eller senare på både avsändaren och mottagaren samt Linux 6.0 eller senare på avsändaren.

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'

Aktivera inte detta enbart för att alternativet finns. Kontrollera först versionerna på båda ändpunkterna och använd standardprotokollet när kompatibilitet är viktigare än optimering.

Felsök vanliga fel vid inkrementell överföring och mottagning

Överföringskommandot säger att ögonblicksbilden inte är skrivskyddad

Återskapa ögonblicksbilden med btrfs subvolume snapshot -r. Att bara montera en skrivbar ögonblicksbild via en skrivskyddad montering uppfyller inte överföringskravet.

Den inkrementella överföringen hittar eller kan inte använda sin överordnade ögonblicksbild

Kontrollera att den exakta överordnade ögonblicksbilden fortfarande finns på avsändaren och att motsvarande mottagna ögonblicksbild fortfarande finns på mottagaren. Om någon av de överordnade ögonblicksbilderna har tagits bort, ändrats eller gjorts skrivbar återställer du en matchande överordnad ögonblicksbild, om du har en. Annars skapar du en ny skrivskyddad ögonblicksbild och börjar om med en fullständig grundöverföring.

btrfs receive säger att målsubvolymen redan finns

btrfs receive skriver inte över en befintlig underordnad volym med samma inkommande namn. Granska den befintliga underordnade volymen först. Om mottagningen misslyckades eller är ofullständig och du har bekräftat att den kan tas bort på ett säkert sätt ska du radera den ofullständiga underordnade volymen innan du försöker överföra samma data igen.

Mottagningsföräldern ändrades efter att den togs emot

Använd inte den ändrade ögonblicksbilden som grund för en ny inkrementell ström. Om det inte finns någon oförändrad, matchande mottagningsförälder ska du starta en ny fullständig säkerhetskopieringskedja.

Filer i en nästlad katalog saknas i ögonblicksbilden

Kontrollera om den katalogen själv är en Btrfs-underordnad volym. Nästlade underordnade volymer inkluderas inte rekursivt i den överordnade ögonblicksbilden och behöver en egen send/receive-kedja.

WAN- eller SSH-anslutningen bryts under en överföring

Behandla mottagningen som misslyckad om den inte slutfördes korrekt eller om den resulterande underordnade volymen inte verifieras korrekt. Det dokumenterade kommandogränssnittet för Btrfs send/receive har inget alternativ för att återuppta en ström. För opålitliga långdistansanslutningar kan du överväga att skriva sändningsströmmen till en mellanlagringsfil, överföra den filen med en överföringsmetod som kan återupptas och sedan mata den färdiga, betrodda filen till btrfs receive.

Skydda mottagningssidan mot opålitliga strömmar

Btrfs receive tillämpar filsystemsoperationer från den inkommande strömmen. Den officiella dokumentationen för receive avråder från att ta emot sändningsströmmar från opålitliga källor och rekommenderar att mottagningssökvägen skyddas mot samtidiga skrivningar medan en ström tillämpas.

Använd verifiering av SSH-värdar, nyckelbaserad autentisering, ett särskilt säkerhetskopieringskonto och så snäva behörigheter som är praktiskt möjliga. Se till att mottagningskatalogen inte ingår i vanliga användares skrivsökvägar medan en säkerhetskopiering pågår.

Använd den här checklistan vid varje inkrementell körning

  • Bekräfta att båda ändpunkterna använder Btrfs.
  • Skapa den nya ögonblicksbilden från källan med -r.
  • Behåll den föregående lyckade överordnade ögonblicksbilden oförändrad på båda systemen.
  • Skicka med btrfs send -p OLD NEW.
  • Överför via en autentiserad och krypterad SSH-anslutning.
  • Verifiera att körningen lyckades och jämför källans UUID med mottagarens Received UUID.
  • Behåll den mottagna säkerhetskopians ögonblicksbild skrivskyddad.
  • Skapa en separat skrivbar ögonblicksbild när du behöver återställa eller testa data.
  • Rotera gamla ögonblicksbilder först när den nya överordnade ögonblicksbilden har verifierats.
  • Säkerhetskopiera nästlade underordnade volymer med separata kedjor.

När en fullständig grundkörning och en inkrementell körning båda har lyckats manuellt kan du automatisera samma sekvens med loggning och uttryckliga kontroller av slutstatusen. Det viktiga är inte schemaläggaren, utan att bevara en oförändrad, verifierad överordnad ögonblicksbild på båda sidor av varje inkrementellt steg.

Support och tips

Mer att läsa

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.