Gå til indholdet

Konfiguration

Denne side dækker containerens miljøvariabler, de monteringer, skabelonen leverer, sikkerhedsmodellen, VM-sikkerhedskopiering over SSH og off-site-opsætningen. Hvor sikkerhedskopierne havner, sættes op inde i appen som destinationer, ikke via miljøvariabler.

Miljøvariabler

Variabel Påkrævet Beskrivelse
APP_KEY Ja 32-byte hex-hemmelighed (64 hex-tegn), der bruges til at udlede restic-repoets adgangskode. Generer med openssl rand -hex 32. Hold den sikker: mister du den, kan krypterede sikkerhedskopier ikke gendannes.
LIBVIRT_HOST Til VM'er Unraid-vært nået over SSH til VM-sikkerhedskopiering (default host.docker.internal. Skabelonen forudfylder en LAN-IP-pladsholder). Brug din Unraid LAN-IP, påkrævet på et brugerdefineret br0.x-netværk. Bruges også til sikkerhedskopi af ZFS-datasæt (skabelonfelt Host SSH: Address). Pladsholderen 192.168.x.x regnes som ikke sat. Når host.docker.internal ikke kan slås op, som i en TrueNAS-app, og LIBVIRT_URI heller ikke angiver en vært, bruger BombVault containerens standardgateway, og opstartsloggen nævner den.
LIBVIRT_SSH_PORT Nej Værts-SSH-port til VM-sikkerhedskopiering (default 22). Skabelonfelt Host SSH: Port, også til ZFS-datasæt.
LIBVIRT_SSH_USER Nej SSH-bruger på værten til VM-sikkerhedskopiering (default root). Skabelonfelt Host SSH: User, også til ZFS-datasæt.
LIBVIRT_URI Nej Fuld libvirt-forbindelses-URI, brugt ordret i stedet for at bygge en ud fra de tre LIBVIRT_*-variabler ovenfor (som så ignoreres for forbindelsesstrengen). Default usat. Nødvendig på TrueNAS Scale, hvis libvirtd lytter på en ikke-standard socket, som den byggede streng-form ikke kan udtrykke: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. Se VM-guiden. Er det en qemu+ssh://-URI, hentes hver af LIBVIRT_HOST, LIBVIRT_SSH_USER og LIBVIRT_SSH_PORT, der ikke er sat, fra den, også til BombVaults egne SSH-kommandoer (NVRAM-overførsel, ZFS-datasæt).
PORT Nej HTTP-port (default 3000. Kun brugt med HTTP_ONLY=true).
HTTPS_PORT Nej HTTPS-port (default 3443. Skabelonen publicerer den 1:1, så WebUI'en svarer på https://<ip>:3443).
HTTP_ONLY Nej Sæt true for at deaktivere den selvsignerede HTTPS-lytter og kun servere almindelig HTTP (til brug bag en TLS-terminerende reverse proxy).
BIND_HOST Nej Adressen, WebUI'en lytter på (default 0.0.0.0, alle interfaces). Lad den være usat i containeren, hvis publicerede porte kræver alle interfaces. 127.0.0.1 passer til en kørsel uden for Docker. Healthchecket spørger på samme adresse.
TRUSTED_PROXY Nej Kommaseparerede adresser eller CIDR-intervaller for den reverse proxy foran BombVault (for eksempel 192.168.20.11 eller 10.0.0.0/8). Kun fra disse hop tros X-Forwarded-For, og login-bremsen tæller så fejl pr. rigtig klient i stedet for at samle alle bag proxyen i én pulje. Ikke sat (standard) betyder, at ingen tros: en betingelsesløst troet header ville lade enhver kalder vælge sin egen pulje.
HOST_SOURCE_ROOT Nej Værtsstien monteret som Host Data (default /mnt). BombVault oversætter de bind-mount-kilder, Docker rapporterer, til stier under denne montering. Skift kun, hvis du monterede en anden værtsrod.
HOST_MOUNT_ROOT Nej Hvor Host Data er monteret inde i containeren (default /host/user). På TrueNAS monteres Host Data på sin egen værtssti, så denne variabel og HOST_SOURCE_ROOT angiver begge den sti, for eksempel /mnt/tank (se TrueNAS SCALE).
DATA_ROOT_SEGMENTS Nej Kommaseparerede sti-segmentnavne, der markerer en bind-mount-kilde som sikkerhedskopidata (default appdata, svarende til Unraids /mnt/user/appdata/<container>-konvention). En containers bind-mount auto-vælges til sikkerhedskopiering, når ETHVERT angivet segment optræder som et helt sti-segment i dens værtskilde, for eksempel vælger DATA_ROOT_SEGMENTS=appdata,config også en .../config-bind. Se Registrering af sikkerhedskopikilder for de andre, altid aktive måder, en containers datamappe findes på.
PLATFORM Nej Tvinger hvilken platform BombVault opfatter sig selv som kørende på, i stedet for at auto-detektere det: unraid, generic eller truenas (default usat: auto-detekterer Unraid ved at probe efter dens dockerMan-markør under flash-monteringen, ellers generic. En ukendt værdi falder også tilbage til generic, logget). Sæt den eksplicit på en generisk Docker-vært eller TrueNAS Scale i stedet for at stole på auto-proben, der kun virker på Unraid: den generiske compose-fil gør netop det. Ændrer appdata-fallback-konventionen, standardværdierne for gendannelsesdestination på tværs af instanser, og om notifikations-/ledsager-plugin-trinnene, der kun findes på Unraid, overhovedet forsøges (se internal/platform).
BOMBVAULT_SELF_CONTAINER Nej Navnet på selve BombVault-containeren, så den aldrig sikkerhedskopierer (og dermed stopper) sig selv.
BACKUP_MAX_HOURS Nej Maksimalt antal vægur-timer, en enkelt sikkerhedskopikørsel må holde låsen på sit område, før den tvangsannulleres (en beskyttelse, så en fastlåst kørsel ikke kan blokere området for evigt). Tom (default) bruger 48. Hæv den til meget store eller langsomme cloud-sikkerhedskopier (en kørsel annulleret ved grænsen fejler med context deadline exceeded). Sæt 0 for at deaktivere grænsen helt. En prune holdes til samme grænse, og en kontrol eller prune kører, så længe restic bliver ved med at melde fremskridt.
BACKUP_STALL_HOURS Nej Timer, en sikkerhedskopi må gå helt uden fremdrift, før den annulleres. Tom (default) bruger 2. Sæt 0 for aldrig at annullere ved stilstand. Det er den finere af de to beskyttelser og som regel den, der slår til: den holder øje med, om der stadig sker noget, ikke med hvor længe kørslen har varet, så en langsom men sund sikkerhedskopi på flere terabyte får lov at køre, mens en, der hænger på en share, som ikke svarer, stoppes efter timer i stedet for dage. Der logges en advarsel efter 30 minutters stilhed, før noget annulleres. Scanning tæller som fremdrift: restic skriver ingen bytes, mens det gennemløber et stort træ, og den fase overvåges via fil- og bytetotalerne frem for via de skrevne bytes. De to variabler er uafhængige, og BACKUP_MAX_HOURS begrænser stadig faserne efter selve sikkerhedskopien (opbevaring, statistik, off-site-kopi), hvor der ikke er nogen tællere at holde øje med.
DB_DUMP_MAX_HOURS Nej Timer et enkelt automatisk databasedump må køre, før det stoppes. Tomt (standard) bruger 6. Tilladte værdier er 1 til 48, og grænsen holdes en time under BACKUP_MAX_HOURS (på halvdelen af den, når den er under to timer), så et langt dump afbrydes af sin egen grænse og rapporteres som sådan i stedet for at trække sikkerhedskopien med sig. Et dump, der ikke kommer videre, stoppes tidligere, efter BACKUP_STALL_HOURS. Et stoppet dump fejler for sig selv, og containerens sikkerhedskopi fortsætter. På Unraid tilføjer du variablen til BombVault-containeren med Add another Path, Port, Variable.
TZ Nej Tidszone for planlæggeren (for eksempel Europe/Berlin). Hvis den ikke sættes, kører alle planer i UTC: en plan sat til 02:30 starter da 02:30 UTC og ikke efter lokal tid. På Unraid indstiller du aldrig dette selv: systemet sender sin egen tidszone videre til hver container. Opstartsloggen viser, hvilken zone der blev fundet. En zone med sommertid springer én kørsel over om foråret og kører én to gange om efteråret, mens UTC ikke gør nogen af delene, men til gengæld forskubber sig en time i forhold til dit ur to gange om året.
DATA_DIR Nej Hvor BombVault gemmer sin database, sine nøgler og caches (default /config). Lad den være i containeren. Den har betydning, når du kører binærfilen uden for Docker.
FLASH_DIR, FLASH_TEMPLATES_DIR Nej Hvor flashdrevet og dets Docker-skabeloner er monteret inde i containeren (default /host/boot og /host/boot/config/plugins/dockerMan/templates-user). De følger skabelonens /boot-montering, så lad dem være usat.
MODE Nej full (standard) kører hele appen. node kører en node: ingen brugerflade og ingen egne tidsplaner, kun det, dens hjemmeinstans fortæller den. Enhver anden værdi stopper starten med en besked. Hjemmeinstansen udfylder den for dig i nodens compose-fil.
NODE_HOME På en node Hvilken hjemmeinstans noden hører til, med hjemmeinstansens nøgle og videresender, som én værdi, der begynder med bvhome1.. Hjemmeinstansen skriver den i nodens compose-fil. Uden den starter noden, men ingen hjemmeinstans når den. En node, som en hjemmeinstans har taget til sig, nægter at starte, når NODE_HOME nævner en anden, indtil den første frigiver den.
NODE_NAME Nej Nodens navn, som hjemmeinstansen udfyldte det ud fra det navn, du gav den.

Monteringer

Montér Docker-socket'en, flashen (/boot) og Host Data-roden (/mnt) som vist i CA-skabelonen. Både kilder og destinationer for sikkerhedskopier lever under Host Data, og den er monteret slave, så en remote share, der monteres, efter containeren er startet (for eksempel under /mnt/remotes), bliver synlig uden en genstart.

På TrueNAS er Host Data en datasætsti som /mnt/tank, aldrig et ixVolume. Data, som en app gemmer i et ixVolume, ligger uden for den og sikkerhedskopieres ikke. Se TrueNAS SCALE.

Sikkerhedskopi af ZFS-datasæt kræver også denne tilstand: værten monterer et datasæts snapshot først, efter at containeren er startet. Se ZFS-datasæt.

Lokale repositories har som standard /mnt/user/bombvault/{container,vms,flash,config,files,zfs} og oprettes ved den første sikkerhedskopi. De er områdernes egne mapper og udgør destinationen Lokal. På dens side under Destinationer ændrer kortet Forbindelse mappen for hvert område.

Et områdes egen mappe kan også ligge på en destination, du allerede har, for eksempel en NAS eller en S3-bucket: Brug som egen mappe på den destinations side flytter den derhen og siger først, hvad der sker med de sikkerhedskopier, der allerede er lavet. Se Et områdes egen mappe.

De lokale repositorymapper bliver på tilladelserne 0755 og 0644, så en bruger uden root over SMB ikke bliver låst ude, og repositories er krypterede, så det afslører intet. Gendannelsesdefinitioner ligger inde i hvert repository, så en kopieret mappe er komplet i sig selv. Repositoryet til auto-sikkerhedskopien kan kun læses af root.

Vært-integrationstjek

Kortet Vært-integration på oversigten (tilføj det under Tilpas) prober hver montering og hvert CLI (Docker-socket, libvirt, restic, qemu-img, rclone) og rapporterer eventuelle manglende dele.

Genkendelse af sikkerhedskopiernes kilder

For hver container vælger BombVault selv, hvilke bind-mounts og navngivne volumener der skal sikkerhedskopieres. En sti medtages, når noget af følgende gælder (du kan altid ændre resultatet i kortet Sikkerhedskopierede mapper under containerens fane Indstillinger):

  • Match på et datarod-segment: bindets værtskilde indeholder et af segmenterne i DATA_ROOT_SEGMENTS som en hel stikomponent (som standard kun appdata).
  • Navngivne Docker-diskenheder tages altid med, fordi de ikke har nogen engangsudgave, og der derfor ikke er noget at filtrere fra, men kun når diskenhedens rigtige lagersti på værten selv kan nås gennem Host Data-monteringen, nøjagtig som enhver anden værtssti, BombVault sikkerhedskopierer. Standarddriveren til lokale diskenheder lægger en diskenhed under dæmonens egen datarod, altså /var/lib/docker/volumes/<navn>/_data, medmindre det er ændret (tjek med docker info -f '{{.DockerRootDir}}'). Det sted er IKKE dækket af den smalle Host Data-montering med én enkelt mappe, som den generiske docker-compose.yml bruger som standard. En diskenhed, der ikke kan nås, springes stiltiende over, det er ikke en fejl. For rent faktisk at sikkerhedskopiere navngivne diskenheder på en generisk vært skal du pege Host Data (og HOST_SOURCE_ROOT) på en fælles overordnet mappe, der også dækker Dockers datarod: afvejningen står i Host Data-kommentaren i compose-filen (Unraid går uden om det ved af samme grund at montere hele /mnt, sin egen almengyldige konvention på øverste niveau).
  • Projektmappe for Docker Compose: bærer containeren den sædvanlige etiket com.docker.compose.project.working_dir (sættes automatisk af docker compose up), kommer den mappe også med, uanset om en bind ramte et datarod-segment.
  • Tilsidesættelse med etiketten bombvault.data: sæt etiketten bombvault.data=true på en container for at tage ALLE dens bind-monteringer med, til en opsætning som ingen af de to konventioner ovenfor fanger (for eksempel en enkelt bind /srv/plex/config uden Compose-projekt). Enhver ikke-tom værdi ud over false tæller som sand. En manglende etiket eller bombvault.data=false ændrer ingenting.
  • Labelen bombvault.dbdump: sæt bombvault.dbdump=false på en container for at slå dens automatiske databasedump fra (0, no og off gør det samme), eller angiv motoren (postgres, mysql, mariadb) for at dumpe en container, BombVault ikke selv genkender. Labelen vinder over kontakten i kortet Database under containerens fane Indstillinger, som er måden at gøre det på i Unraid.

Sikkerhedsmodel

Root-ækvivalent kontrol over værten

Gennem Docker-socket'en kan BombVault stoppe, fjerne og genoprette containere og læse/skrive appdata, og til VM-sikkerhedskopiering logger den ind på værten over SSH (qemu+ssh://, root som standard) for at køre virsh. Enhver, der kan nå dens web-UI, har reelt root på værten.

Login

  • Valgfri adgangskodebeskyttelse (kortet Adgangskode under Indstillinger, Sikkerhed): angiv en adgangskode for at kræve login, ryd den for at slå det fra. Slået fra som standard til brug på et betroet LAN. Adgangskoden gemmes med Argon2id over en APP_KEY-nøglet pepper, så en kopieret /config er værdiløs uden nøglen og langsom at angribe med den. En ny adgangskode skal have mindst 12 tegn. En eksisterende kortere virker, indtil den ændres. Sessioner er signeret (HMAC udledt af APP_KEY), og en ændring af adgangskoden gør dem ugyldige. Logins er begrænset til fem fejl i minuttet pr. klient. Når du ændrer eller rydder adgangskoden, beder BombVault om Nuværende adgangskode og, med tofaktorgodkendelse slået til, koden.
  • Nogle ting kræver en adgangskode. Download af gendannelseskittet, fejlrapporten og ZIP'en med en flash-sikkerhedskopi, eksport af en flash-sikkerhedskopi eller auto-sikkerhedskopi, deponering af nøglen hos en nøgleholder, tilladelse til at udlevere en deponering, oprettelse af en ny frigivelseskode, eksport af indstillinger med legitimationsoplysninger, tofaktorgodkendelse, passkeys, tilføjelse af en node, visning af en nodes compose-fil igen og åbning af en nodes poster afvises, indtil der er angivet en login-adgangskode, og de kræver en login på selve instansen. Sletning af sikkerhedskopier virker uden en adgangskode. Er der angivet en, kræver det også det login.
  • En destination viser ingen adgangskode. En destination kan indeholde adgangsoplysninger, som i rest:https://user:password@host/repo, og hver side og hvert API-svar viser den som rest:https://[redacted]@host/repo, med eller uden login-adgangskode. Ændrer du stien bag den, bliver den gemte adgangskode. Vil du pege destinationen mod en anden server, så skriv hele destinationen med dens adgangskode, fordi en skjult adgangskode bliver hos sin server.
  • Tofaktorgodkendelse (Indstillinger, Sikkerhed): en tidskode fra en autentificeringsapp oven i adgangskoden, plus otte engangs-gendannelseskoder, der udleveres én gang, når den slås til. Den delte hemmelighed gemmes krypteret med APP_KEY, og at slå faktoren fra igen kræver en aktuel kode.
  • Adgangsnøgler (WebAuthn) har deres eget kort, når en adgangskode er sat. De bruges sammen med adgangskoden og aldrig i stedet for den, så den, der fjerner alle adgangsnøgler, låser ingen ude. De kræver et rigtigt domænenavn og et certifikat, som browseren stoler på. Standardadressen https://<ip>:3443 er netop det, WebAuthn afviser, og kortet siger det i stedet for at tilbyde en knap, der fejler. Med tofaktorgodkendelse slået til skal en adgangsnøgle kontrollere din pinkode, dit fingeraftryk eller dit ansigt, ellers beder login også om koden.
  • En gendannelse af konfigurationen (Hent indstillinger tilbage i Nødguiden) afslutter alle sessioner, fjerner alle adgangsnøgler og tilbagekalder alle API-tokens og MCP-nøgler, fordi de gendannede indstillinger kunne bringe nogle tilbage, der blev fjernet, efter at indstillingerne blev gemt. Log ind med adgangskoden, og sæt dine adgangsnøgler op igen under Indstillinger, Sikkerhed.
  • En glemt adgangskode nulstilles på loginsiden. Glemt adgangskode? får BombVault til at skrive en kode på 12 tegn, i tre grupper af fire, i sin containerlog (på Unraid: fanen Docker, BombVault-ikonet, Logs). Den kode og en ny adgangskode logger dig ind. Nulstillingen slår også tofaktorgodkendelse fra, fjerner alle passkeys, tilbagekalder alle API-tokens, MCP-nøgler og OAuth-logins, afslutter alle andre sessioner, logger alle parrede telefoner ud og slår telefonparring fra. Siden viser bagefter, hvad der røg. En kode gælder i 10 minutter, og forkerte gæt bruger den ikke op. Widget- og metrics-tokens bliver, da de kun læser.
  • Den, der kan læse containerloggen, kan nulstille adgangskoden. Det er root på værten, men også en logviser som Dozzle, enhver container, der har fået Docker-socket'en (skrivebeskyttet er nok), og en logsender, der videresender containeroutput. Giv dem kun til folk, du ville betro adgangskoden. Den, der kun når web-UI'en, ser aldrig koden.

Telefoner og gruppemedlemmer

  • Parrede telefoner når en tilladelsesliste. En telefon, der kender gruppens tolv ord, logger ind uden adgangskoden, så længe Telefoner kan parre med gruppens tolv ord er slået til i kortet Android-app under Indstillinger, Sikkerhed. Dens session når kun det, appen viser: oversigten, kørslerne, sikkerhedskopierne til at se på, starte og gendanne, anomalierne til at læse og siden Instanser til at se på. Destinationer og kommandoer når den uden deres adresser og hemmeligheder, og en gendannelse, der erstatter originalen, tager først en sikkerhedskopi af den aktuelle tilstand. En gendannelse til en mappe tager kun en ny eller tom mappe inde i mappen til gendannelser, og en telefon kan ikke se ind i nogen anden mappe. Alt andet svarer, at det kræver en login på selve instansen: nøgler, gendannelseskittet, nøgledeponeringer, indstillinger, sletning af sikkerhedskopier. En nulstilling af adgangskoden slår telefonparring fra, indtil du slår den til igen. En telefon, der er fjernet fra siden Instanser, eller hvor Forespørg denne instans er slået fra i dens detaljer, mister straks sin session, og en fjernet telefon, der åbner sin app igen, kommer tilbage slået fra.
  • Når du er ude, åbner en telefon sider over relayet. Hver forespørgsel fra siden er forseglet med gruppens nøgle, som relayet hverken kan læse eller ændre, og signeret med telefonens egen nøgle, som serveren fastlåser ved telefonens første kald og lukker ind, så snart nogen godkender telefonen på parringssiden. Serveren udfører en forespørgsel kun én gang og kun, så længe den er frisk. Den svarer kun en telefon, der står på siden Instanser, så længe telefonparring er slået til, og kun med en session, den har givet den telefon, så udlogning overalt og nulstilling af adgangskoden også afslutter disse sider. Serveren signerer hvert svar, og appen kontrollerer signaturen mod den nøgle, den fastlåste for den server, og advarer, når nøglen skifter. Sådan en side når den samme tilladelsesliste som en parret telefon, med eller uden login-adgangskode, plus den loginstatus, siden læser først. Login og logout, nulstilling af adgangskoden og downloads bliver på serverens egen adresse, og et svar er begrænset til 16 MB.
  • Medlemmer signerer det, de beder om. Rolleanmodninger og svarene på dem, destinationstilbud, udleveringen af en restic-adgangskode til en modtager eller henter, modtagerlogins og nøgledeponeringer signeres med en nøgle fra hvert medlem, som en instans fastlåser første gang, den ser medlemmet. Et kald signeret med en anden nøgle afvises. Glem nøglen i en instans' detaljer dropper den fastlåste nøgle, hvis den, der kendes her, ikke er medlemmets egen. Medlemmet bliver bedt om sin nøgle igen ved næste signerede kald. Medlemmer på BombVault 9.x signerer ikke og kan efterlignes af enhver med ordene, som i 9.9. En rolleanmodning eller et destinationstilbud fra et medlem på 10.4 eller ældre afvises, indtil medlemmet er opdateret.
  • De tolv ord er en adgangskode. Den, der har dem, kommer ind i gruppen, ser medlemmernes beskyttelsesstatus og kan bede om roller, som en person på den anden instans stadig skal tillade. Uden en login-adgangskode kan enhver, der kan åbne web-UI'en, læse dem, og parringskortet siger det, indtil der er angivet en adgangskode.

Nøgler

  • APP_KEY gør to ting. Den forsegler det, denne installation gemmer (adgangskoder, logins, tokens), og den er sikkerhedskopiernes nøgle: restic-adgangskoden udledes af den, og container- og VM-definitioner forsegles med den.
  • En overtaget nøgle holdes for sig. Når Nødguiden overtager en anden servers sikkerhedskopier, forsegler denne installation fortsat med sin egen APP_KEY og gemmer den anden servers nøgle som sin sikkerhedskopinøgle, forseglet som enhver anden hemmelighed. Gendannelseskittet udskriver så begge. Hvis APP_KEY ændres bagefter, kan sikkerhedskopinøglen ikke længere åbnes: BombVault holder op med at tage sikkerhedskopier og siger det under Kræver opmærksomhed, i stedet for at skrive med den forkerte nøgle. Upload gendannelseskittet igen under Gendannelse, Nødsituation, eller sæt APP_KEY tilbage. Se Nødguide.
  • Kryptering er slået til som standard (Kryptér sikkerhedskopier i kortet Kryptering under Indstillinger, Sikkerhed). Sikkerhedskopier krypteres af restic med adgangskoden udledt af sikkerhedskopinøglen.
  • Nøgledeponeringer. En nøgleholder i din gruppe har en forseglet kopi af denne servers gendannelseskit, som den ikke selv kan åbne. Kun frigivelseskoden på 20 tegn åbner den, og holderen udleverer den først, når nogen dér trykker på Tillad. Se Nøgleholder.

Noder

En node er en BombVault uden brugerflade, der tager imod ordrer fra en hjemmeinstans.

  • Hjemmeinstansen styrer noden. En node monterer sin servers Docker-socket, hvilket er root dér, og hjemmeinstansen styrer noden. Bliver hjemmeinstansen overtaget, styrer angriberen også alle dens noder. Giv hjemmeinstansen en login-adgangskode, og hold dens brugerflade væk fra internettet.
  • En node har ikke meget at hente. Bliver en node overtaget, får angriberen ingen parringsgruppe, ingen fæstning, ingen anden node og intet andet repository. Noden har kun en forbindelse til sin hjemmeinstans, sit eget login på modtageserveren og sin egen mappe på en destination. På modtageserveren kan den ikke slette historik, fordi serveren er append-only. Den kan fylde serverens disk, fordi rest-server ikke sætter nogen kvote, så giv modtageserveren plads eller sin egen share. På en destination kan dens adgangsoplysninger som regel slette det, der ligger dér. Sikkerhedskopier, der bliver på noden, er i angriberens hænder, og derfor henter hjemmeinstansen en kopi af dem.
  • Forbindelsen er privat og signeret. Hjemmeinstansen og noden taler sammen gennem videresenderen over deres egen forbindelse, forseglet med en hemmelighed, der er afledt af nodens APP_KEY. Hver side kender den andens nøgle før det første kald, så der er intet godkendelsestrin. Hjemmeinstansen signerer hvert kald med sin egen nøgle og en tæller, og noden afviser et kald, der ikke er signeret af hjemmeinstansen, eller som den allerede har modtaget. Noden kalder intet på hjemmeinstansen ud over sit goddag.
  • Hjemmeinstansen når en fast liste. Forespørgsler, som hjemmeinstansen sender videre til en node, kører kun på en fast liste over nodens ruter, som står under GET /api/nodes/routes, og noden svarer kun med JSON. Intet på listen sletter noget eller når indstillingerne, lagringen, nøglerne, gruppen eller tokens. På hjemmeinstansen kræver de et login med adgangskoden: parrede telefoner, API-tokens og MCP-nøgler når ingen node. Sikkerhedskopieringer og gendannelser, der startes på den måde, vises som startet af hjemmeinstansen.
  • Nøgledeponeringer indeholder nodenøgler. Hjemmeinstansen beholder hver nodes APP_KEY, og gendannelseskittet skriver den i sit kapitel Nodes, så en nøgledeponering indeholder den også. En nøgleholder, der får deponeringen og frigivelseskoden, kan åbne dine noders repositories, men kan ikke give nogen node ordrer, fordi det kræver hjemmeinstansens signatur.
  • Frigivelse er endelig. En frigivet node tager ikke imod nogen hjemmeinstans igen med samme APP_KEY. En node, der er væk, når du frigiver den, hører det fra hjemmeinstansen, så snart den er tilbage.

Netværk

  • Ændringer kræver JSON. En forespørgsel, der ændrer noget, skal sende Content-Type: application/json og må ikke være markeret som cross-site af browseren, så en side på et andet websted ikke kan få din browser til at ændre indstillinger på en LAN-adresse. Et script, der styrer API'en, sender den header. Alt andet afvises med 415.
  • Fordi porten er valgfri, er hele UI'en og API'et (inklusive destinationerne, tamper-test-ruterne og gendannelsesruterne) tilgængeligt for enhver, der kan nå porten, når den ikke er sat. Angiv en login-adgangskode, når off-site, append-only-sikkerhedskopier eller kryptering er i brug.
  • Kør kun BombVault på et betroet, ikke-eksponeret netværk. For fjernadgang, sæt den bag en reverse proxy, der tilføjer autentificering og TLS. Svar bærer grundlæggende sikkerhedsheaders (CSP, nosniff, X-Frame-Options, Referrer-Policy).
  • Bag en reverse proxy bærer hver forespørgsel proxyens adresse, så uden TRUSTED_PROXY tæller login-bremsen alle klienter i én pulje, og en angribers fejl låser også dig ude. Angiv proxyen i TRUSTED_PROXY for at få optælling pr. klient tilbage.
  • En reverse proxy foran BombVault skal sende headeren Authorization eller X-API-Key videre til /mcp og må ikke buffere svarene, ellers kan assistenter ikke oprette forbindelse. Se MCP-server.
  • MCP-endepunktet /mcp svarer 404, indtil der findes en nøgle, eller login via OAuth er slået til, og det beder hver klient om dens nøgle eller token, også når login-adgangskoden er slået fra. Ingen adresse er undtaget, heller ikke localhost. Det har ingen værktøjer til at gendanne eller slette, og gendannelse af en konfigurationssikkerhedskopi tilbagekalder alle nøgler. Se MCP-server.
  • Med HTTP_ONLY=true mister session-cookien sit Secure-flag (det er nødvendigt for at virke over almindelig HTTP), så aktivér kun adgangskoden bag en TLS-terminerende proxy, hvis fortrolighed betyder noget.
  • VM-sikkerhedskopiets SSH-forbindelse stoler på værtsnøglen ved første forbindelse (TOFU) og pinner den derefter. Verificér værtens nøgle out-of-band, hvis din container-til-vært-sti ikke er betroet.
  • Links fører ikke ud af mountet. En sikkerhedskopiering eller en gendannelse på stedet stopper med en besked, når et link over dens sti fører ud af værtens mount, fordi en container, der skriver i sin egen share, kunne plante et. En destination, hvis vært eller rclone-remote begynder med en bindestreg, afvises på samme måde, ved gemning og ved næste kørsel, fordi ssh eller rclone ville læse den som en option.

MCP-server

MCP-serveren kræver ingen miljøvariabel. Du slår den til ved at oprette en nøgle under Indstillinger, Integrationer, MCP-server, og den svarer på /mcp på samme port som webgrænsefladen (for eksempel https://192.168.1.10:3443/mcp). Uden en aktiv nøgle svarer den sti med 404. Klienter, certifikater og grænser er beskrevet på MCP-server.

VM-sikkerhedskopiering over SSH

BombVault sikkerhedskopierer KVM/libvirt-VM'er uden at montere nogen libvirt-sti. Den kører virsh på værten over SSH (qemu+ssh://), så den aldrig kan påvirke din værts-VM Manager.

At montere værtens libvirt-socket i en container er skrøbeligt på Unraid: VM Manager ejer de stier, og at slå "Enable VMs" om kan efterlade libvirt i en tilstand, hvor den ikke kan starte. SSH-nøglen giver root på værten, samme tillidsniveau som den Docker-socket, BombVault allerede bruger.

Hurtig opsætning:

  1. Indstillinger, Integrationer, Værts-SSH: kopiér den viste offentlige nøgle.
  2. Tilføj den til Unraids /root/.ssh/authorized_keys (også persisteret til flashen, så den overlever genstarter).
  3. Klik på Test forbindelse.

Skabelonen tilføjer --add-host=host.docker.internal:host-gateway, så containeren kan nå værten. Sæt LIBVIRT_HOST til din Unraid LAN-IP, hvis det navn ikke resolverer (for eksempel når containeren kører på et brugerdefineret br0.x-netværk). Hvis du ændrede Unraids SSH-port, så sæt LIBVIRT_SSH_PORT til at matche. Live-snapshots kræver derudover qemu guest agent i VM'en og disken på /mnt/cache (ikke /mnt/user).

Fuld VM-opsætning og netværksguide

Den komplette trin-for-trin-guide (SSH-aktivering, persistent nøgleautorisering, brugerdefineret-netværks- og VLAN-routing, metode pr. VM og fejlfinding på værtssiden) er VM-guiden.

Off-site-opsætning

Off-site-kopier går til destinationer. Åbn Destinationer fra dens indstillingsfelt (eller fæst den til sidepanelet) og vælg Tilføj destination. Se Off-site og gendannelse for det fulde forløb (sletningsbeskyttelse, tamper-test og DR-øvelser). Kort fortalt:

  • Backends: SMB/CIFS og WebDAV gennem rclone uden en værtsmontering, NFS (monter eksporten på værten og brug den som en lokal mappe), native restic-backends uden rclone (s3:..., rest:http://host:8000/repo, sftp:user@host:/repo) eller en hvilken som helst rclone-remote (rclone:<remote>:<bucket>/path). Backblaze B2 har ingen native backend her: nå det gennem dets S3-endpoint (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>) med nøgle-ID og applikationsnøgle som S3-legitimationsoplysninger.
  • Adgangsoplysninger gemmes krypteret som én liste af gemte adgangsoplysninger i kortet Adgangsoplysninger under Indstillinger, Destinationer. En stjerne markerer standarden, som bruges, hvor ingen adgangsoplysninger er valgt. En destinations egen side vælger dem, den bruger, i sit kort Legitimationsoplysninger. Se Adgangsoplysninger.
  • SSH-destinationer kræver intet installeret på den anden side. sftp: kræver kun en SSH-server. Tilføj den offentlige nøgle fra Indstillinger, Integrationer, Værts-SSH (også på /config/ssh/id_ed25519.pub) til destinationsbrugerens ~/.ssh/authorized_keys, eller lad Tilføj nøgle i Tilføj destination lægge den der med kontoens adgangskode.
  • rest-server med et selvsigneret certifikat: læg dets certifikat, eller certifikatet fra den udsteder, der har signeret det, som PEM-fil i mappen certs i BombVaults datamappe (/config/certs i containeren, appdata/bombvault/certs på Unraid). Sikkerhedskopier, kopier og testen af beskyttelsen mod sletning stoler på det uden genstart.
  • Off-site-kopi: BombVault kopierer nye sikkerhedskopier med restic copy efter bedste evne, oven på et (som regel lokalt) primært repository. Kortet Kopier på en destination bestemmer, om den kopierer Efter hver sikkerhedskopi eller efter en egen plan, og Indstillinger, Tidsplan, Off-site-kopier pr. område giver ét område sin egen kopiplan. Replikér nu sidder i områdets række i kortet Eksterne kopier under Indstillinger, Destinationer.
  • Flere destinationer pr. område: kortet Destinationer pr. område på siden Destinationer slår hver linje fra et område til en destination til eller fra med ét klik, også Lokal. Et område med kun off-site-destinationer sikkerhedskopierer direkte dertil, og et område, hvor alle linjer er slået fra, sikkerhedskopieres ikke. En destinations Regler pr. område giver ét område sit eget repository, sin egen opbevaring eller komprimering dér.
  • Placering pr. element: hver container, VM og hvert mappesæt lyser Lokal og de destinationer, der får dets sikkerhedskopier, op i kortet Tidsplan og destination under fanen Indstillinger. Elementer uden eget valg følger deres område. Se Placering pr. element.
  • Opbevaring: hver destination opbevarer sikkerhedskopier efter sit kort Hvor længe der gemmes, og et område kan have egne værdier dér under Regler pr. område. Kopien i et områdes off-site-felt følger reglerne i kortet Off-site-opbevaring under Indstillinger, Destinationer, som har Opbevaringsregler pr. kilde for enkelte områder (lad alt stå på nul for aldrig at trimme off-site-sikkerhedskopier automatisk).
  • Båndbreddegrænser: begræns restic-upload/download-hastigheden i kortet Off-site-båndbredde under Indstillinger, Destinationer, eller pr. destination i dens kort Kopier. Du skriver KiB/s, og feltet viser den samme hastighed i MB/s og Mbit/s.
  • Streaming først: i kortet Streaming på siden Destinationer vælger du mediaserverne (Plex, Jellyfin og Emby er forvalgt efter image-navn), den sendehastighed, hvorfra noget tæller som streaming, uploadgrænsen under streaming og hvor længe efter en stream den normale grænse vender tilbage.
  • Kold og arkivlagringsklasse (S3): for en S3-destination vælger du på dens side et lag, der kan gendannes fra (Standard, Standard-IA, One Zone-IA, Intelligent-Tiering, Glacier Instant Retrieval). rclone-remotes sætter deres klasse i rclone-konfigurationen.
  • Egen mappe på en destination i stedet for lokal: et områdes egen mappe kan ligge på en af destinationerne ovenfor, uden lokal kopi og uden kopitrin. Se Et områdes egen mappe.

Afvigelser

Afvigelsesgenkendelse kræver ingen miljøvariabel. Den sættes op i kortet Afvigelser under Indstillinger, Verificering og er beskrevet under Afvigelser.

Bærbare indstillinger (eksportér og importér)

Kortet Eksportér / importér indstillinger under Indstillinger, System skriver hele din BombVault-konfiguration (områdeindstillinger, destinationer, tidsplaner, opbevaring, notifikationer) til en bærbar JSON-fil, du kan importere på en anden instans, så en flytning til en ny boks eller kloning af en opsætning ikke betyder at indtaste alt i hånden. Importen viser en forhåndsvisning og beder om bekræftelse, og den rører aldrig dine sikkerhedskopidata eller din historik. Links i filen til destinationer eller repositories, der ikke længere findes, udelades, og forhåndsvisningen nævner dem. Mens en ZFS-replika kører, afvises en import, før noget skrives.

Eksporten kan indeholde legitimationsoplysninger

Du vælger, om off-site-, notifikations- og MQTT-broker-legitimationsoplysninger skal medtages i filen. Med legitimationsoplysninger medtaget er eksporten lige så følsom som dit gendannelseskit, så opbevar den et sikkert sted. Uden dem indeholder filen kun ikke-hemmelige indstillinger.

APP_KEY rejser ikke med filen

Repositories er låst med en adgangskode, der er udledt af APP_KEY, og filen indeholder den ikke. Ved en planlagt flytning giver du den nye boks den gamle APP_KEY i dens skabelon, eller du overtager nøglen med gendannelseskittet under Nødsituation. Under en anden nøgle svarer repositories med en forkert adgangskode. Intet går tabt, og med den rigtige nøgle åbner de igen.