BombVault¶
Datele tale Unraid, sigilate într-un seif. Depune un backup. Detonează o restaurare.

BombVault este o aplicație web self-hosted pentru backup și recuperare completă în caz de dezastru pe Unraid și pe alte gazde Docker, precum TrueNAS SCALE, ZimaOS sau un simplu server Linux. Salvează containere Docker, mașini virtuale KVM/libvirt, foldere, seturi de date ZFS și unitatea flash Unraid. Rulează ca un singur container Docker multi-arch, îți oferă o interfață web cu temă închisă, deschisă sau cea a sistemului, și gestionează întregul ciclu de viață: backup, programare, verificare și restaurare.
Restaurările sunt automate. Pe Unraid, containerele reapar în fila Docker exact ca înainte, iar VM-urile sunt redefinite în VM Manager cu discurile și NVRAM-ul UEFI reatașate. Fără reinstalare manuală, fără reconfigurare, fără drame. Pe TrueNAS, un container restaurat lângă original rulează ca un container Docker obișnuit, pe care ecranul Apps nu îl listează.
Bazat pe restic, așa că fiecare backup este deduplicat, incremental și criptat implicit.
Păstrează-ți APP_KEY în siguranță
BombVault derivă parola depozitului restic dintr-un secret de 32 de octeți numit APP_KEY. Pierderea lui, împreună cu kitul de recuperare, face ca copiile de rezervă criptate să nu mai poată fi recuperate. Generează unul cu openssl rand -hex 32 și păstrează-l undeva în siguranță. Vezi Configurare.
Ce protejează BombVault¶
Fiecare container, VM, set de foldere, unitatea flash, fiecare set de date ZFS și propriile setări ale BombVault sunt un element cu o pagină proprie. Elementele de același fel formează o secțiune, pe care o activezi la Setări, General.
| Secțiune | Ce se salvează |
|---|---|
| Containere | Directorul appdata plus definiția containerului (imagine, variabile de mediu, porturi, etichete, volume). |
| VM-uri | Imaginea (imaginile) de disc a VM-ului, definiția XML și NVRAM-ul UEFI, salvate prin SSH (fără montare libvirt). |
| Flash | Întregul flash USB (/boot): sistemul de operare, licența, configurația array-ului, partajările, rețeaua și configurația plugin-urilor. |
| Auto-backup | Propriul /config al BombVault: baza sa de date de setări, datele de autentificare ale destinațiilor sale, perechea de chei SSH pentru libvirt, cheia și cheile de gazdă fixate ale serverelor ZFS și certificatele. |
| Foldere | Orice folder de pe server ca set de foldere, fiecare cu tipare de excludere opționale. |
| Seturi de date ZFS | Un set de date cu toate seturile de sub el, citit dintr-un instantaneu ZFS și salvat ca un folder. Vezi Seturi de date ZFS. |
Restaurarea este vedeta¶
După copierea datelor înapoi din instantaneul restic, BombVault reaplică definiția salvată a containerului prin API-ul Docker, astfel încât containerul reapare în fila Docker din Unraid ca și cum ar fi fost mereu acolo (aceeași imagine, aceleași setări, aceleași mapări de porturi). VM-urile își au XML-ul redefinit prin SSH și discurile și NVRAM-ul UEFI reatașate, chiar și după ce VM-ul a fost șters.
O singură fereastră restaurează orice fel de element. Implicit alege Lângă original, care aduce copia de rezervă înapoi ca o copie și lasă originalul neatins. Înlocuiește originalul face mai întâi o copie de rezervă a stării curente, așa că o restaurare poate fi anulată. Un folder sau un set de date ZFS nou sunt celelalte ținte.
Când un backup oprește containere dependente, ele revin în ordinea corectă: BombVault le repornește în ordinea depends_on din Compose și așteaptă ca fiecare să raporteze că este sănătos înainte de a le porni pe cele care depind de el, astfel încât nimic nu o ia înainte unei baze de date sau unui gateway care nu este încă activ. Vezi Restaurare și Comenzi și alte containere.
Cum funcționează¶
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 folosește socketul Docker pentru a opri containerele înainte de un backup și pentru a le recrea după o restaurare. Pentru VM-uri rulează virsh pe gazdă prin SSH (qemu+ssh://) ca să oprească un VM în mod controlat sau să facă un instantaneu live. Nu montează niciodată o cale libvirt, așa că nu poate încurca VM Manager-ul de pe gazdă.
BombVault este stratul de orchestrare și interfață, nu motorul de stocare. Toată mișcarea reală a datelor trece prin restic.
Pornire rapidă¶
Nou pe aici? Mergi la Primii pași pentru a instala BombVault și a rula primul tău backup, apoi configurează Off-site și recuperare. Exemplele lucrate parcurg sarcinile obișnuite de la un capăt la altul, pagina Setări listează fiecare placă, iar Funcționalitățile sunt catalogul scurt cu tot ce face BombVault.
Fiecare secțiune poate copia simultan în mai multe destinații, un BombVault împerecheat poate păstra copiile tale externe pe un server care refuză ștergerile, iar Asistentul de urgență readuce un server pierdut din kitul lui de recuperare, prin grupul tău sau cu cheia tastată. Ca să-ți muți configurația pe o stație nouă, folosește cardul Exportă / importă setările. Vezi Off-site și recuperare și Configurare.
Aplicația Android pune toate serverele grupului tău pe telefon, cu jurnalul de activitate al tuturor pe un singur ecran.
Documentația există în 26 de limbi, iar interfața în 42. Paginile care nu au încă traducere apar în engleză.
Cuvinte folosite aici¶
Câteva cuvinte au un sens fix în BombVault și în aceste pagini.
| Cuvânt | Sens |
|---|---|
| Element | Un lucru pe care BombVault îl salvează: un container, un VM, un set de foldere, unitatea flash, un set de date ZFS împreună cu cele de sub el sau propriile setări. Fiecare are o pagină proprie. |
| Secțiune | Toate elementele de același fel, de exemplu Containere. Secțiunile se activează la Setări, General. |
| Destinație | Un loc unde ajung copiile de rezervă: un folder de pe acest server, o partajare, un server al tău sau un serviciu cloud. Vezi Destinații. |
| Local | Destinația de pe acest server care ține folderele secțiunilor. |
| Dosar propriu | Depozitul în care o secțiune își scrie mai întâi copiile. Implicit se află pe acest server și poate sta într-o destinație. Vezi Dosarul propriu al unei secțiuni. |
| Copie | O copie de rezervă copiată din folderul propriu într-o altă destinație cu restic copy. |
| Depozit direct | Un depozit la o destinație off-site în care elementele salvează direct, fără o copie locală între ele. Vezi Depozite directe. |
| Autentificare | Cheia sau parola salvată pentru un serviciu S3 sau un rest-server. Una dintre ele este cea implicită. Vezi Autentificări. |
| Amplasare | Ce destinații primesc copiile unui element, stabilit pe element sau ca valoare implicită a secțiunii. Vezi Amplasare per element. |
| Replică | O copie identică bloc cu bloc a unui element ZFS pe un al doilea server ZFS, făcută cu zfs send. Stă lângă backup și nu îl înlocuiește. Vezi Replică. |
| Rol | Ceva ce o instanță din grupul tău face pentru alta: Receptor, Preluator, Server ZFS sau Păstrător de cheie. Vezi Instanțe și roluri. |
| Nod | Un BombVault fără interfață web, de exemplu pe un VPS, căruia altă instanță, instanța-mamă a acestuia, îi spune ce să copieze, când și unde. Vezi Noduri. |
| Instanța-mamă | Instanța care a adăugat un nod și îl controlează. Păstrează cheia nodului și îi spune ce să copieze, când și unde. Vezi Noduri. |
Mulțumiri¶
- VolumeVault de @Darkdragon14 (Apache-2.0) i-a dat lui BombVault ideea de pornire: backup dintr-un clic și reinstalarea automată a containerelor Docker. BombVault este o implementare separată, pe Go și restic, care duce ideea mai departe la VM-uri, la flash și nu numai.
- restic este motorul de backup rapid, sigur și cu deduplicare pe care îl folosește BombVault.
- rclone oferă backendurile cloud.
- Majoritatea glifelor de pe butoane provin din setul gratuit Core Solid de la Streamline (CC BY 4.0, sursă). Celelalte provin din Font Awesome Free, Material Design Icons, Simple Icons și Tabler Icons sau au fost desenate pentru proiect.
Licență¶
Copyright (C) 2026 Junker der Provinz. BombVault este software liber sub GNU Affero General Public License v3.0 (LICENSE). Îl poți rula, studia, distribui și modifica. Dacă îl distribui sau rulezi o versiune modificată ca serviciu de rețea, trebuie să publici codul sursă sub aceeași licență și să păstrezi notificările existente de copyright și de atribuire.
Numele și identitatea vizuală nu sunt licențiate. AGPL acoperă doar codul sursă: "BombVault", logoul și identitatea sa vizuală rămân rezervate, așa că un fork trebuie să folosească un nume și o identitate vizuală proprii și nu are voie să se prezinte drept BombVault.
Linkuri¶
- Cod sursă: github.com/junkerderprovinz/bombvault
- Fir de suport Unraid: forums.unraid.net
- Probleme: github.com/junkerderprovinz/bombvault/issues
Control al gazdei echivalent cu root
Prin socket-ul Docker, BombVault poate opri, elimina și recrea containere și poate citi/scrie appdata, iar pentru backupul VM se autentifică pe gazdă prin SSH pentru a rula virsh. Oricine poate ajunge la interfața sa web are efectiv root pe gazdă. Rulează BombVault doar într-o rețea de încredere, neexpusă, și setează o parolă de conectare la Setări, Securitate. Kitul de recuperare, depunerile de chei, ZIP-ul flash și exportul unui backup flash sau al unui auto-backup au nevoie de una. Vezi Configurare pentru modelul complet de securitate.