Come configurare Btrfs Send e Receive per backup incrementali off-site

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Btrfs send e receive possono trasformare snapshot di sottovolumi di sola lettura in un'efficiente catena di replica remota. Il primo trasferimento invia uno snapshot completo. I trasferimenti successivi usano come genitore uno snapshot già replicato, così in rete passano solo le modifiche necessarie a ricostruire il nuovo snapshot.

Su ZimaOS, verifica innanzitutto che sia la sorgente sia la destinazione remota siano effettivamente filesystem Btrfs e che l'accesso SSH sia disponibile. L'attuale guida ai formati dei dischi di ZimaSpace indica il supporto in lettura/scrittura per BTRFS e la guida SSH di ZimaOS spiega come abilitare l'accesso al terminale dalla Modalità sviluppatore.

Comprendi la catena di backup prima di iniziare

Btrfs send/receive replica sottovolumi, non è un comando generico per copiare directory. La sorgente deve essere un sottovolume Btrfs e ogni snapshot usato da btrfs send deve essere di sola lettura. Montare in sola lettura non equivale a creare uno snapshot del sottovolume di sola lettura.

La documentazione ufficiale di btrfs send descrive due modalità. Un invio completo contiene l'intero snapshot. Un invio incrementale usa -p o -c con snapshot disponibili nello stesso stato sia sul mittente sia sul destinatario.

Per una semplice catena remota, usa un genitore esplicito con -p:

snapshot-A  --invio completo-->  snapshot-A remoto
snapshot-B  --send -p A-->  snapshot-B remoto
snapshot-C  --send -p B-->  snapshot-C remoto

Non eliminare né modificare il genitore attuale finché il successivo trasferimento incrementale non è stato completato e verificato.

Verifica che la sorgente sia un sottovolume Btrfs

Sostituisci i percorsi di esempio con i punti di montaggio effettivi del tuo sistema. La directory degli snapshot dovrebbe trovarsi fuori dal sottovolume sorgente attivo, così gli snapshot di backup non finiscono annidati nei dati da proteggere.

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

Il primo comando dovrebbe indicare btrfs. Il secondo deve identificare correttamente /mnt/pool/data come sottovolume. Se si tratta solo di una normale directory, fermati qui: btrfs send non può inviare una directory qualsiasi.

Esegui lo stesso controllo del filesystem sul sistema remoto, nella posizione di destinazione. btrfs receive deve creare il sottovolume replicato su un filesystem Btrfs.

Prepara SSH prima di trasmettere i dati di backup

Uno stream di invio fuori sede contiene dati binari del filesystem. SSH è un metodo di trasporto pratico perché fornisce autenticazione e crittografia durante il trasferimento. Se usi ZimaOS su uno dei due endpoint, abilita prima SSH e verifica un normale accesso prima di tentare uno stream Btrfs.

ssh backup@backup.example.net

Per i processi non presidiati, usa l'autenticazione SSH basata su chiavi. L'account remoto deve anche poter eseguire btrfs receive senza interazione. Non consentire a una richiesta di password di sudo remoto di leggere dallo stesso input standard che trasporta lo stream Btrfs. Una regola di privilegi con ambito limitato all'operazione di ricezione richiesta è più sicura dell'accesso root senza password con privilegi ampi.

Crea la directory di destinazione durante una sessione amministrativa interattiva:

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

Crea il primo snapshot di sola lettura

Crea uno snapshot fisso di sola lettura del sottovolume sorgente attivo. Il flag -r è importante perché l'invio incrementale di Btrfs dipende da snapshot che non possono cambiare durante l'operazione di invio.

sudo mkdir -p /mnt/pool/.snapshots

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

Verifica la proprietà prima dell'invio:

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

Il risultato previsto è ro=true.

Invia lo snapshot iniziale completo fuori sede

Il primo trasferimento non ha un'origine, quindi è un invio completo. In una shell compatibile con Bash, abilitare pipefail fa sì che un errore su entrambi i lati della pipeline sia rilevato dalla shell chiamante.

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'

Se sudo -n non funziona sull'host remoto, sistema la configurazione dei privilegi remoti prima di riprovare. Non sostituirlo con una richiesta di password all'interno della pipeline di streaming.

La documentazione ufficiale di btrfs receive specifica che un sottovolume ricevuto correttamente diventa di sola lettura. Avverte inoltre di non modificare il percorso di ricezione mentre viene applicato uno stream.

Verifica lo snapshot ricevuto prima di usarlo come origine

Non dare per scontato che la chiusura di una sessione SSH significhi che la catena di backup sia integra. Controlla entrambi gli snapshot:

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'

Sul mittente, annota l'UUID dello snapshot UUID. Sul ricevente, il sottovolume replicato dovrebbe mostrare quell'identificativo sorgente come Received UUID. Verifica anche che il sottovolume ricevuto sia di sola lettura.

Solo dopo questa verifica data-20260831-1000 dovrà diventare il padre per il prossimo backup incrementale.

Crea e invia il prossimo snapshot incrementale

Dopo che i dati in uso sono cambiati, crea un nuovo snapshot di sola lettura:

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

Quindi invia solo le differenze rispetto allo snapshot precedente:

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'

Questo funziona perché lo snapshot padre del primo invio esiste ancora in forma identica su entrambi i sistemi. Dopo aver ricevuto e verificato correttamente il nuovo snapshot, data-20260901-0200 può diventare il padre per la successiva esecuzione.

Mantieni identici gli snapshot padre

Il modo più comune per interrompere una catena incrementale è cambiare lo stato di sola lettura o il contenuto di uno snapshot usato come padre. Btrfs tiene traccia degli snapshot ricevuti con un UUID ricevuto proprio per consentire al mittente e al destinatario di identificare la cronologia corrispondente.

Le indicazioni ufficiali di Btrfs sui flag dei sottovolumi e gli UUID ricevuti avvertono che cambiare uno snapshot ricevuto da sola lettura a lettura e scrittura compromette le condizioni necessarie per l'invio incrementale.

Per questo motivo, non rendere scrivibile lo snapshot ricevuto off-site solo per sfogliare, ripristinare o modificare i file. Se ti serve una copia di ripristino scrivibile, crea uno snapshot separato a partire dallo snapshot ricevuto protetto:

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

Il nuovo snapshot di ripristino è scrivibile per impostazione predefinita, mentre lo snapshot ricevuto originale rimane intatto per i futuri invii incrementali.

Usa una regola sicura di conservazione degli snapshot

Non è necessario conservare per sempre tutti gli snapshot precedenti, ma devi mantenere su entrambi i sistemi il padre richiesto per l'invio successivo. Una semplice regola di rotazione è:

  1. Crea il nuovo snapshot sorgente di sola lettura.
  2. Invialo usando come -p lo snapshot inviato con successo in precedenza.
  3. Verifica il nuovo snapshot ricevuto off-site.
  4. Promuovi il nuovo snapshot a snapshot padre successivo.
  5. Solo allora rimuovi i punti di ripristino più vecchi in base alla tua politica di conservazione.

Mantenere diversi snapshot storici può fornire punti di ripristino utili, ma ricorda che uno snapshot sullo stesso file system non è un backup indipendente. La replica off-site è preziosa perché crea un'altra copia su un sistema e in una posizione separati. La guida al backup 3-2-1 di ZimaSpace spiega perché una copia off-site protegge dai guasti che la ridondanza locale non può coprire.

Gestisci separatamente i sottovolumi Btrfs annidati

Gli snapshot Btrfs non sono ricorsivi nei sottovolumi annidati. Se /mnt/pool/data contiene un altro sottovolume, lo snapshot padre conterrà uno stub del sottovolume invece di uno snapshot completo dei dati annidati.

Elenca i sottovolumi prima di definire il piano di backup:

sudo btrfs subvolume list /mnt/pool

Se i dati importanti delle applicazioni si trovano in sottovolumi annidati, crea e replica una catena di snapshot di sola lettura separata per ciascuno.

Scopri quando usare -p e quando usare -c

Per una cronologia di backup lineare, -p è l'opzione più semplice e facile da verificare. L'opzione -c può aggiungere una o più sorgenti di clonazione, consentendo a Btrfs di riutilizzare gli extent corrispondenti da altri snapshot, ma anche queste sorgenti devono esistere esattamente nello stesso stato su entrambe le estremità.

Se non puoi dimostrare che una sorgente di clonazione non è cambiata ed è presente su entrambi i sistemi, non usarla. Per un processo di backup fuori sede, una semplice catena con un solo snapshot padre è in genere più sicura.

Facoltativo: usa il protocollo 2 per gli extent compressi

Nelle versioni sufficientemente recenti di Linux e btrfs-progs, il protocollo Btrfs send 2 può trasmettere gli extent compressi in modo più efficiente con --compressed-data. La documentazione ufficiale di send specifica che il protocollo 2 richiede btrfs-progs 6.0 o versioni successive sia sul mittente sia sul destinatario, e Linux 6.0 o versioni successive sul mittente.

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'

Non abilitarlo solo perché l'opzione è disponibile. Verifica prima le versioni su entrambi gli endpoint e usa il protocollo predefinito quando la compatibilità è più importante dell'ottimizzazione.

Risoluzione dei problemi più comuni relativi agli errori di invio e ricezione incrementali

Il comando di invio segnala che lo snapshot non è di sola lettura

Ricrea lo snapshot con btrfs subvolume snapshot -r. Montare uno snapshot scrivibile in sola lettura non soddisfa il requisito per l'invio.

L'invio incrementale non riesce a trovare o usare il proprio snapshot padre

Verifica che lo snapshot padre esatto esista ancora sul mittente e che il relativo snapshot ricevuto esista ancora sul destinatario. Se uno dei due snapshot padre è stato eliminato, modificato o reso scrivibile, ripristina uno snapshot padre corrispondente, se disponibile. Altrimenti crea un nuovo snapshot di sola lettura e avvia un nuovo seed completo.

btrfs receive segnala che il sottovolume di destinazione esiste già

btrfs receive non sovrascrive un sottovolume esistente con lo stesso nome in arrivo. Esamina prima il sottovolume esistente. Se si tratta di una ricezione non riuscita o incompleta e hai confermato che è sicuro rimuoverla, elimina il sottovolume incompleto prima di ritentare lo stesso trasferimento.

Lo snapshot padre di ricezione è stato modificato dopo il suo arrivo

Non usare lo snapshot modificato come base di un nuovo flusso incrementale. Se non esiste uno snapshot padre di ricezione corrispondente e invariato, avvia una nuova catena di backup completa.

I file all'interno di una directory annidata non sono presenti nello snapshot

Verifica se quella directory è a sua volta un sottovolume Btrfs. Gli snapshot del sottovolume padre non includono ricorsivamente i sottovolumi annidati, che richiedono una propria catena send/receive.

La connessione WAN o SSH si interrompe durante un trasferimento

Considera il receive non riuscito a meno che non sia stato completato correttamente e il sottovolume risultante non sia stato verificato. L'interfaccia dei comandi documentata per Btrfs send/receive non offre un'opzione per riprendere un trasferimento interrotto. Per le connessioni a lunga distanza inaffidabili, valuta di scrivere il flusso send in un file temporaneo, trasferire il file con un protocollo che consenta la ripresa e poi passare il file completato e attendibile a btrfs receive.

Proteggi il lato di ricezione dai flussi non attendibili

Btrfs receive applica operazioni sul filesystem provenienti dal flusso in ingresso. La documentazione ufficiale di receive sconsiglia di accettare flussi send da fonti non attendibili e raccomanda di proteggere il percorso di ricezione da scritture simultanee durante l'applicazione del flusso.

Usa la verifica dell'host SSH, l'autenticazione con chiave, un account di backup dedicato e i privilegi più limitati possibile. Durante l'esecuzione di un backup, mantieni la directory di ricezione fuori dai percorsi di scrittura degli utenti normali.

Usa questa checklist per ogni esecuzione incrementale

  • Conferma che entrambi gli endpoint usino Btrfs.
  • Crea il nuovo snapshot della sorgente con -r.
  • Mantieni invariato il precedente snapshot padre riuscito su entrambi i sistemi.
  • Invia con btrfs send -p OLD NEW.
  • Ricevi tramite una connessione SSH autenticata e crittografata.
  • Verifica l'esito positivo e confronta l'UUID della sorgente con l'UUID Received del ricevitore.
  • Mantieni lo snapshot di backup ricevuto in sola lettura.
  • Crea uno snapshot scrivibile separato quando devi ripristinare o testare i dati.
  • Ruota gli snapshot meno recenti solo dopo aver verificato il nuovo snapshot padre.
  • Esegui il backup dei sottovolumi annidati con catene separate.

Dopo aver eseguito manualmente con successo un backup completo e uno incrementale, automatizza la stessa sequenza con registrazione dei log e controlli espliciti del codice di uscita. L'aspetto importante non è la pianificazione: è mantenere uno snapshot padre invariato e verificato su entrambi i lati di ogni passaggio incrementale.

Assistenza e consigli

Altre letture

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.