Konfigurasjon¶
Denne siden dekker containerens miljøvariabler, monteringene malen tilbyr, sikkerhetsmodellen, VM-sikkerhetskopiering over SSH og oppsettet for ekstern lagring. Hvor sikkerhetskopiene havner, settes opp inne i appen som mål, ikke via miljøvariabler.
Miljøvariabler¶
| Variabel | Påkrevd | Beskrivelse |
|---|---|---|
APP_KEY |
Ja | 32-byte hex-hemmelighet (64 hex-tegn) brukt til å utlede passordet til restic-repoet. Generer med openssl rand -hex 32. Hold dette trygt: mister du det, blir krypterte sikkerhetskopier umulige å gjenopprette. |
LIBVIRT_HOST |
For VM-er og ZFS-datasett | Unraid-host nådd over SSH for sikkerhetskopiering av VM-er og ZFS-datasett (malfelt Host SSH: Address, standard host.docker.internal). Malen forhåndsutfyller plassholderen 192.168.x.x, som regnes som ikke satt. Bruk din Unraid-LAN-IP, påkrevd på et egendefinert br0.x-nettverk. Når host.docker.internal ikke kan slås opp, som i en TrueNAS-app, og LIBVIRT_URI heller ikke angir noen vert, bruker BombVault containerens standard-gateway, og oppstartsloggen nevner den. |
LIBVIRT_SSH_PORT |
Nei | Host-SSH-port for VM-sikkerhetskopiering (standard 22). Malfelt Host SSH: Port, også for ZFS-datasett. |
LIBVIRT_SSH_USER |
Nei | SSH-bruker på hosten for VM-sikkerhetskopiering (standard root). Malfelt Host SSH: User, også for ZFS-datasett. |
LIBVIRT_URI |
Nei | Full libvirt-tilkoblings-URI, brukt ordrett i stedet for å bygge en fra de tre LIBVIRT_*-variablene over (som da ignoreres for tilkoblingsstrengen). Ikke satt som standard. Nødvendig på TrueNAS Scale, der libvirtd lytter på en ikke-standard socket som den bygde strengformen ikke kan uttrykke: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. Se veiledningen for VM-sikkerhetskopiering. Er det en qemu+ssh://-URI, hentes hver av LIBVIRT_HOST, LIBVIRT_SSH_USER og LIBVIRT_SSH_PORT som ikke er satt, fra den, også for BombVaults egne SSH-kommandoer (NVRAM-overføring, ZFS-datasett). |
PORT |
Nei | HTTP-port (standard 3000. Brukes kun med HTTP_ONLY=true). |
HTTPS_PORT |
Nei | HTTPS-port (standard 3443. Malen publiserer den 1:1, så WebUI-en svarer på https://<ip>:3443). |
HTTP_ONLY |
Nei | Sett true for å deaktivere den selvsignerte HTTPS-lytteren og kun servere ren HTTP (til bruk bak en TLS-terminerende revers-proxy). |
BIND_HOST |
Nei | Adressen WebUI-en lytter på (standard 0.0.0.0, alle grensesnitt). La den stå usatt i containeren, der de publiserte portene trenger alle grensesnitt. 127.0.0.1 passer for en kjøring utenfor Docker. Helsesjekken spør på samme adresse. |
TRUSTED_PROXY |
Nei | Kommaseparerte adresser eller CIDR-områder for omvendt proxy foran BombVault (for eksempel 192.168.20.11 eller 10.0.0.0/8). Bare fra disse hoppene tros X-Forwarded-For, og påloggingsbremsen teller da feil per ekte klient i stedet for å samle alle bak proxyen i én bøtte. Ikke satt (standard) betyr at ingen tros: en betingelsesløst trodd header ville la enhver kaller velge sin egen bøtte. |
HOST_SOURCE_ROOT |
Nei | Host-stien montert som Host Data (standard /mnt). BombVault oversetter bind-monterings-kildene Docker rapporterer til stier under denne monteringen. Endre kun hvis du monterte en annen host-rot. |
HOST_MOUNT_ROOT |
Nei | Hvor Host Data er montert inne i containeren (standard /host/user). På TrueNAS monteres Host Data på sin egen host-sti, så denne variabelen og HOST_SOURCE_ROOT angir begge den stien, for eksempel /mnt/tank (se TrueNAS SCALE). |
DATA_ROOT_SEGMENTS |
Nei | Kommaseparerte sti-segmentnavn som markerer en bind-monterings-kilde som sikkerhetskopidata (standard appdata, i tråd med Unraids /mnt/user/appdata/<container>-konvensjon). En containers bind-montering velges automatisk for sikkerhetskopiering når ETHVERT oppført segment forekommer som et fullt sti-segment i host-kilden dens. DATA_ROOT_SEGMENTS=appdata,config plukker for eksempel også opp en .../config-binding. Se Oppdagelse av sikkerhetskopikilder for de andre, alltid-aktive måtene en containers datamappe blir funnet på. |
PLATFORM |
Nei | Tvinger hvilken plattform BombVault oppfatter seg selv som å kjøre på, i stedet for å auto-oppdage: unraid, generic, eller truenas (ikke satt som standard: auto-oppdager Unraid ved å sondere etter dockerMan-markøren under flash-monteringen, ellers generic. En ukjent verdi faller også tilbake til generic, logget). Sett den eksplisitt på en generisk Docker-host eller TrueNAS Scale i stedet for å stole på auto-sonderingen som er forbeholdt Unraid. Det gjør den generiske compose-filen. Endrer appdata-fallback-konvensjonen, standardene for gjenopprettingsmål på tvers av instanser, og om varslings- og følgesvenn-plugin-trinnene som er forbeholdt Unraid i det hele tatt forsøkes (se internal/platform). |
BOMBVAULT_SELF_CONTAINER |
Nei | Navnet på selve BombVault-containeren, så den aldri sikkerhetskopierer (og dermed stopper) seg selv. |
BACKUP_MAX_HOURS |
Nei | Maksimalt antall klokketimer en enkelt sikkerhetskopieringskjøring kan holde låsen på området sitt før den tvangsavbrytes (en beskyttelse så en fastkjørt kjøring ikke kan blokkere området for alltid). Tom (standard) bruker 48. Hev den for svært store eller trege sky-sikkerhetskopier (en kjøring avbrutt ved taket feiler med context deadline exceeded). Sett 0 for å deaktivere taket helt. En beskjæring holdes til det samme taket, og en kontroll eller beskjæring kjører så lenge restic fortsetter å melde fremdrift. |
BACKUP_STALL_HOURS |
Nei | Timer en sikkerhetskopiering kan gå helt uten fremdrift før den avbrytes. Tom (standard) bruker 2. Sett 0 for aldri å avbryte ved stillstand. Dette er den finere av de to beskyttelsene og som regel den som slår til: den følger med på om noe fortsatt skjer, ikke på hvor lenge kjøringen har pågått, så en treg men frisk sikkerhetskopiering på flere terabyte får være i fred, mens en som henger på en deling som ikke svarer, stoppes etter timer i stedet for dager. En advarsel logges etter 30 minutter med stillhet, før noe avbrytes. Skanning teller som fremdrift: restic skriver ingen byte mens det går gjennom et stort tre, og den fasen overvåkes via totalene for filer og byte i stedet for via skrevne byte. De to variablene er uavhengige, og BACKUP_MAX_HOURS begrenser fortsatt fasene etter selve sikkerhetskopieringen (oppbevaring, statistikk, ekstern kopi), der det ikke finnes tellere å følge med på. |
DB_DUMP_MAX_HOURS |
Nei | Timer én automatisk databasedump får kjøre før den stoppes. Tomt (standard) bruker 6. Tillatte verdier er 1 til 48, og grensen holdes en time under BACKUP_MAX_HOURS (på halvparten av den når den er under to timer), slik at en lang dump kuttes av sin egen grense og meldes som det, i stedet for å dra sikkerhetskopien med seg. En dump som ikke kommer videre, stoppes tidligere, etter BACKUP_STALL_HOURS. En stoppet dump feiler for seg selv, og sikkerhetskopien av containeren fortsetter. På Unraid legger du variabelen til BombVault-containeren med Add another Path, Port, Variable. |
TZ |
Nei | Tidssone for planleggeren (for eksempel Europe/Berlin). Hvis den ikke settes, kjører alle planer i UTC: en plan satt til 02:30 starter da 02:30 UTC og ikke etter lokal tid. På Unraid setter du aldri dette selv: systemet sender sin egen tidssone videre til hver container. Oppstartsloggen viser hvilken sone som ble funnet. En sone med sommertid hopper over én kjøring om våren og kjører én to ganger om høsten, mens UTC ikke gjør noe av det, men til gjengjeld forskyves en time mot klokken din to ganger i året. |
MODE |
Nei | full (standard) kjører hele appen. node kjører en node: ikke noe nettgrensesnitt og ingen egne tidsplaner, bare det hjemmeinstansen sier til den. Alle andre verdier stopper oppstarten med en melding. Hjemmeinstansen fyller den ut for deg i compose-filen til noden. |
NODE_HOME |
På en node | Hvilken hjemmeinstans noden hører til, med nøkkelen og relayet til hjemmeinstansen, som én verdi som begynner med bvhome1.. Hjemmeinstansen skriver den inn i compose-filen til noden. Uten den starter noden, men ingen hjemmeinstans når den. En node som en hjemmeinstans har tatt til seg, nekter å starte når NODE_HOME nevner en annen, til den første frigir den. |
NODE_NAME |
Nei | Navnet på noden, slik hjemmeinstansen fylte det ut fra navnet du ga den. |
Monteringer¶
Monter Docker-socketen, flashen (/boot) og Host Data-roten (/mnt) som vist i CA-malen. Sikkerhetskopi-kilder og -mål ligger begge under Host Data, og den er montert slave så en fjerndeling som monteres etter at containeren starter (for eksempel under /mnt/remotes) blir synlig uten en omstart.
På TrueNAS er Host Data en datasett-sti som /mnt/tank, aldri et ixVolume. Data som en app lagrer i et ixVolume, ligger utenfor den og blir ikke sikkerhetskopiert. Se TrueNAS SCALE.
Sikkerhetskopi av ZFS-datasett trenger også denne modusen: verten monterer øyeblikksbildet av et datasett først etter at containeren har startet. Se ZFS-datasett.
Lokale repositorier har som standard /mnt/user/bombvault/{container,vms,flash,config,files,zfs}, opprettet ved den første sikkerhetskopieringen. De er områdenes egne mapper og utgjør målet Lokal. På siden til det målet under Mål endrer kortet Tilkobling mappen for hvert område.
Et områdes egen mappe kan også ligge i et mål du allerede har, for eksempel en NAS eller en S3-bøtte: Bruk som egen mappe på målets side flytter den dit og sier først hva som skjer med sikkerhetskopiene som allerede er laget. Se Et områdes egen mappe.
De lokale depotmappene beholder modusene 0755 og 0644, så en bruker uten root som synkroniserer over SMB ikke blir låst ute, og depotene er krypterte, så dette avslører ingenting. Gjenopprettingsdefinisjonene ligger inne i hvert depot, så en kopiert mappe er komplett i seg selv. Depotet til auto-sikkerhetskopien kan bare leses av root.
Host-integrasjonssjekk
Kortet Host-integrasjon på oversikten (legg det til under Tilpass) sonderer hver montering og hvert CLI (Docker-socket, libvirt, restic, qemu-img, rclone) og rapporterer manglende deler.
Gjenkjenning av sikkerhetskopiens kilder¶
For hver container velger BombVault selv hvilke bind-monteringer og navngitte volumer som sikkerhetskopieres. En sti tas med så snart ett av punktene nedenfor gjelder (resultatet kan alltid overstyres i kortet Sikkerhetskopierte mapper på fanen Innstillinger til containeren):
- Treff på et datarot-segment: bindens vertskilde inneholder ett av segmentene i
DATA_ROOT_SEGMENTSsom en hel stikomponent (som standard bareappdata). - Navngitte Docker-volumer tas alltid med, fordi de ikke har noen engangsutgave og det dermed ikke er noe å filtrere bort, men bare når volumets virkelige lagringssti på verten selv er nåbar gjennom Host Data-monteringen, akkurat som enhver annen vertssti BombVault sikkerhetskopierer. Standarddriveren for lokale volumer legger et volum under selve demonens datarot, altså
/var/lib/docker/volumes/<navn>/_datamed mindre det er endret (sjekk meddocker info -f '{{.DockerRootDir}}'). Det stedet er IKKE dekket av den smale Host Data-monteringen med én enkelt katalog som den generiskedocker-compose.ymlbruker som standard. Et volum som ikke kan nås, hoppes stille over, det er ingen feil. For faktisk å sikkerhetskopiere navngitte volumer på en generisk vert må du peke Host Data (ogHOST_SOURCE_ROOT) mot en felles overordnet katalog som også dekker Dockers datarot: avveiningen står i Host Data-kommentaren i compose-filen (Unraid går utenom dette ved av samme grunn å montere hele/mnt, sin egen allmenngyldige konvensjon på øverste nivå). - Prosjektkatalog for Docker Compose: bærer containeren den vanlige etiketten
com.docker.compose.project.working_dir(settes automatisk avdocker compose up), blir den katalogen også lagt til, uavhengig av om noen bind traff et datarot-segment. - Overstyring med etiketten
bombvault.data: sett etikettenbombvault.data=truepå en container for å ta med alle dens bind-monteringer, for et oppsett som ingen av konvensjonene over fanger opp (for eksempel én enkelt bind/srv/plex/configuten Compose-prosjekt). Enhver ikke-tom verdi utenomfalseteller som sann. En manglende etikett ellerbombvault.data=falseendrer ingenting. - Etiketten
bombvault.dbdump: settbombvault.dbdump=falsepå en container for å slå av den automatiske databasedumpen (0,noogoffgjør det samme), eller navngi motoren (postgres,mysql,mariadb) for å dumpe en container BombVault ikke gjenkjenner selv. Etiketten vinner over bryteren i kortet Database på fanen Innstillinger til containeren, som er den vanlige veien på Unraid.
Sikkerhetsmodell¶
Root-ekvivalent kontroll over hosten
Gjennom Docker-socketen kan BombVault stoppe, fjerne og gjenskape containere og lese/skrive appdata, og for VM-sikkerhetskopiering logger den seg inn på hosten over SSH (qemu+ssh://, root som standard) for å kjøre virsh. Alle som når webgrensesnittet, har i praksis root på hosten.
Pålogging¶
- Valgfri passordbeskyttelse (kortet Passord under Innstillinger, Sikkerhet): sett et passord for å kreve pålogging, tøm det for å slå av. Av som standard for bruk på et betrodd LAN. Passordet lagres med Argon2id over en verdi pepret med
APP_KEY, så en kopiert/configer verdiløs uten nøkkelen og treg å angripe med den. Et nytt passord krever minst 12 tegn. Et eksisterende kortere fungerer videre til det endres. Økter er signert (HMAC utledet fraAPP_KEY), og en passordendring gjør dem ugyldige. Pålogginger er begrenset til fem feil i minuttet per klient. Å endre eller tømme passordet krever Nåværende passord og, med tofaktorautentisering på, koden. - Noen ting krever et passord. Å laste ned gjenopprettingssettet, feilrapporten og ZIP-filen til en flash-sikkerhetskopi, å eksportere en flash- eller auto-sikkerhetskopi, å deponere nøkkelen hos en nøkkelvokter, å tillate at en deponering utleveres, å lage en ny frigivelseskode, å eksportere innstillinger med legitimasjon, tofaktorautentisering, passnøkler, å legge til en node, å vise compose-filen til en node på nytt og å åpne elementene til en node avvises til et påloggingspassord er satt, og de krever en pålogging på selve instansen. Sletting av sikkerhetskopier virker uten passord. Er et passord satt, krever også det denne påloggingen.
- Et mål viser ikke noe passord. Et mål kan inneholde en pålogging, som i
rest:https://user:password@host/repo, og hver side og hvert API-svar viser det somrest:https://[redacted]@host/repo, med eller uten påloggingspassord. Endrer du stien bak det, blir det lagrede passordet værende. For å peke målet mot en annen server skriver du inn hele målet med passordet, fordi et skjult passord blir hos serveren sin. - Tofaktorautentisering (Innstillinger, Sikkerhet): en tidskode fra en autentiseringsapp i tillegg til passordet, pluss åtte engangs gjenopprettingskoder som deles ut én gang når den slås på. Den delte hemmeligheten lagres kryptert med
APP_KEY, og det kreves en gyldig kode for å slå den av igjen. - Passnøkler (WebAuthn) har sitt eget kort når et passord er satt. De brukes sammen med passordet og aldri i stedet for det, så den som fjerner alle passnøkler, låser ingen ute. De krever et ekte domenenavn og et sertifikat som nettleseren stoler på. Standardadressen
https://<ip>:3443er nettopp det WebAuthn avviser, og kortet sier det i stedet for å tilby en knapp som feiler. Med tofaktorautentisering på må en passnøkkel sjekke PIN-koden, fingeravtrykket eller ansiktet ditt, ellers ber påloggingen også om koden. - En gjenoppretting av konfigurasjonen (Hent tilbake innstillinger i Nødveiviser) avslutter alle økter, fjerner alle passnøkler og trekker tilbake alle API-tokens og MCP-nøkler, fordi de gjenopprettede innstillingene kunne hente tilbake slike som ble fjernet etter at innstillingene ble lagret. Logg inn med passordet og sett opp passnøklene dine på nytt under Innstillinger, Sikkerhet.
- Et glemt passord tilbakestilles på innloggingssiden. Glemt passordet? får BombVault til å skrive en kode på 12 tegn, i tre grupper på fire, til loggen til containeren sin (på Unraid: Docker-fanen, BombVault-ikonet, Logs). Den koden og et nytt passord logger deg inn. Tilbakestillingen slår også av tofaktorautentisering, fjerner alle passnøkler, trekker tilbake alle API-tokens, MCP-nøkler og OAuth-pålogginger, avslutter alle andre økter, logger ut hver paret telefon og slår av telefonparing. Siden etterpå lister hva som ble borte. En kode er gyldig i 10 minutter, og gale gjetninger bruker den ikke opp. Widget- og metrikk-tokens blir, siden de bare leser.
- Alle som kan lese containerloggen, kan tilbakestille passordet. Det er root på hosten, men også en loggviser som Dozzle, enhver container som får Docker-socketen (skrivebeskyttet er nok) og en loggsender som videresender containerutdata. Gi dem bare til folk du ville stolt på med passordet. Den som bare når nettgrensesnittet, ser aldri koden.
Telefoner og gruppemedlemmer¶
- Parede telefoner når en liste over det som er tillatt. En telefon som kjenner gruppens tolv ord, logger inn uten passordet, så lenge Telefoner kan pare med gruppens tolv ord er på i kortet Android-app under Innstillinger, Sikkerhet. Økten når bare det appen viser: oversikten, kjøringene, sikkerhetskopiene man kan se på, starte og gjenopprette, avvikene man kan lese og Instanser-siden man kan se på. Mål og kommandoer når den uten adresser og hemmeligheter, og en gjenoppretting som erstatter originalen, tar først en sikkerhetskopi av dagens tilstand. En gjenoppretting til en mappe tar bare en ny eller tom mappe inne i gjenopprettingsmappen, og en telefon kan ikke se inn i noen annen mappe. Alt annet svarer at det krever en pålogging på selve instansen: nøkler, gjenopprettingssettet, nøkkeldeponeringer, innstillinger, sletting av sikkerhetskopier. En tilbakestilling av passordet slår av telefonparing til du slår den på igjen. En telefon som er fjernet fra Instanser-siden, eller som har Spør ut denne instansen slått av i detaljene, mister økten sin med en gang, og en fjernet telefon som åpner appen igjen, kommer tilbake slått av.
- Når du er borte, åpner en telefon sider over relayet. Hver forespørsel fra siden er forseglet med gruppens nøkkel, som relayet verken kan lese eller endre, og signert med en egen nøkkel fra telefonen, som serveren fester ved telefonens første kall og slipper inn så snart noen godkjenner telefonen på parings-siden. Serveren kjører en forespørsel bare én gang og bare så lenge den er fersk. Den svarer bare en telefon som står på Instanser-siden, så lenge telefonparing er på, og bare med en økt den har gitt den telefonen, så å logge ut overalt og tilbakestilling av passordet avslutter også disse sidene. Serveren signerer hvert svar, og appen sjekker signaturen mot nøkkelen den festet for den serveren, og advarer når nøkkelen endres. En slik side når den samme listen over det som er tillatt som en paret telefon, med eller uten påloggingspassord, pluss påloggingsstatusen siden leser først. Pålogging og utlogging, tilbakestilling av passordet og nedlastinger blir på serverens egen adresse, og ett svar er begrenset til 16 MB.
- Medlemmer signerer det de ber om. Rolleforespørsler og svarene på dem, lagringstilbud, utleveringen av et restic-passord til en mottaker eller henter, påloggingene til mottakere og nøkkeldeponeringer signeres med en nøkkel fra hvert medlem, som en instans fester første gang den ser medlemmet. Et kall signert med en annen nøkkel avvises. Glem nøkkelen i detaljene til en instans slipper den festede nøkkelen, for tilfellet der den som er kjent her, ikke er medlemmets egen. Medlemmet bes om nøkkelen sin på nytt ved neste signerte kall. Medlemmer på BombVault 9.x signerer ikke og kan etterlignes av alle som har ordene, som i 9.9. En rolleforespørsel eller et lagringstilbud fra et medlem på 10.4 eller eldre avvises til medlemmet er oppdatert.
- De tolv ordene er et passord. Alle som har dem, blir med i gruppen, ser beskyttelsesstatusen til medlemmene og kan be om roller, som en person på den andre instansen fortsatt må tillate. Uten påloggingspassord kan alle som kan åpne nettgrensesnittet, lese dem, og paringskortet sier det til et passord er satt.
Nøkler¶
- APP_KEY gjør to ting. Den forsegler det denne installasjonen lagrer (passord, pålogginger, tokens), og den er nøkkelen til sikkerhetskopiene: restic-passordet utledes fra den, og container- og VM-definisjoner forsegles med den.
- En overtatt nøkkel holdes for seg. Når Nødveiviser tar over en annen servers sikkerhetskopier, forsegler denne installasjonen fortsatt med sin egen APP_KEY og lagrer den andre serverens nøkkel som sin sikkerhetskopinøkkel, forseglet som alle andre hemmeligheter. Gjenopprettingssettet skriver da ut begge. Endres APP_KEY etterpå, kan sikkerhetskopinøkkelen ikke lenger åpnes: BombVault slutter å ta sikkerhetskopier og sier fra under Krever oppmerksomhet, i stedet for å skrive med feil nøkkel. Last opp gjenopprettingssettet på nytt under Gjenoppretting, Nød, eller sett APP_KEY tilbake. Se Nødveiviser.
- Kryptering er på som standard (Krypter sikkerhetskopier i kortet Kryptering under Innstillinger, Sikkerhet). Sikkerhetskopier krypteres av restic med passordet som utledes fra sikkerhetskopinøkkelen.
- Nøkkeldeponeringer. En nøkkelvokter i gruppen din holder en forseglet kopi av gjenopprettingssettet til denne serveren som den ikke kan åpne selv. Bare frigivelseskoden på 20 tegn åpner den, og vokteren leverer den ut først etter at noen der trykker Tillat. Se Nøkkelvokter.
Noder¶
En node er en BombVault uten nettgrensesnitt som tar imot oppdrag fra en hjemmeinstans.
- Hjemmeinstansen styrer noden. En node monterer Docker-socketen på serveren sin, noe som er root der, og hjemmeinstansen styrer noden. Blir hjemmeinstansen tatt over, styrer angriperen også alle nodene dens. Gi hjemmeinstansen et påloggingspassord og hold nettgrensesnittet dens unna internett.
- En node har lite å gi. Blir en node tatt over, får angriperen ingen paringsgruppe, ingen festning, ingen annen node og ikke noe annet repository. Noden har bare en forbindelse til hjemmeinstansen sin, en egen pålogging på mottaksserveren og en egen mappe på et mål. På mottaksserveren kan den ikke slette historikk, fordi serveren er append-only. Den kan fylle disken til serveren, fordi rest-server ikke setter noen kvote, så gi mottaksserveren plass eller en egen deling. På et mål kan påloggingen dens som regel slette det som ligger der. Sikkerhetskopier som blir på noden, er i angriperens hender, og derfor henter hjemmeinstansen en kopi av dem.
- Forbindelsen er privat og signert. Hjemmeinstansen og noden snakker gjennom relayet over en egen forbindelse, forseglet med en hemmelighet som er utledet fra
APP_KEYtil noden. Hver side kjenner nøkkelen til den andre før det første kallet, så det finnes ikke noe godkjenningssteg. Hjemmeinstansen signerer hvert kall med sin egen nøkkel og en teller, og noden avviser et kall som ikke er signert av hjemmeinstansen, eller som den allerede har tatt imot. Noden kaller ingenting på hjemmeinstansen utenom sitt hei. - Hjemmeinstansen når en fast liste. Forespørsler som hjemmeinstansen sender videre til en node, kjører bare på en fast liste over nodens ruter, som står under
GET /api/nodes/routes, og noden svarer bare med JSON. Ingenting på listen sletter noe eller når innstillingene, lagringen, nøklene, gruppen eller tokenene. På hjemmeinstansen krever de en pålogging med passordet: parede telefoner, API-tokener og MCP-nøkler når ingen node. Sikkerhetskopier og gjenopprettinger som startes slik, vises som startet av hjemmeinstansen. - Nøkkeldeponeringer har med nodenøkler. Hjemmeinstansen beholder
APP_KEYtil hver node, og gjenopprettingssettet skriver den ut i kapittelet Nodes, så en nøkkeldeponering har den med også. En nøkkelvokter som får deponeringen og gjenopprettingskoden, kan åpne repositoryene til nodene dine, men kan ikke gi noen node oppdrag, fordi det krever signaturen til hjemmeinstansen. - Frigivelse er endelig. En frigitt node tar ikke imot noen hjemmeinstans igjen med samme
APP_KEY. En node som er borte når du frigir den, får vite det av hjemmeinstansen så snart den er tilbake.
Nettverk¶
- Endringer krever JSON. En forespørsel som endrer noe, må sende
Content-Type: application/jsonog kan ikke være merket som cross-site av nettleseren, slik at en side på et annet nettsted ikke kan få nettleseren din til å endre innstillinger på en LAN-adresse. Et skript som styrer API-et, sender den headeren. Alt annet avvises med415. - Fordi porten er valgfri, er hele grensesnittet og API-et (inkludert målene, tamper-test-rutene og gjenopprettingsrutene) tilgjengelig for alle som når porten når den ikke er satt. Sett et påloggingspassord så snart ekstern lagring, append-only-sikkerhetskopier eller kryptering er i bruk.
- Kjør BombVault kun på et betrodd, ikke-eksponert nettverk. For fjerntilgang, sett den bak en revers-proxy som legger til autentisering og TLS. Svar bærer grunnleggende sikkerhetsheadere (CSP,
nosniff,X-Frame-Options,Referrer-Policy). - Bak en omvendt proxy bærer hver forespørsel proxyens adresse, så uten
TRUSTED_PROXYteller påloggingsbremsen alle klienter i én bøtte, og en angripers feil låser deg også ute. Oppgi proxyen iTRUSTED_PROXYfor å få telling per klient tilbake. - En omvendt proxy foran BombVault må sende headeren
AuthorizationellerX-API-Keyvidere til/mcpog må ikke bufre svarene, ellers kan ikke assistenter koble til. Se MCP-server. - MCP-endepunktet
/mcpsvarer404til det finnes en nøkkel eller pålogging via OAuth er slått på, og det krever nøkkel eller token av hver klient, også når påloggingspassordet er slått av. Ingen adresse er unntatt, heller ikkelocalhost. Det har ingen verktøy for å gjenopprette eller slette, og gjenoppretting av en konfigurasjonssikkerhetskopi tilbakekaller alle nøkler. Se MCP-server. - Med
HTTP_ONLY=truemister øktinformasjonskapselen sittSecure-flagg (det må den, for å fungere over ren HTTP), så aktiver bare passordet bak en TLS-terminerende proxy hvis konfidensialitet betyr noe. - VM-sikkerhetskopi-SSH-tilkoblingen stoler på host-nøkkelen ved første tilkobling (TOFU) og fester den deretter. Verifiser hostens nøkkel utenfor båndet hvis container-til-host-veien din ikke er betrodd.
- Lenker fører ikke ut av monteringen. En sikkerhetskopi eller en gjenoppretting på stedet stopper med en melding når en lenke over stien fører ut av vertsmonteringen, fordi en container som skriver i sin egen share, kunne plante en slik lenke. Et mål der verten eller rclone-remoten begynner med en bindestrek, avvises på samme måte, ved lagring og ved neste kjøring, fordi
sshellerrcloneville lese det som et alternativ.
MCP-server¶
MCP-serveren trenger ingen miljøvariabel. Du slår den på ved å lage en nøkkel under Innstillinger, Integrasjoner, MCP-server, og den svarer på /mcp på samme port som webgrensesnittet (for eksempel https://192.168.1.10:3443/mcp). Uten en aktiv nøkkel svarer den stien med 404. Klienter, sertifikater og grenser er beskrevet på MCP-server.
VM-sikkerhetskopiering over SSH¶
BombVault sikkerhetskopierer KVM/libvirt-VM-er uten å montere noen libvirt-sti. Den kjører virsh på hosten over SSH (qemu+ssh://), så den kan aldri påvirke host-VM Manageren din.
Å montere hostens libvirt-socket i en container er skjørt på Unraid: VM Manager eier de stiene, og å slå "Enable VMs" av og på kan etterlate libvirt i en tilstand der den ikke starter. SSH-nøkkelen gir root på hosten, samme tillitsnivå som Docker-socketen BombVault allerede bruker.
Rask oppsett:
- Innstillinger, Integrasjoner, Verts-SSH: kopier den viste offentlige nøkkelen.
- Legg den til i Unraids
/root/.ssh/authorized_keys(også lagret til flashen så den overlever omstarter). - Klikk Test tilkobling.
Malen legger til --add-host=host.docker.internal:host-gateway så containeren kan nå hosten. Sett LIBVIRT_HOST til din Unraid-LAN-IP hvis det navnet ikke løses (for eksempel når containeren kjører på et egendefinert br0.x-nettverk). Hvis du endret Unraids SSH-port, sett LIBVIRT_SSH_PORT til å matche. Live-øyeblikksbilder trenger også qemu guest agent i VM-en og disken på /mnt/cache (ikke /mnt/user).
Full VM-oppsetts- og nettverksveiledning
Den fullstendige trinn-for-trinn-veiledningen (SSH-aktivering, vedvarende nøkkelautorisasjon, egendefinert-nettverk og VLAN-ruting, metode per VM og host-side-feilsøking) er veiledningen for VM-sikkerhetskopiering.
Oppsett for ekstern lagring¶
Eksterne kopier går til mål. Åpne Mål fra innstillingsflisen (eller fest den til sidefeltet) og velg Legg til mål. Se Ekstern lagring og gjenoppretting for hele arbeidsflyten (slettebeskyttelse, tamper-testing og DR-øvelser). Kort fortalt:
- Backender: SMB/CIFS og WebDAV via rclone uten host-montering, NFS (monter eksporten på hosten og bruk den som lokal mappe), native restic-backender uten 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 egen backend her: nå det gjennom S3-endepunktet (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>) med nøkkel-ID-en og applikasjonsnøkkelen som S3-legitimasjon. - Pålogginger lagres kryptert, som én liste med lagrede pålogginger i kortet Pålogginger under Innstillinger, Mål. En stjerne markerer standarden, som brukes overalt der ingen pålogging er valgt. Siden til et mål velger den det bruker i kortet Legitimasjon. Se Pålogginger.
- SSH-mål trenger ingenting installert på den andre siden.
sftp:trenger bare en SSH-server. Legg til den offentlige nøkkelen fra Innstillinger, Integrasjoner, Verts-SSH (også på/config/ssh/id_ed25519.pub) til målbrukerens~/.ssh/authorized_keys, eller la Legg til nøkkel i Legg til mål legge den der med passordet til kontoen. - rest-server med selvsignert sertifikat: legg sertifikatet, eller sertifikatet til utstederen som signerte det, som PEM-fil i mappen
certsi BombVaults datamappe (/config/certsi containeren,appdata/bombvault/certspå Unraid). Sikkerhetskopier, kopier og testen av beskyttelsen mot sletting stoler på det uten omstart. - Ekstern kopi: BombVault kopierer nye sikkerhetskopier med
restic copypå best-effort-basis, i tillegg til et (vanligvis lokalt) primærarkiv. Kortet Kopier til et mål bestemmer om det kopierer Etter hver sikkerhetskopi eller etter en egen plan, og Innstillinger, Tidsplan, Off-site-kopier per område gir ett område en egen kopieringsplan. Replikér nå ligger i raden til området i kortet Eksterne kopier under Innstillinger, Mål. - Flere mål per område: kortet Mål per område på siden Mål slår hver linje fra et område til et mål av eller på med ett klikk, også Lokal. Et område med bare eksterne mål sikkerhetskopierer rett dit, og et område der alle linjer er av, blir ikke sikkerhetskopiert. Regler per område hos et mål gir ett område sitt eget arkiv, sin egen oppbevaring eller komprimering der.
- Plassering per element: hver container, VM og hvert mappesett tenner Lokal og målene som får sikkerhetskopiene, i kortet Tidsplan og mål på fanen Innstillinger. Elementer uten eget valg følger området sitt. Se Plassering per element.
- Oppbevaring: hvert mål beholder sikkerhetskopier etter kortet Hvor lenge det beholdes, og et område kan ha egne verdier der under Regler per område. Kopien i et områdes eksterne felt følger reglene i kortet Off-site-oppbevaring under Innstillinger, Mål, som har Oppbevaringsregler per kilde for enkeltområder (la det stå på null for aldri å trimme eksterne sikkerhetskopier automatisk).
- Båndbreddegrenser: begrens resticts opplastings-/nedlastingshastighet i kortet Ekstern båndbredde under Innstillinger, Mål, eller per mål i kortet Kopier. Du skriver KiB/s, og feltet viser den samme hastigheten i MB/s og Mbit/s.
- Strømming først: velg i kortet Strømming på siden Mål medieserverne (Plex, Jellyfin og Emby er forhåndsvalgt etter imagenavn), sendehastigheten fra der en regnes som strømming, opplastingsgrensen mens den strømmer og hvor lenge etter en strøm den vanlige grensen kommer tilbake.
- Kald og arkiv-lagringsklasse (S3): for et S3-mål, velg et gjenopprettingslesbart nivå (Standard, Standard-IA, One Zone-IA, Intelligent-Tiering, Glacier Instant Retrieval) på siden. rclone-remoter setter klassen sin i rclone-konfigurasjonen.
- Egen mappe i et mål i stedet for lokalt: den egne mappen til et område kan ligge i et av målene ovenfor, uten lokal kopi og uten kopieringstrinn. Se Et områdes egen mappe.
Avvik¶
Avviksoppdagelse trenger ingen miljøvariabel. Den stilles inn i kortet Avvik under Innstillinger, Verifisering, beskrevet på Avvik.
Portable innstillinger (eksporter og importer)¶
Kortet Eksporter / importer innstillinger under Innstillinger, System skriver hele BombVault-konfigurasjonen din (innstillinger per område, mål, tidsplaner, oppbevaring, varsler) til en portabel JSON-fil du kan importere på en annen instans, så å flytte til en ny boks eller klone et oppsett ikke betyr å taste inn alt på nytt for hånd. Import viser en forhåndsvisning og ber om bekreftelse, og den rører aldri sikkerhetskopidataene eller -historikken din. Lenker i filen til mål eller depoter som ikke finnes lenger, utelates, og forhåndsvisningen navngir dem. Mens en ZFS-replika kjører, avvises en import før noe skrives.
Eksporten kan inneholde legitimasjon
Du velger om du vil inkludere ekstern-, varslings- og MQTT-megler-legitimasjonen i filen. Med legitimasjon inkludert er eksporten like sensitiv som gjenopprettingssettet ditt, så oppbevar den et trygt sted. Uten dem inneholder filen kun ikke-hemmelige innstillinger.
APP_KEY følger ikke med filen
Depotene er låst med et passord som utledes fra APP_KEY, og filen inneholder ikke nøkkelen. Ved en planlagt flytting gir du den nye boksen den gamle APP_KEY i malen, eller tar over nøkkelen med gjenopprettingssettet under Nød. Med en annen nøkkel svarer depotene at passordet er feil. Ingenting går tapt, og når riktig nøkkel er satt, åpnes de igjen.