Vai al contenuto

BombVault

Drop a backup. Detonate a restore.

Backup and full disaster recovery for Unraid and other Docker hosts. Containers, VMs, folders, ZFS datasets and the flash drive, restored the way they were.

BombVault

I tuoi dati Unraid, sigillati in una cassaforte. Deposita un backup. Fai detonare un ripristino.

La panoramica: l'intestazione di stato, ciò che richiede attenzione, la protezione di ogni sezione, le destinazioni e la cronologia. La panoramica: l'intestazione di stato, ciò che richiede attenzione, la protezione di ogni sezione, le destinazioni e la cronologia.

BombVault è un'app web self-hosted per il backup e il disaster recovery completo su Unraid e su altri host Docker, come TrueNAS SCALE, ZimaOS o un semplice server Linux. Salva container Docker, VM KVM/libvirt, cartelle, dataset ZFS e la chiavetta flash di Unraid. Gira come un unico container Docker multi-arch, ti offre un'interfaccia web con tema scuro, chiaro o del sistema e gestisce l'intero ciclo di vita: backup, pianificazione, verifica e ripristino.

I ripristini sono automatici. Su Unraid i container riappaiono nella scheda Docker esattamente come prima, e le VM vengono ridefinite nel VM Manager con i loro dischi e la NVRAM UEFI ricollegati. Nessuna reinstallazione manuale, nessuna riconfigurazione, nessun dramma. Su TrueNAS un container ripristinato accanto all'originale gira come un normale container Docker che la schermata Apps non elenca.

Basato su restic, quindi ogni backup è deduplicato, incrementale e cifrato di default.

Tieni al sicuro la tua APP_KEY

BombVault deriva la password del repository restic da un segreto di 32 byte chiamato APP_KEY. Perderlo, insieme al kit di ripristino, rende i backup cifrati irrecuperabili. Generane uno con openssl rand -hex 32 e conservalo in un luogo sicuro. Vedi Configurazione.

Cosa protegge BombVault

Ogni container, VM, set di cartelle, la chiavetta flash, ogni dataset ZFS e le impostazioni di BombVault stesso sono un elemento con una pagina propria. Gli elementi dello stesso tipo formano una sezione, che attivi in Impostazioni, Generale.

Sezione Cosa viene salvato
Container La directory appdata più la definizione del container (immagine, variabili d'ambiente, porte, label, volumi).
VM Le immagini disco della VM, la definizione XML e la NVRAM UEFI, salvate via SSH (nessun mount libvirt).
Flash L'intera chiavetta USB (/boot): sistema operativo, licenza, configurazione dell'array, condivisioni, rete e configurazione dei plugin.
Auto-backup Il /config di BombVault stesso: il suo database delle impostazioni, le credenziali delle sue destinazioni, la coppia di chiavi SSH di libvirt, la chiave e le chiavi host fissate dei server ZFS e i certificati.
Cartelle Qualsiasi cartella del server come set di cartelle, ciascuno con pattern di esclusione opzionali.
Dataset ZFS Un dataset con tutti i dataset sottostanti, letto da uno snapshot ZFS e salvato come una cartella. Vedi Dataset ZFS.

Il ripristino è la star

Dopo aver ricopiato i dati dallo snapshot restic, BombVault riesegue la definizione del container salvata contro l'API Docker, così il container riappare nella scheda Docker di Unraid come se ci fosse sempre stato (stessa immagine, stesse impostazioni, stessi mapping delle porte). Le VM vengono ridefinite via SSH tramite il loro XML e i loro dischi e la NVRAM UEFI vengono ricollegati, anche dopo che la VM è stata eliminata.

Una sola finestra ripristina ogni tipo di elemento. Di norma è scelto Accanto all'originale, che riporta il backup come copia e lascia l'originale com'è. Sostituisci l'originale esegue prima il backup dello stato attuale, così un ripristino si può annullare. Una cartella o un nuovo dataset ZFS sono le altre destinazioni.

Quando un backup ferma i container dipendenti, questi tornano nell'ordine giusto: BombVault li riavvia nel loro ordine depends_on di Compose e attende che ciascuno risulti sano prima di avviare quelli che dipendono da esso, così nulla parte prima di un database o di un gateway non ancora attivo. Vedi Ripristino e Comandi e altri container.

Come funziona

Browser --HTTPS--> BombVault container
                   |- Go binary: JSON API + embedded React UI
                   |- Background worker (per-section scheduler + job executor)
                   |
                   |- /var/run/docker.sock  -> Docker API (container stop/inspect/recreate)
                   |- qemu+ssh://host       -> libvirt / KVM on the HOST over SSH (no mount)
                   |- /mnt/ -> /host/user   -> appdata, VM disks + restic repos (read/write)
                   |- /boot/ -> /host/boot  -> Unraid flash backup (whole USB)
                   |- /config               -> BombVault's own settings + sign-ins (self-backup)
                   '- <repo path>           -> restic repository (local or remote: rclone/s3/rest/sftp)

BombVault usa il socket Docker per fermare i container prima di un backup e per ricrearli dopo un ripristino. Per le VM esegue virsh sull'host via SSH (qemu+ssh://) per spegnere una VM in modo ordinato o fare uno snapshot a caldo. Non monta mai un percorso libvirt, quindi non può intralciare il VM Manager dell'host.

BombVault è il livello di orchestrazione e interfaccia, non il motore di archiviazione. Tutto il movimento effettivo dei dati passa attraverso restic.

Avvio rapido

Sei nuovo? Vai a Primi passi per installare BombVault ed eseguire il tuo primo backup, poi imposta Off-site e ripristino. Gli esempi pratici ti accompagnano dall'inizio alla fine nei compiti più comuni, la pagina Impostazioni elenca ogni scheda e Funzionalità è il breve catalogo di tutto ciò che BombVault sa fare.

Ogni sezione può copiare su più destinazioni contemporaneamente, un BombVault associato può tenere le tue copie off-site in un server che rifiuta le cancellazioni, e la Procedura guidata di emergenza riporta in vita un server perso dal suo kit di ripristino, tramite il tuo gruppo o con la chiave digitata. Per portare la configurazione su una nuova macchina usa la scheda Esporta / importa impostazioni. Vedi Off-site e ripristino e Configurazione.

L'App Android porta tutti i server del tuo gruppo sul telefono, con il registro attività di tutti quanti in un'unica schermata.

La documentazione è disponibile in 26 lingue e l'interfaccia in 42. Le pagine non ancora tradotte compaiono in inglese.

Parole usate qui

Alcune parole hanno in BombVault, e in queste pagine, un significato fisso.

Parola Significato
Elemento Una cosa che BombVault salva: un container, una VM, un set di cartelle, la chiavetta flash, un dataset ZFS con quelli sottostanti o le sue stesse impostazioni. Ognuno ha una pagina propria.
Sezione Tutti gli elementi dello stesso tipo, per esempio Container. Le sezioni si attivano in Impostazioni, Generale.
Destinazione Un posto in cui vanno i backup: una cartella di questo server, una condivisione, un server tuo o un servizio cloud. Vedi Destinazioni.
Locale La destinazione su questo server che contiene le cartelle delle sezioni.
Cartella propria Il repository in cui una sezione scrive per primo i suoi backup. Di default si trova su questo server e può stare in una destinazione. Vedi La cartella propria di una sezione.
Copia Un backup copiato dalla cartella propria su un'altra destinazione con restic copy.
Repository diretto Un repository in una posizione off-site su cui gli elementi salvano direttamente, senza una copia locale nel mezzo. Vedi Repository diretti.
Credenziali La chiave o la password salvata per un servizio S3 o un rest-server. Una di esse è quella predefinita. Vedi Credenziali.
Destinazioni di un elemento Quali destinazioni ricevono i backup di un elemento, impostate sull'elemento o come valore predefinito della sua sezione. Vedi Destinazioni per elemento.
Replica Una copia identica a livello di blocchi di un elemento ZFS su un secondo server ZFS, fatta con zfs send. Sta accanto al backup e non lo sostituisce. Vedi Replica.
Ruolo Qualcosa che un'istanza del tuo gruppo fa per un'altra: Ricevitore, Prelevatore, Server ZFS o Custode della chiave. Vedi Istanze e ruoli.
Nodo Un BombVault senza interfaccia web, per esempio su un VPS, a cui un'altra istanza, la sua istanza madre, dice di cosa fare il backup, quando e dove. Vedi Nodi.
Istanza madre L'istanza che ha aggiunto un nodo e lo controlla. Conserva la chiave del nodo e gli dice di cosa fare il backup, quando e dove. Vedi Nodi.

Riconoscimenti

  • VolumeVault di @Darkdragon14 (Apache-2.0) ha dato a BombVault la sua idea di partenza: backup con un clic e reinstallazione automatica dei container Docker. BombVault è un'implementazione separata, basata su Go e restic, che estende l'idea alle VM, alla flash e ad altro ancora.
  • restic è il motore di backup veloce, sicuro e con deduplicazione che BombVault pilota.
  • rclone fornisce i backend cloud.
  • La maggior parte dei glifi sui pulsanti proviene dal set gratuito Core Solid di Streamline (CC BY 4.0, sorgente). Gli altri provengono da Font Awesome Free, Material Design Icons, Simple Icons e Tabler Icons, oppure sono stati disegnati per il progetto.

Licenza

Copyright (C) 2026 Junker der Provinz. BombVault è software libero rilasciato sotto la GNU Affero General Public License v3.0 (LICENSE). Puoi eseguirlo, studiarlo, condividerlo e modificarlo. Se lo distribuisci, o se esegui una versione modificata come servizio di rete, devi pubblicare il tuo codice sorgente con la stessa licenza e mantenere le note di copyright e di attribuzione esistenti.

Il nome e il marchio non sono concessi in licenza. L'AGPL copre solo il codice sorgente: "BombVault", il suo logo e la sua identità visiva restano riservati, quindi un fork deve usare un nome e un'identità visiva propri e non può presentarsi come BombVault.

Controllo dell'host equivalente a root

Tramite il socket Docker BombVault può fermare, rimuovere e ricreare container e leggere e scrivere appdata, e per il backup delle VM accede all'host via SSH per eseguire virsh. Chiunque possa raggiungere la sua interfaccia web ha di fatto accesso root all'host. Esegui BombVault solo su una rete affidabile e non esposta, e imposta una password di accesso in Impostazioni, Sicurezza. Il kit di ripristino, i depositi della chiave, lo ZIP della flash e l'esportazione di un backup della flash o di un auto-backup ne hanno bisogno. Vedi Configurazione per il modello di sicurezza completo.