Nodi¶
Un nodo è un BombVault senza interfaccia web, per esempio su un VPS o su un piccolo server a casa di un amico. Fa il backup dei container e delle cartelle del proprio server, e il BombVault su cui lo aggiungi, che in questa pagina chiamiamo istanza madre, gli dice quando fare il backup e dove mandarlo. Lo gestisci dall'interfaccia web dell'istanza madre, accanto ai tuoi elementi.

Come funziona¶
- L'istanza madre custodisce la chiave del nodo. Quando aggiungi un nodo, l'istanza madre crea la sua
APP_KEY, ne tiene una copia sigillata e te la consegna una sola volta, nel file compose del nodo. Con quella copia l'istanza madre raggiunge il nodo e apre i suoi backup. - Il nodo non ha bisogno di porte aperte. L'istanza madre e il nodo parlano attraverso il relay su un collegamento privato tutto loro, separato dal tuo gruppo di associazione. L'istanza madre avvia ogni chiamata e la firma, e il nodo non le chiede nulla se non il suo saluto. L'unica destinazione che richiede una porta aperta è tenere i backup sul nodo.
- I backup non passano mai dal relay. Il nodo li manda direttamente nel posto che hai scelto: il server ricevente dell'istanza madre, una delle sue destinazioni o un rest-server sul nodo stesso.
- Il nodo non pianifica nulla da solo. Non ha pianificazioni, non manda notifiche e non entra in nessun gruppo né in nessuna fortezza. L'istanza madre avvia i suoi backup, controlla come vanno e manda gli avvisi.
- Un nodo fa il backup di container e set di cartelle. VM, chiavetta flash, dataset ZFS e auto-backup restano alle installazioni complete.
Il collegamento usa il relay dell'istanza madre quando il suo gruppo ne ha uno, altrimenti il relay del progetto, anche quando l'istanza madre si associa senza relay.
Prima di iniziare¶
- Una password di accesso sull'istanza madre. Aggiungere un nodo, mostrare di nuovo il suo file compose e aprire i suoi elementi richiedono un accesso con la password, vedi Accesso.
- Docker con Compose sul server del nodo.
- Un posto per i backup, uno dei tre descritti in Dove vanno i backup. Il server ricevente è la scelta più sicura, perché lì il nodo non può eliminare nulla.
Aggiungere un nodo¶
- Sull'istanza madre, apri Istanze e scegli Aggiungi nodo in basso a destra.
-
Nome. Scrivi come il nodo deve comparire qui, per esempio il nome del server, e scegli Avanti.

-
Backup. Scegli dove vanno i backup e compila ciò che quel posto richiede. Fa il backup ogni giorno alle è l'ora in cui partono entrambe le sezioni. L'istanza madre propone mezz'ora dopo i propri backup dei container, così i due non usano gli stessi dischi nello stesso momento. Più avanti puoi dare a ogni sezione una propria pianificazione dalla scheda. Scegli Avanti.

-
Avvio. La finestra mostra il file compose del nodo con
MODE,APP_KEY,NODE_HOMEeNODE_NAMEgià compilati. Copialo e conserva laAPP_KEYin un posto sicuro. Sul server del nodo:mkdir -p /opt/bombvault-node && cd /opt/bombvault-node nano docker-compose.yml # paste the file from the window docker compose up -dPrima di avviarlo, punta il volume Host Data sui dati di cui vuoi il backup e imposta
HOST_SOURCE_ROOTsullo stesso percorso, come mostra l'esempio qui sotto. -
La finestra aspetta il nodo. Appena il nodo risponde, l'istanza madre gli dice dove vanno i suoi backup e controlla che li raggiunga, e la finestra dice vps-helsinki è online e prende ordini da questa istanza.

Puoi chiudere la finestra prima che il nodo risponda. La sua scheda dice allora In attesa del nodo, e l'istanza madre gli comunica dove vanno i suoi backup appena si fa vivo.
Esempio: un VPS che fa il backup sul server ricevente¶
L'istanza madre è una macchina Unraid chiamata tower che gestisce il server ricevente. Un reverse proxy lo pubblica come https://backup.tower.example.org. Il VPS vps-helsinki fa girare Nextcloud e Caddy, con i loro dati in /srv/appdata.
- Su
tower: Istanze, Aggiungi nodo, nomevps-helsinki, Avanti. - Scegli Il server ricevente di questa istanza e scrivi
https://backup.tower.example.orgin Indirizzo per i nodi. I container dell'istanza madre fanno il backup alle 02:30, quindi la finestra propone le 03:00. Lascia così e scegli Avanti. -
Sul VPS, salva il file della finestra con i volumi e
HOST_SOURCE_ROOTcambiati per/srv/appdata:services: bombvault-node: image: junkerderprovinz/bombvault:latest restart: unless-stopped hostname: bombvault-node container_name: bombvault-node volumes: - ./config:/config - /var/run/docker.sock:/var/run/docker.sock - /srv/appdata:/host/user environment: MODE: node APP_KEY: "<filled in by home>" NODE_HOME: "<filled in by home>" NODE_NAME: "vps-helsinki" PLATFORM: generic HOST_SOURCE_ROOT: /srv/appdata -
docker compose up -d. Pochi secondi dopo, la finestra sutowerdice che il nodo è online e I backup vanno a https://backup.tower.example.org. - Alle 03:00 l'istanza madre avvia i backup del nodo. La mattina dopo, la scheda Nodi nella panoramica mostra l'ultimo backup di
vps-helsinki, e Backup elenca i suoi container in una sezione a parte.
Come BombVault trova i dati di un container su un semplice host Docker è descritto in Rilevamento delle sorgenti di backup.
Dove vanno i backup¶
Ogni nodo ha una sola destinazione per entrambe le sezioni. Cambia destinazione sulla sua scheda la cambia appena il nodo è online. Il nuovo posto riceve nuovi repository, e i backup nel posto precedente restano dove sono.
Il server ricevente di questa istanza¶
Il nodo scrive sul server ricevente dell'istanza madre in modalità append-only: può aggiungere backup ma non eliminarne nessuno. Lì riceve un accesso proprio, col nome del nodo, e un repository per sezione nella propria cartella. L'istanza madre aggiunge la propria chiave a ogni repository e li pota da sé, visto che il nodo non può farlo.
Il nodo raggiunge il server all'Indirizzo per i nodi, che imposti nel secondo passo o nella finestra Server ricevente. Di solito un nodo invia da internet, quindi l'indirizzo deve essere uno di questi:
https://, per esempio dietro un reverse proxy, Pangolin o un tunnel. Se il server mostra un certificato proprio invece di uno di un'autorità pubblica, incollalo in formato PEM in Certificato.http://con un indirizzo IP privato, come10.0.0.5su un collegamento WireGuard o100.101.102.103su Tailscale.
Un semplice http:// verso un indirizzo pubblico viene rifiutato, perché il nodo manderebbe i suoi backup attraverso internet senza cifratura. Quando cambi l'indirizzo, l'istanza madre lo comunica a ogni nodo del ricevitore, e un nodo assente lo viene a sapere appena torna.
Una destinazione¶
Il nodo scrive su una delle destinazioni dell'istanza madre che riesce a raggiungere da solo: un servizio S3 o un server REST, su https:// o a un indirizzo privato. I suoi repository stanno lì in bombvault-node-<node id>-containers e bombvault-node-<node id>-files.
Il nodo accede con delle credenziali salvate create apposta per lui, che devono essere diverse da quelle con cui l'istanza madre scrive sulla destinazione. Se la finestra dice che non ce ne sono, aggiungine prima di tutto. Con queste credenziali il nodo di solito può eliminare ciò che si trova sulla destinazione, a differenza del server ricevente, e la finestra lo segnala.
Tenerli sul nodo¶
Il nodo tiene i backup da sé, dietro un proprio rest-server in modalità append-only, e l'istanza madre preleva una copia di ogni sezione nel proprio spazio. Va bene per un nodo a cui l'istanza madre non può offrire spazio. È l'unica destinazione che richiede una porta aperta.

- In Indirizzo del nodo, scrivi dove l'istanza madre raggiunge il nodo: il suo indirizzo pubblico e una porta libera, come
https://203.0.113.7:8443, senza cartella dopo. Usahttp://solo con un indirizzo privato, come sopra. - Il nodo avvia il container
bombvault-node-rest-serversu quella porta, con i suoi repository nella cartellabombvault-nodedentro Host Data. Conhttps://crea un certificato per quell'indirizzo, e l'istanza madre lo fissa. - Apri la porta nel firewall del nodo, così l'istanza madre può raggiungerla. Una porta già occupata da un altro container sul nodo viene rifiutata con il nome di quel container.
L'istanza madre preleva una sezione subito dopo la fine dei backup del nodo per quella sezione, e come riserva ogni ora e un quarto, anche con Prelievo disattivato. Ciò che l'istanza madre ha prelevato resta presso di lei come ogni copia prelevata, anche dopo che il nodo non c'è più. Il nodo pota i propri repository quando l'istanza madre glielo chiede, perché il suo rest-server non accetta eliminazioni, e i suoi set di cartelle lasciano fuori la cartella bombvault-node, così non fa mai il backup dei propri backup.
Quando fanno il backup i nodi¶
L'istanza madre gestisce la pianificazione di ogni nodo. La scheda mostra un piano per sezione, come Container Ogni giorno alle 2:00 e Cartelle Settimanale (dom) alle 4:00. Un clic apre lo stesso editor di Pianificazioni, e una modifica viene salvata subito.

- Un nodo che era assente avvia i backup persi appena torna. L'istanza madre controlla ogni cinque minuti.
- A un nodo occupato viene chiesto di nuovo cinque minuti dopo.
- Mentre l'istanza madre pota i vecchi backup di un nodo, il nodo non avvia nulla finché lei non ha finito. Sul server ricevente e sul nodo stesso questa finestra si apre ogni domenica alle 03:00 e dura fino a sei ore. Su una destinazione segue la pianificazione della copia off-site dell'istanza madre per quella destinazione. L'istanza madre conserva i backup secondo la propria regola per la sezione in Per quanto tempo conservare, oppure secondo la regola della destinazione, se ne ha una.
- Nell'elenco delle esecuzioni del nodo, i backup e i ripristini avviati dall'istanza madre compaiono come avviati da lei.
Tenere d'occhio i nodi¶
La scheda Nodi nella panoramica elenca ogni nodo con il suo stato, l'ultimo backup, gli errori e le anomalie aperte. Compare appena hai un nodo.

L'istanza madre manda un avviso per episodio attraverso i suoi canali di notifica, e il successivo solo quando quell'episodio è finito:
- Un backup non è riuscito, per esempio BombVault: vps-helsinki: backup failed, con l'elemento e il motivo. Un backup successivo di quell'elemento che va a buon fine chiude l'episodio.
- Il nodo non è raggiungibile, per esempio BombVault: vps-helsinki is out of reach. L'istanza madre aspetta quanto l'interruttore dell'uomo morto più breve tra i repository del nodo, 26 ore se non lo cambi, oppure 6 ore finché il nodo non ha ancora una destinazione.
Il monitoraggio del ricevitore dell'istanza madre si occupa anche di ogni repository di un nodo, con un interruttore dell'uomo morto e un restic check giornaliero alle 04:00, vedi Ricevitore e prelevatore.
Gli elementi di un nodo¶
In Backup, gli elenchi Container e Cartelle hanno una sezione per ogni nodo sotto i tuoi elementi. Il container del nodo stesso non compare. Esegui backup ora nel menu di un elemento avvia il suo backup sul nodo, e Apri apre la sua pagina.
Nella sezione di un nodo dell'elenco Cartelle, Aggiungi set di cartelle aggiunge un set di cartelle sul nodo, e Modifica nel menu di un set lo cambia. Entrambi aprono la stessa finestra dei tuoi set. Il selettore di cartelle della finestra sfoglia le cartelle del nodo, ma non vi crea cartelle nuove.

La pagina di un elemento di un nodo dice Su e il nome del nodo, ed elenca i suoi backup. Ripristina su uno di essi ripristina l'elemento sul nodo e sostituisce ciò che c'è adesso. Per farlo il container viene fermato, come sull'istanza madre.

Attraverso l'istanza madre raggiungi un elenco fisso di percorsi del nodo: i suoi container, set di cartelle, esecuzioni e anomalie, e il loro backup e ripristino. Le impostazioni, le chiavi e lo spazio di archiviazione del nodo restano fuori portata, e nulla in quell'elenco elimina. Vedi I nodi nell'API.
Sostituire e rilasciare¶
Sostituisci mostra di nuovo il file compose del nodo, dopo un accesso con la password. Usalo per spostare il nodo su un altro server o per ricostruirlo: avvia il file lì e spegni il vecchio server. La stessa APP_KEY e lo stesso NODE_HOME lo rendono di nuovo lo stesso nodo, con i suoi backup e la sua cronologia. L'istanza madre conserva di ogni nodo i set di cartelle, i container con ciò che serve per ricrearli e le esecuzioni. Quando il nodo si avvia con una cartella config vuota, l'istanza madre lo riprende, gli dice dove vanno i suoi backup e gli restituisce tutto prima del backup successivo, così il nodo può ripristinare un container che non esiste più. Su un server nuovo, un nodo che tiene i backup da sé parte con repository vuoti. I suoi backup precedenti restano nelle copie che l'istanza madre ha prelevato. Due server con la stessa APP_KEY contano come un solo nodo, quindi non farli mai girare entrambi.
Rilascia lascia andare un nodo. Smette di prendere ordini dall'istanza madre e non fa più nessun backup. I suoi backup restano dove sono, come ogni copia che l'istanza madre ha prelevato. Il suo accesso sul server ricevente sparisce, e l'istanza madre smette di controllare i suoi repository. Un nodo assente al momento del rilascio mantiene la sua scheda come In fase di rilascio finché non lo viene a sapere. Un nodo rilasciato non accetta più un'istanza madre con la stessa APP_KEY. Per usare di nuovo il server, aggiungilo come nuovo nodo e avvialo con il nuovo file compose e una cartella config vuota.
Sicurezza¶
Se qualcuno prende il controllo dell'istanza madre, controlla anche i suoi nodi, e un nodo ha in mano Docker sul suo server, cioè root. Proteggi l'istanza madre con una password e tienila lontana da internet. Se qualcuno prende il controllo di un nodo, non ottiene nessun gruppo di associazione, nessuna fortezza, nessun altro nodo e nessun altro repository, e non può cancellare la cronologia sul server ricevente. I dettagli sono in I nodi nel modello di sicurezza.
Il kit di ripristino ha un capitolo Nodes con la APP_KEY di ogni nodo, la sua password restic e i suoi repository, così puoi riportare in vita un nodo o ripristinarne i backup con il solo restic.