Configurare¶
Această pagină acoperă variabilele de mediu ale containerului, montările pe care le oferă șablonul, modelul de securitate, backupul VM prin SSH și configurarea off-site. Locul unde ajung backupurile se configurează în interiorul aplicației ca destinații, nu prin variabile de mediu.
Variabile de mediu¶
| Variabilă | Obligatorie | Descriere |
|---|---|---|
APP_KEY |
Da | Secret hex de 32 de octeți (64 de caractere hex) folosit pentru a deriva parola depozitului restic. Generează cu openssl rand -hex 32. Păstrează-l în siguranță: pierderea lui face ca backupurile criptate să nu mai poată fi recuperate. |
LIBVIRT_HOST |
Pentru VM-uri și seturi de date ZFS | Gazda Unraid accesată prin SSH pentru backupurile VM și ale seturilor de date ZFS (câmpul de șablon Host SSH: Address, implicit host.docker.internal). Șablonul precompletează substituentul 192.168.x.x, care contează ca nesetat. Folosește IP-ul LAN al Unraid, obligatoriu pe o rețea br0.x personalizată. Când host.docker.internal nu se rezolvă, ca într-o aplicație TrueNAS, și nici LIBVIRT_URI nu numește o gazdă, BombVault folosește gateway-ul implicit al containerului, iar jurnalul de pornire îl numește. |
LIBVIRT_SSH_PORT |
Nu | Portul SSH al gazdei pentru backupurile VM și ale seturilor de date ZFS (câmpul de șablon Host SSH: Port, implicit 22). |
LIBVIRT_SSH_USER |
Nu | Utilizatorul SSH de pe gazdă pentru backupurile VM și ale seturilor de date ZFS (câmpul de șablon Host SSH: User, implicit root). |
LIBVIRT_URI |
Nu | URI-ul complet de conexiune libvirt, folosit ca atare în locul construirii unuia din cele trei variabile LIBVIRT_* de mai sus (care sunt apoi ignorate pentru șirul de conexiune). Nesetat implicit. Necesar pe TrueNAS Scale, al cărui libvirtd ascultă pe un socket non-standard pe care forma construită nu îl poate exprima: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. Vezi ghidul de backup VM. Dacă este un URI qemu+ssh://, fiecare dintre LIBVIRT_HOST, LIBVIRT_SSH_USER și LIBVIRT_SSH_PORT care nu este setată se ia din el, și pentru comenzile SSH proprii ale BombVault (transferul NVRAM, seturile de date ZFS). |
PORT |
Nu | Portul HTTP (implicit 3000. Folosit doar cu HTTP_ONLY=true). |
HTTPS_PORT |
Nu | Portul HTTPS (implicit 3443. Șablonul îl publică 1:1, deci WebUI răspunde la https://<ip>:3443). |
HTTP_ONLY |
Nu | Setează true pentru a dezactiva ascultătorul HTTPS auto-semnat și a servi doar HTTP simplu (pentru utilizare în spatele unui reverse proxy care termină TLS). |
BIND_HOST |
Nu | Adresa pe care ascultă WebUI (implicit 0.0.0.0, toate interfețele). Las-o nesetată în container, ale cărui porturi publicate au nevoie de toate interfețele. 127.0.0.1 se potrivește unei rulări în afara Docker. Healthcheck-ul întreabă aceeași adresă. |
TRUSTED_PROXY |
Nu | Adrese sau intervale CIDR, separate prin virgulă, ale reverse proxy-ului din fața BombVault (de exemplu 192.168.20.11 sau 10.0.0.0/8). Doar de la aceste noduri se crede antetul X-Forwarded-For, iar limitarea autentificărilor numără atunci eșecurile pe client real, în loc să pună toți clienții din spatele proxy-ului în aceeași găleată. Nesetat (implicit) înseamnă că nimeni nu este crezut: un antet crezut necondiționat ar lăsa pe oricine să își aleagă propria găleată. |
HOST_SOURCE_ROOT |
Nu | Calea gazdei montată ca Host Data (implicit /mnt). BombVault traduce sursele de bind-mount raportate de Docker în căi sub această montare. Schimbă doar dacă ai montat o altă rădăcină de gazdă. |
HOST_MOUNT_ROOT |
Nu | Locul în care Host Data este montat în container (implicit /host/user). Pe TrueNAS, Host Data este montat la propria lui cale de pe gazdă, așa că această variabilă și HOST_SOURCE_ROOT numesc amândouă acea cale, de exemplu /mnt/tank (vezi TrueNAS SCALE). |
DATA_ROOT_SEGMENTS |
Nu | Nume de segmente de cale separate prin virgulă care marchează o sursă de bind-mount ca date de backup (implicit appdata, conform convenției /mnt/user/appdata/<container> a Unraid). Bind-mount-ul unui container este selectat automat pentru backup atunci când ORICARE segment din listă apare ca segment complet de cale în sursa sa de pe gazdă. De exemplu, DATA_ROOT_SEGMENTS=appdata,config preia și un bind .../config. Potrivirea ignoră literele mari și mici, deci valoarea implicită acoperă și /DATA/AppData/<container> din ZimaOS. Vezi Detectarea surselor de backup pentru celelalte moduri, mereu active, prin care este găsit folderul de date al unui container. |
PLATFORM |
Nu | Forțează platforma pe care BombVault se consideră că rulează, în loc să o detecteze automat: unraid, generic sau truenas (nesetat implicit: detectează automat Unraid sondând markerul său dockerMan sub montarea flash-ului, altfel generic. O valoare nerecunoscută revine de asemenea la generic, înregistrată în jurnal). Setează-o explicit pe o gazdă Docker generică sau pe TrueNAS Scale, în loc să te bazezi pe auto-sondarea specifică Unraid. Fișierul compose generic face exact acest lucru. Schimbă convenția de rezervă pentru appdata, valorile implicite ale destinației de restaurare între instanțe și dacă pașii specifici Unraid de notificare și plugin însoțitor sunt încercați deloc (vezi internal/platform). |
BOMBVAULT_SELF_CONTAINER |
Nu | Numele containerului BombVault însuși, astfel încât să nu-și facă niciodată backup (și deci să nu se oprească) singur. |
BACKUP_MAX_HOURS |
Nu | Numărul maxim de ore de ceas pe care o singură rulare de backup îl poate ține blocajul de secțiune înainte de a fi anulată forțat (o gardă, ca o rulare blocată să nu poată bloca secțiunea la nesfârșit). Gol (implicit) folosește 48. Ridică-l pentru backupuri cloud foarte mari sau lente (o rulare anulată la limită eșuează cu context deadline exceeded). Setează 0 pentru a dezactiva complet limita. Un prune respectă aceeași limită, iar o verificare sau un prune rulează cât timp restic raportează progres. |
BACKUP_STALL_HOURS |
Nu | Orele în care un backup poate să nu facă niciun progres înainte de a fi anulat. Gol (implicit) folosește 2. Setează 0 pentru a nu anula niciodată la blocare. Este cea mai fină dintre cele două gărzi și de obicei cea care se declanșează: urmărește dacă se mai întâmplă ceva, nu cât durează rularea, așa că un backup de mai mulți terabytes lent, dar sănătos, este lăsat în pace, în timp ce unul blocat pe un share care nu răspunde este oprit în câteva ore în loc de zile. După 30 de minute de liniște se scrie un avertisment în jurnal, înainte de a anula ceva. Scanarea contează ca progres: restic nu scrie niciun octet cât timp parcurge un arbore mare, iar acea fază este urmărită prin totalurile sale de fișiere și octeți, nu prin octeții scriși. Cele două variabile sunt independente, iar BACKUP_MAX_HOURS limitează în continuare fazele de după backupul propriu-zis (retenție, statistici, copie off-site), unde nu există contoare de urmărit. |
DB_DUMP_MAX_HOURS |
Nu | Orele în care un dump automat de bază de date poate rula înainte să fie oprit. Gol (implicit) înseamnă 6. Sunt permise valori de la 1 la 48, iar limita rămâne cu o oră sub BACKUP_MAX_HOURS (la jumătatea acesteia când e sub două ore), astfel încât un dump lung să fie tăiat de propria limită și raportat ca atare, în loc să tragă backupul după el. Un dump care nu mai avansează este oprit mai devreme, după BACKUP_STALL_HOURS. Un dump oprit eșuează de unul singur, iar backupul containerului continuă. Pe Unraid adaugi variabila la containerul BombVault cu Add another Path, Port, Variable. |
TZ |
Nu | Fusul orar pentru programator (de exemplu Europe/Berlin). Dacă nu este setată, toate programările rulează în UTC: o programare la 02:30 pornește atunci la 02:30 UTC, nu la ora ta locală. Pe Unraid nu setezi niciodată acest lucru: sistemul transmite propriul fus orar fiecărui container. Jurnalul de pornire arată ce fus a fost aplicat. Un fus cu oră de vară sare peste o rulare primăvara și rulează una de două ori toamna, în timp ce UTC nu face niciuna dintre acestea, dar se decalează cu o oră față de ceasul tău de două ori pe an. |
DATA_DIR |
Nu | Locul unde BombVault își ține baza de date, cheile și cache-urile (implicit /config). Las-o în pace în container. Contează când rulezi binarul în afara Docker. |
FLASH_DIR, FLASH_TEMPLATES_DIR |
Nu | Locul unde sunt montate în container unitatea flash și șabloanele ei Docker (implicit /host/boot și /host/boot/config/plugins/dockerMan/templates-user). Urmează montarea /boot a șablonului, așa că lasă-le nesetate. |
MODE |
Nu | full (implicit) rulează toată aplicația. node rulează un nod: fără interfață web și fără programări proprii, doar ce îi spune instanța lui mamă. Orice altă valoare oprește pornirea cu un mesaj. Instanța-mamă o completează pentru tine în fișierul compose al nodului. |
NODE_HOME |
Pe un nod | Cărei instanțe-mamă îi aparține nodul, cu cheia și relay-ul ei, ca o singură valoare care începe cu bvhome1.. Instanța-mamă o scrie în fișierul compose al nodului. Fără ea nodul pornește, dar nicio instanță-mamă nu ajunge la el. Un nod preluat de o instanță-mamă refuză să pornească atunci când NODE_HOME numește alta, până când prima îl eliberează. |
NODE_NAME |
Nu | Numele nodului, așa cum l-a completat instanța-mamă din numele dat de tine. |
Montări¶
Montează socket-ul Docker, flash-ul (/boot) și rădăcina Host Data (/mnt) așa cum se arată în șablonul CA. Atât sursele, cât și destinațiile backupurilor se află sub Host Data, iar aceasta este montată slave, astfel încât un share la distanță care se montează după ce containerul pornește (de exemplu sub /mnt/remotes) devine vizibil fără repornire.
Pe TrueNAS, Host Data este calea unui set de date, cum ar fi /mnt/tank, niciodată un ixVolume. Datele pe care o aplicație le ține într-un ixVolume se află în afara lui și nu intră în backup. Vezi TrueNAS SCALE.
Backupurile seturilor de date ZFS au și ele nevoie de acest mod: gazda montează instantaneul unui set de date abia după ce containerul a pornit. Vezi Seturi de date ZFS.
Depozitele locale sunt implicit /mnt/user/bombvault/{container,vms,flash,config,files,zfs}, create la primul backup. Sunt dosarele proprii ale secțiunilor și formează destinația Local. Pe pagina ei de la Destinații, cardul Conexiune schimbă folderul fiecărei secțiuni.
Dosarul propriu al unei secțiuni poate trăi și într-o destinație pe care o ai deja, de exemplu un NAS sau un bucket S3: Folosește ca dosar propriu pe pagina acelei destinații îl mută acolo și spune mai întâi ce se întâmplă cu backupurile deja făcute. Vezi Folderul propriu al unei secțiuni.
Folderele depozitelor locale rămân la modurile 0755 și 0644, ca un utilizator de sincronizare fără drepturi de root prin SMB să nu fie blocat, iar depozitele sunt criptate, deci asta nu expune nimic. Definițiile de recuperare se află în fiecare depozit, așa că un folder copiat este complet de unul singur. Depozitul auto-backupului rămâne citibil doar de root.
Verificare integrare gazdă
Cardul Integrare gazdă din prezentare (îl adaugi la Personalizează) sondează fiecare montare și CLI (socket Docker, libvirt, restic, qemu-img, rclone) și raportează orice element lipsă.
Detectarea surselor de backup¶
Pentru fiecare container, BombVault alege singur ce montări bind și ce volume cu nume intră în backup. O cale este preluată de îndată ce se aplică oricare dintre punctele următoare (rezultatul poate fi oricând suprascris în cardul Foldere de salvat din fila Setări a containerului):
- Potrivire cu un segment al rădăcinii de date: sursa de pe gazdă a montării bind conține unul dintre segmentele din
DATA_ROOT_SEGMENTSca element complet de cale (implicit doarappdata). - Volumele Docker cu nume sunt incluse întotdeauna, pentru că nu au un echivalent de unică folosință și nu e nimic de filtrat, dar numai atunci când calea reală de stocare a volumului pe gazdă este ea însăși accesibilă prin montarea Host Data, exact ca orice altă cale de gazdă pe care BombVault o salvează. Driverul implicit pentru volume locale al Docker așază un volum sub rădăcina de date a demonului însuși (
/var/lib/docker/volumes/<nume>/_data, dacă nu ai schimbat nimic. Verifică cudocker info -f '{{.DockerRootDir}}'), care nu este acoperită de montarea Host Data îngustă, cu un singur director, pe caredocker-compose.ymlgeneric o folosește implicit. Un volum inaccesibil este sărit în tăcere, nu este o eroare. Ca volumele cu nume să fie salvate cu adevărat pe o gazdă generică, îndreaptă Host Data (șiHOST_SOURCE_ROOT) către un director părinte comun care acoperă și rădăcina de date a Docker. Compromisul este descris în comentariul Host Data din fișierul compose (Unraid ocolește asta montând, din același motiv, întregul/mnt, propria sa convenție universală de nivel superior). - Directorul de proiect Docker Compose: dacă containerul poartă eticheta obișnuită
com.docker.compose.project.working_dir(pusă automat dedocker compose up), și acel director este adăugat, indiferent dacă vreo montare bind a potrivit un segment al rădăcinii de date. - Suprascriere prin eticheta
bombvault.data: pune pe container etichetabombvault.data=truepentru a include toate montările sale bind, pentru o organizare pe care niciuna dintre cele două convenții de mai sus nu o prinde (de exemplu o singură montare/srv/plex/configfără proiect Compose). Orice valoare nevidă în afară defalsecontează ca adevărată. O etichetă absentă saubombvault.data=falsenu schimbă nimic. - Eticheta
bombvault.dbdump: punebombvault.dbdump=falsepe un container pentru a-i opri dumpul automat al bazei de date (0,noșiofffac același lucru) sau numește motorul (postgres,mysql,mariadb) ca să dumpezi un container pe care BombVault nu îl recunoaște singur. Eticheta are întâietate față de comutatorul din cardul Bază de date din fila Setări a containerului, care pe Unraid este calea obișnuită.
Model de securitate¶
Control al gazdei echivalent cu root
Prin socket-ul Docker, BombVault poate opri, elimina și recrea containere și poate citi și scrie appdata, iar pentru backupul VM se autentifică pe gazdă prin SSH (qemu+ssh://, root implicit) pentru a rula virsh. Oricine poate ajunge la interfața sa web are efectiv root pe gazdă.
Autentificare¶
- Protecție opțională cu parolă (cardul Parolă de la Setări, Securitate): setează o parolă pentru a cere autentificare, șterge-o pentru a dezactiva. Dezactivată implicit pentru utilizarea într-o rețea locală de încredere. Parola este stocată cu Argon2id peste o valoare condimentată cu
APP_KEY, așa că un/configcopiat nu valorează nimic fără cheie și este lent de atacat cu ea. O parolă nouă are nevoie de cel puțin 12 caractere. Una mai scurtă deja existentă funcționează până este schimbată. Sesiunile sunt semnate (HMAC derivat dinAPP_KEY), iar schimbarea parolei le invalidează. Autentificările sunt limitate la cinci eșecuri pe minut per client. Schimbarea sau ștergerea parolei cere Parola actuală și, cu autentificarea în doi pași activată, codul. - Unele lucruri cer o parolă. Descărcarea kitului de recuperare, a raportului de eroare și a ZIP-ului unui backup flash, exportul unui backup flash sau al unui auto-backup, depunerea cheii la un păstrător de cheie, permiterea predării unei depuneri, crearea unui cod de recuperare nou, exportul setărilor cu credențiale, autentificarea în doi pași, cheile de acces, adăugarea unui nod, afișarea din nou a fișierului compose al unui nod și deschiderea elementelor unui nod sunt refuzate până când se setează o parolă de conectare, și cer o autentificare chiar pe instanță. Ștergerea backupurilor merge și fără parolă. Când este setată o parolă, cere și ea această autentificare.
- O destinație nu arată nicio parolă. O destinație poate conține o autentificare, ca în
rest:https://user:password@host/repo, iar fiecare pagină și răspuns API o arată carest:https://[redacted]@host/repo, cu sau fără parolă de conectare. Dacă schimbi calea din spatele ei, parola stocată rămâne. Ca să îndrepți destinația spre alt server, scrie destinația întreagă cu parola ei, pentru că o parolă ascunsă rămâne la serverul ei. - Autentificare în doi pași (Setări, Securitate): un cod temporal dintr-o aplicație de autentificare pe lângă parolă, plus opt coduri de recuperare de unică folosință, oferite o singură dată la activare. Secretul comun este stocat criptat cu
APP_KEY, iar dezactivarea cere un cod curent. - Cheile de acces (WebAuthn) au propriul card de îndată ce este setată o parolă, pe lângă parolă și niciodată în locul ei, așa că eliminarea tuturor cheilor de acces nu blochează pe nimeni. Au nevoie de un nume de domeniu real și de un certificat în care browserul are încredere. Adresa implicită
https://<ip>:3443este exact ce refuză WebAuthn, iar cardul spune asta în loc să ofere un buton care ar eșua. Cu autentificarea în doi pași activată, o cheie de acces trebuie să-ți verifice PIN-ul, amprenta sau fața, altfel autentificarea cere și codul. - O restaurare a configurației (Readu setările în Asistentul de urgență) încheie toate sesiunile, elimină toate cheile de acces și revocă toate tokenurile API și cheile MCP, pentru că setările restaurate ar putea aduce înapoi unele care au fost eliminate după ce au fost salvate. Autentifică-te cu parola și configurează din nou cheile de acces la Setări, Securitate.
- O parolă uitată se resetează din pagina de autentificare. Ai uitat parola? face ca BombVault să scrie un cod de 12 caractere, în trei grupuri de câte patru, în jurnalul containerului său (în Unraid: fila Docker, pictograma BombVault, Logs). Cu acel cod și o parolă nouă ești autentificat. Resetarea dezactivează și autentificarea în doi pași, elimină toate cheile de acces, revocă toate tokenurile API, cheile MCP și autentificările OAuth, încheie toate celelalte sesiuni, deconectează toate telefoanele împerecheate și oprește împerecherea telefoanelor. Pagina următoare arată ce s-a eliminat. Un cod este valabil 10 minute, iar încercările greșite nu îl consumă. Tokenurile pentru widget și metrici rămân, pentru că doar citesc.
- Oricine poate citi jurnalul containerului poate reseta parola. Asta înseamnă root pe gazdă, dar și un vizualizator de jurnale precum Dozzle, orice container care primește socketul Docker (e suficient doar pentru citire) și un expeditor de jurnale care trimite mai departe ieșirea containerelor. Dă acest acces doar celor cărora le-ai încredința și parola. Cine ajunge doar la interfața web nu vede niciodată codul.
Telefoane și membrii grupului¶
- Telefoanele împerecheate ajung la o listă permisă. Un telefon care știe cele douăsprezece cuvinte ale grupului se autentifică fără parolă, cât timp Telefoanele se pot împerechea cu cele douăsprezece cuvinte ale grupului este pornit în cardul Aplicația Android de la Setări, Securitate. Sesiunea lui ajunge doar la ce arată aplicația: prezentarea, rulările, backupurile de privit, de pornit și de restaurat, anomaliile de citit și pagina Instanțe de privit. Destinațiile și comenzile ajung la el fără adrese și fără secrete, iar o restaurare care înlocuiește originalul face mai întâi un backup al stării curente. O restaurare într-un folder acceptă doar un folder nou sau gol din folderul de restaurare, iar un telefon nu poate privi în niciun alt folder. Orice altceva răspunde că are nevoie de o autentificare chiar pe instanță: cheile, kitul de recuperare, depunerile de chei, setările, ștergerea backupurilor. O resetare a parolei oprește împerecherea telefoanelor până o pornești la loc. Un telefon eliminat de pe pagina Instanțe, sau cu Interoghează această instanță dezactivat în detaliile lui, își pierde imediat sesiunea, iar un telefon eliminat care își deschide din nou aplicația revine dezactivat.
- În afara casei, un telefon deschide pagini prin relay. Fiecare cerere a paginii este sigilată cu cheia grupului, pe care relay-ul nu o poate citi și nici modifica, și semnată cu o cheie proprie a telefonului, pe care serverul o fixează la primul apel al telefonului și lasă telefonul să intre de îndată ce cineva îl aprobă pe pagina de împerechere. Serverul execută o cerere o singură dată și doar cât timp este recentă. Răspunde doar unui telefon aflat pe pagina Instanțe, cât timp împerecherea telefoanelor este pornită, și doar cu o sesiune pe care a dat-o acelui telefon, așa că deconectarea de peste tot și resetarea parolei încheie și aceste pagini. Serverul semnează fiecare răspuns, iar aplicația verifică semnătura față de cheia pe care a fixat-o pentru acel server și avertizează când cheia se schimbă. O asemenea pagină ajunge la aceeași listă permisă ca un telefon împerecheat, cu sau fără parolă de conectare, plus starea autentificării pe care pagina o citește prima. Autentificarea și deconectarea, resetarea parolei și descărcările rămân la adresa proprie a serverului, iar un răspuns este limitat la 16 MB.
- Membrii semnează ce cer. Cererile de roluri și răspunsurile lor, ofertele de stocare, predarea unei parole restic către un receptor sau un preluator, autentificările receptorului și depunerile de chei sunt semnate cu o cheie a fiecărui membru, pe care o instanță o fixează prima dată când vede membrul. Un apel semnat cu altă cheie este refuzat. Uită cheia, din detaliile unei instanțe, scoate cheia fixată, pentru cazul în care cea cunoscută aici nu este chiar a membrului. Membrul este întrebat din nou de cheie la următorul apel semnat. Membrii cu BombVault 9.x nu semnează și pot fi imitați de oricine are cuvintele, ca în 9.9. O cerere de rol sau o ofertă de stocare de la un membru cu 10.4 sau mai vechi este refuzată până când acel membru este actualizat.
- Cele douăsprezece cuvinte sunt o parolă. Oricine le are intră în grup, vede starea de protecție a membrilor și poate cere roluri, pe care o persoană de la cealaltă instanță trebuie totuși să le permită. Fără o parolă de conectare, oricine poate deschide interfața web le poate citi, iar cardul de împerechere spune asta până se setează o parolă.
Chei¶
- APP_KEY face două lucruri. Sigilează ce stochează această instalare (parole, autentificări, tokenuri) și este cheia backupurilor: parola restic este derivată din ea, iar definițiile containerelor și ale VM-urilor sunt sigilate cu ea.
- O cheie preluată este ținută separat. Când Asistentul de urgență preia backupurile altui server, această instalare continuă să sigileze cu propriul
APP_KEYși stochează cheia celuilalt server ca cheie a copiilor de rezervă, sigilată ca orice alt secret. Kitul de recuperare le tipărește apoi pe ambele. DacăAPP_KEYse schimbă după aceea, cheia backupurilor nu mai poate fi deschisă: BombVault nu mai face backup și spune asta la Necesită atenție, în loc să scrie cu cheia greșită. Încarcă din nou kitul de recuperare la Restaurare, Urgență sau puneAPP_KEYla loc. Vezi Asistentul de urgență. - Criptarea este pornită implicit (Criptează copiile de rezervă în cardul Criptare de la Setări, Securitate). Backupurile sunt criptate de restic cu parola derivată din cheia backupurilor.
- Depunerile de chei. Un păstrător de cheie din grupul tău ține o copie sigilată a kitului de recuperare al acestui server, pe care el nu o poate deschide singur. O deschide doar codul de recuperare de 20 de caractere, iar păstrătorul îl predă abia după ce cineva de acolo apasă Permite. Vezi Păstrător de cheie.
Noduri¶
Un nod este un BombVault fără interfață web care primește comenzi de la o instanță-mamă.
- Instanța-mamă ține nodul. Un nod montează socketul Docker al serverului lui, adică root acolo, iar instanța-mamă controlează nodul. Dacă instanța-mamă este preluată, atacatorul controlează și toate nodurile ei. Dă-i instanței-mamă o parolă de conectare și ține-i interfața web departe de internet.
- Un nod ține puțin. Dacă un nod este preluat, atacatorul nu obține grupul de împerechere, fortăreața, alt nod sau alt depozit. Nodul are doar o legătură cu instanța lui mamă, o autentificare proprie pe serverul receptor și un folder propriu într-o destinație. Pe serverul receptor nu poate șterge istoricul, pentru că serverul este append-only. Poate umple discul serverului, pentru că rest-server nu stabilește nicio cotă, așa că dă-i serverului receptor spațiu sau o partajare proprie. Într-o destinație, autentificarea lui poate de obicei să șteargă ce se află acolo. Copiile păstrate pe nod sunt în mâinile atacatorului, de aceea instanța-mamă preia o copie a lor.
- Legătura este privată și semnată. Instanța-mamă și nodul vorbesc prin relay, pe o legătură a lor, sigilată cu un secret derivat din
APP_KEYal nodului. Fiecare parte cunoaște cheia celeilalte înainte de primul apel, deci nu există un pas de aprobare. Instanța-mamă semnează fiecare apel cu propria cheie și un contor, iar nodul refuză un apel care nu e semnat de instanța-mamă sau pe care l-a primit deja. Nodul nu apelează nimic la instanța-mamă în afară de salutul lui. - Instanța-mamă ajunge la o listă fixă. Cererile pe care instanța-mamă le transmite unui nod rulează doar pe o listă fixă de rute ale nodului, afișată la
GET /api/nodes/routes, iar nodul le răspunde doar cu JSON. Nimic de pe listă nu șterge și nu ajunge la setări, stocare, chei, grup sau tokenuri. Pe instanța-mamă ele cer o autentificare cu parola: telefoanele împerecheate, tokenurile API și cheile MCP nu ajung la un nod. Copiile și restaurările pornite astfel apar ca pornite de instanța-mamă. - Depunerile de chei poartă cheile nodurilor. Instanța-mamă păstrează
APP_KEYal fiecărui nod, iar kitul de recuperare îl tipărește în capitolul Noduri, deci și o depunere de cheie îl conține. Un păstrător de cheie care primește depunerea și codul de recuperare poate deschide depozitele nodurilor tale, dar nu poate comanda un nod, pentru că pentru asta e nevoie de semnătura instanței-mamă. - Eliberarea este definitivă. Un nod eliberat nu mai acceptă nicio instanță-mamă cu același
APP_KEY. Un nod care lipsește când îl eliberezi află de la instanța-mamă când revine.
Rețea¶
- Modificările cer JSON. O cerere care modifică ceva trebuie să trimită
Content-Type: application/jsonși nu are voie să fie marcată de browser ca venind de pe alt site, astfel încât o pagină de pe alt site să nu poată face browserul tău să modifice setări pe o adresă din rețeaua locală. Un script care folosește API-ul trimite acest antet. Orice altceva este refuzat cu415. - Deoarece bariera este opțională, când nu este setată, întreaga interfață și API (inclusiv destinațiile, rutele de test de manipulare și rutele de restaurare) sunt accesibile oricui poate ajunge la port. Setează o parolă de conectare odată ce sunt folosite backupuri off-site, append-only sau criptarea.
- Rulează BombVault doar într-o rețea de încredere, neexpusă. Pentru acces la distanță, pune-l în spatele unui reverse proxy care adaugă autentificare și TLS. Răspunsurile poartă anteturi de securitate de bază (CSP,
nosniff,X-Frame-Options,Referrer-Policy). - În spatele unui reverse proxy fiecare cerere poartă adresa proxy-ului, deci fără
TRUSTED_PROXYlimitarea numără toți clienții în aceeași găleată, iar eșecurile unui atacator te blochează și pe tine. Indică proxy-ul înTRUSTED_PROXYpentru a reveni la numărarea pe client. - Un reverse proxy în fața BombVault trebuie să transmită antetul
AuthorizationsauX-API-Keycătre/mcpși nu are voie să pună răspunsurile în buffer, altfel asistenții nu se pot conecta. Vezi Server MCP. - Endpointul MCP
/mcprăspunde404cât timp nu există nicio cheie și autentificarea prin OAuth nu este activată, și cere fiecărui client cheia sau tokenul lui chiar și cu parola de autentificare dezactivată. Nicio adresă nu este exceptată, nici măcarlocalhost. Nu are unelte de restaurare sau de ștergere, iar restaurarea unui backup al configurației revocă toate cheile. Vezi Server MCP. - Cu
HTTP_ONLY=truecookie-ul de sesiune își pierde indicatorulSecure(trebuie, ca să funcționeze peste HTTP simplu), deci activează parola în spatele unui proxy care termină TLS doar dacă confidențialitatea contează. - Conexiunea SSH de backup VM are încredere în cheia gazdei la prima conexiune (TOFU) și o fixează ulterior. Verifică cheia gazdei prin alt canal dacă drumul de la container la gazdă nu este de încredere.
- Legăturile nu duc în afara montării. Un backup sau o restaurare pe loc se oprește cu un mesaj când o legătură de deasupra căii lui duce în afara montării gazdei, pentru că un container care scrie în propriul share ar putea pune una acolo. O destinație a cărei gazdă sau remote rclone începe cu o cratimă este refuzată la fel, la salvare și la următoarea rulare, pentru că
sshsaurclonear citi-o ca opțiune.
Server MCP¶
Serverul MCP nu are nevoie de nicio variabilă de mediu. Îl pornești creând o cheie în Setări, Integrări, Server MCP, iar el răspunde la /mcp pe același port ca interfața web (de exemplu https://192.168.1.10:3443/mcp). Fără o cheie activă, calea răspunde 404. Clienții, certificatele și limitele sunt descrise în Server MCP.
Backup VM prin SSH¶
BombVault face backup VM-urilor KVM/libvirt fără a monta vreo cale libvirt. Rulează virsh pe gazdă prin SSH (qemu+ssh://), deci nu poate afecta niciodată VM Manager-ul gazdei tale.
Montarea socketului libvirt al gazdei într-un container este fragilă pe Unraid: acele căi aparțin VM Manager-ului, iar comutarea „Enable VMs” poate lăsa libvirt fără să mai poată porni. Cheia SSH dă acces root la gazdă, același nivel de încredere ca socketul Docker pe care BombVault îl folosește deja.
Configurare rapidă:
- Setări, Integrări, SSH al gazdei: copiază cheia publică afișată.
- Adaug-o la
/root/.ssh/authorized_keysal Unraid (persistată de asemenea în flash, ca să supraviețuiască repornirilor). - Apasă Testează conexiunea.
Șablonul adaugă --add-host=host.docker.internal:host-gateway, astfel încât containerul să poată ajunge la gazdă. Setează LIBVIRT_HOST la IP-ul LAN al Unraid dacă acel nume nu se rezolvă (de exemplu când containerul rulează pe o rețea br0.x personalizată). Dacă ai schimbat portul SSH al Unraid, setează LIBVIRT_SSH_PORT să corespundă. Instantaneele live au nevoie suplimentar de qemu guest agent în VM și de discul pe /mnt/cache (nu /mnt/user).
Ghid complet de configurare și rețea pentru VM
Ghidul complet pas cu pas (activarea SSH, autorizarea persistentă a cheii, rutarea în rețea personalizată și VLAN, metoda per VM și depanarea pe partea de gazdă) este ghidul de backup VM.
Configurare off-site¶
Copiile off-site merg la destinații. Deschide Destinații din placa ei de setări (sau fixează-o în bara laterală) și alege Adaugă destinația. Vezi Off-site și recuperare pentru fluxul complet (protecția la ștergere, testarea manipulării și exercițiile DR). Pe scurt:
- Backenduri: SMB/CIFS și WebDAV prin rclone fără montare pe gazdă, NFS (montează exportul pe gazdă și folosește-l ca folder local), backenduri restic native fără rclone (
s3:...,rest:http://host:8000/repo,sftp:user@host:/repo) sau orice remote rclone (rclone:<remote>:<bucket>/path). Backblaze B2 nu are aici un backend nativ: se accesează prin punctul său final S3 (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>), cu ID-ul cheii și cheia aplicației ca acreditări S3. - Autentificările sunt stocate criptat, ca o singură listă de autentificări salvate în cardul Autentificări de la Setări, Destinații. O stea marchează valoarea implicită, folosită oriunde nu este aleasă nicio autentificare. Pagina proprie a unei destinații o alege pe cea pe care o folosește, în cardul ei Credențiale. Vezi Autentificări.
- Destinațiile SSH nu necesită nimic instalat pe partea îndepărtată.
sftp:necesită doar un server SSH. Adaugă cheia publică din Setări, Integrări, SSH al gazdei (de asemenea la/config/ssh/id_ed25519.pub) la~/.ssh/authorized_keysal utilizatorului țintă, sau lasă Adaugă cheia din Adaugă destinația să o pună acolo cu parola contului. - rest-server cu certificat auto-semnat: pune certificatul lui, sau pe cel al autorității care l-a semnat, ca fișier PEM în folderul
certsdin folderul de date al BombVault (/config/certsîn container,appdata/bombvault/certspe Unraid). Backupurile, copiile și testul protecției la ștergere au încredere în el fără repornire. - Copie off-site: BombVault copiază instantaneele noi cu
restic copype bază de best-effort, pe lângă un depozit primar (de obicei local). Cardul Copiază al unei destinații stabilește dacă copiază După fiecare copie de rezervă sau după un plan propriu, iar Setări, Programare, Copii externe pe secțiuni dă unei secțiuni un plan propriu de copiere. Replică acum se află pe rândul secțiunii din cardul Copii externe de la Setări, Destinații. - Mai multe destinații pe secțiune: cardul Destinații pe secțiuni de pe pagina Destinații pornește sau oprește fiecare linie de la o secțiune la o destinație cu un clic, Local inclus. O secțiune cu doar destinații off-site face backup direct în ele, iar una cu toate liniile oprite nu este salvată. Reguli pe secțiuni ale unei destinații dau unei secțiuni propriul depozit, propria retenție sau propria compresie acolo.
- Amplasare per element: fiecare container, VM și set de foldere aprinde Local și destinațiile care îi primesc backupurile, în cardul Programare și destinație din fila Setări a elementului. Elementele fără alegere proprie urmează secțiunea lor. Vezi Amplasare per element.
- Retenție: fiecare destinație păstrează backupurile după cardul ei Cât timp se păstrează, iar o secțiune își poate păstra acolo propriile valori la Reguli pe secțiuni. Asta include copia din câmpul off-site al unei secțiuni. Dacă lași totul pe zero, instantaneele unei destinații nu sunt tăiate niciodată.
- Limite de lățime de bandă: limitează rata de încărcare și descărcare restic în cardul Lățime de bandă externă de la Setări, Destinații, sau per destinație în cardul ei Copiază. Introduci KiB/s, iar câmpul arată aceeași rată în MB/s și Mbit/s.
- Întâi streamingul: în cardul Streaming de pe pagina Destinații, alegi serverele media (Plex, Jellyfin și Emby sunt preselectate după numele imaginii), rata de trimitere de la care unul contează ca făcând streaming, limita de încărcare în timpul streamingului și după cât timp de la un stream revine limita normală.
- Clasă de stocare la rece și de arhivă (S3): pentru o destinație S3, alege pe pagina ei un nivel care permite restaurarea (Standard, Standard-IA, One Zone-IA, Intelligent-Tiering, Glacier Instant Retrieval). Remote-urile rclone își setează clasa în configurația rclone.
- Dosar propriu într-o destinație în loc de local: dosarul propriu al unei secțiuni poate trăi într-una dintre destinațiile de mai sus, fără copie locală și fără pas de copiere. Vezi Folderul propriu al unei secțiuni.
Anomalii¶
Detectarea anomaliilor nu are nevoie de nicio variabilă de mediu. Se configurează în cardul Anomalii de la Setări, Verificare, descris la Anomalii.
Setări portabile (export și import)¶
Cardul Exportă / importă setările de la Setări, Sistem scrie întreaga ta configurație BombVault (setări de secțiune, destinații, programări, retenție, notificări) într-un fișier JSON portabil pe care îl poți importa pe o altă instanță, astfel încât mutarea pe o stație nouă sau clonarea unei configurații să nu însemne reintroducerea totul manual. Importul arată o previzualizare și cere confirmare și nu îți atinge niciodată datele sau istoricul de backup. Legăturile din fișier către destinații sau depozite care nu mai există sunt omise, iar previzualizarea le numește. Cât rulează o replică ZFS, un import este refuzat înainte să se scrie ceva.
Exportul poate conține credențiale
Alegi dacă incluzi în fișier credențialele off-site, de notificare și ale brokerului MQTT. Cu credențialele incluse, exportul este la fel de sensibil ca kitul tău de recuperare, deci păstrează-l undeva în siguranță. Fără ele, fișierul conține doar setări nesecrete.
APP_KEY nu călătorește cu fișierul
Depozitele sunt încuiate cu o parolă derivată din APP_KEY, iar fișierul nu o conține. Pentru o mutare plănuită, dă stației noi vechiul APP_KEY în șablonul ei sau preia cheia cu kitul de recuperare de la Urgență. Sub altă cheie, depozitele răspund cu parolă greșită. Nu se pierde nimic, iar setarea cheii corecte le deschide din nou.