Konfiguration¶
Den här sidan täcker containerns miljövariabler, monteringarna som mallen tillhandahåller, säkerhetsmodellen, VM-säkerhetskopiering över SSH och off-site-uppsättningen. Vart säkerhetskopiorna går ställs in inuti appen som lagringsmål, inte via miljövariabler.
Miljövariabler¶
| Variabel | Obligatorisk | Beskrivning |
|---|---|---|
APP_KEY |
Ja | 32-byte hex-hemlighet (64 hex-tecken) som används för att härleda restic-repo-lösenordet. Generera med openssl rand -hex 32. Förvara den säkert: att förlora den gör krypterade säkerhetskopior oåterställbara. |
LIBVIRT_HOST |
För VM:ar och ZFS-datauppsättningar | Unraid-värd nådd över SSH för säkerhetskopiering av VM:ar och ZFS-datauppsättningar (mallfält Host SSH: Address, standard host.docker.internal). Mallen förifyller platshållaren 192.168.x.x, som räknas som inte satt. Använd din Unraid-LAN-IP, obligatorisk på ett anpassat br0.x-nätverk. När host.docker.internal inte går att slå upp, som i en TrueNAS-app, och LIBVIRT_URI inte heller anger någon värd, använder BombVault containerns standardgateway, och startloggen nämner den. |
LIBVIRT_SSH_PORT |
Nej | Värdens SSH-port för säkerhetskopiering av VM:ar och ZFS-datauppsättningar (mallfält Host SSH: Port, standard 22). |
LIBVIRT_SSH_USER |
Nej | SSH-användare på värden för säkerhetskopiering av VM:ar och ZFS-datauppsättningar (mallfält Host SSH: User, standard root). |
LIBVIRT_URI |
Nej | Fullständig libvirt-anslutnings-URI, som används ordagrant i stället för att bygga en av de tre LIBVIRT_*-variablerna ovan (som då ignoreras för anslutningssträngen). Standard är osatt. Behövs på TrueNAS Scale, vars libvirtd lyssnar på en ovanlig socket som den byggda formen inte kan uttrycka: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. Se guiden för VM-säkerhetskopiering. När den är en qemu+ssh://-URI hämtas var och en av LIBVIRT_HOST, LIBVIRT_SSH_USER och LIBVIRT_SSH_PORT som inte är satt från den, även för BombVaults egna SSH-kommandon (NVRAM-överföring, ZFS-datauppsättningar). |
PORT |
Nej | HTTP-port (standard 3000. Används bara med HTTP_ONLY=true). |
HTTPS_PORT |
Nej | HTTPS-port (standard 3443. Mallen publicerar den 1:1, så webbgränssnittet svarar på https://<ip>:3443). |
HTTP_ONLY |
Nej | Sätt true för att stänga av den självsignerade HTTPS-lyssnaren och bara servera vanlig HTTP (för användning bakom en omvänd proxy som avslutar TLS). |
BIND_HOST |
Nej | Adressen webbgränssnittet lyssnar på (standard 0.0.0.0, alla gränssnitt). Lämna den osatt i containern, vars publicerade portar behöver alla gränssnitt. 127.0.0.1 passar en körning utanför Docker. Hälsokontrollen frågar samma adress. |
TRUSTED_PROXY |
Nej | Kommaseparerade adresser eller CIDR-intervall för den omvända proxyn framför BombVault (till exempel 192.168.20.11 eller 10.0.0.0/8). Bara från de hoppen tros X-Forwarded-For, och inloggningsspärren räknar då fel per verklig klient i stället för att lägga alla bakom proxyn i samma hink. Osatt (standard) litar inte på någon: ett HTTP-huvud som tros villkorslöst skulle låta vem som helst välja sin egen hink. |
HOST_SOURCE_ROOT |
Nej | Värdsökvägen som monteras som Host Data (standard /mnt). BombVault översätter de bind-monteringskällor som Docker rapporterar till sökvägar under den här monteringen. Ändra bara om du monterade en annan värdrot. |
HOST_MOUNT_ROOT |
Nej | Var Host Data monteras inuti containern (standard /host/user). På TrueNAS monteras Host Data på sin egen värdsökväg, så den här och HOST_SOURCE_ROOT anger båda den sökvägen, till exempel /mnt/tank (se TrueNAS SCALE). |
DATA_ROOT_SEGMENTS |
Nej | Kommaseparerade sökvägssegmentnamn som markerar en bind-monteringskälla som säkerhetskopieringsdata (standard appdata, enligt Unraids konvention /mnt/user/appdata/<container>). En containers bind-montering väljs automatiskt för säkerhetskopiering när NÅGOT listat segment förekommer som ett helt sökvägssegment i dess värdkälla. Till exempel plockar DATA_ROOT_SEGMENTS=appdata,config också upp en .../config-bind. Matchningen ignorerar versaler, så standarden täcker också ZimaOS /DATA/AppData/<container>. Se Igenkänning av säkerhetskopieringens källor för de andra, alltid påslagna sätten att hitta en containers datamapp. |
PLATFORM |
Nej | Tvingar vilken plattform BombVault anser sig köra på, i stället för att känna igen den automatiskt: unraid, generic eller truenas (standard osatt: känner igen Unraid genom att leta efter dess dockerMan-markör under flash-monteringen, annars generic. Ett okänt värde faller också tillbaka på generic, loggat). Sätt den uttryckligen på en generisk Docker-värd eller TrueNAS Scale i stället för att lita på den Unraid-specifika autosökningen. Den generiska compose-filen gör det. Ändrar appdata-reservkonventionen, standardvärdena för återställningsmål mellan instanser och om de Unraid-specifika stegen för aviseringar och följeslagar-plugin över huvud taget provas (se internal/platform). |
BOMBVAULT_SELF_CONTAINER |
Nej | Namnet på själva BombVault-containern, så att den aldrig säkerhetskopierar (och därmed stoppar) sig själv. |
BACKUP_MAX_HOURS |
Nej | Maximalt antal klocktimmar en enskild säkerhetskopiering får hålla sitt avsnittslås innan den avbryts med tvång (ett skydd så att en fastnad körning inte kan blockera avsnittet för alltid). Tom (standard) använder 48. Höj den för mycket stora eller långsamma molnsäkerhetskopior (en körning som avbryts vid gränsen misslyckas med context deadline exceeded). Sätt 0 för att stänga av gränsen helt. En rensning hålls till samma gräns, och en kontroll eller rensning körs så länge restic fortsätter rapportera förlopp. |
BACKUP_STALL_HOURS |
Nej | Timmar en säkerhetskopiering får göra inga framsteg alls innan den avbryts. Tom (standard) använder 2. Sätt 0 för att aldrig avbryta vid stillastående. Det här är den finare av de två spärrarna och oftast den som slår till: den tittar på om något fortfarande händer snarare än hur lång tid körningen har tagit, så en långsam men frisk säkerhetskopiering på flera terabyte lämnas ifred medan en som fastnat på en icke-svarande delad resurs stoppas på timmar i stället för dagar. En varning loggas efter 30 minuters tystnad, innan något avbryts. Skanning räknas som framsteg: restic skriver inga byte medan det går igenom ett stort träd, och den fasen bevakas via filernas och bytens summor i stället för via skrivna byte. De två variablerna är oberoende, och BACKUP_MAX_HOURS begränsar fortfarande faserna efter själva säkerhetskopieringen (gallring, statistik, off-site-kopia), där det inte finns några räknare att bevaka. |
DB_DUMP_MAX_HOURS |
Nej | Timmar en automatisk databasdump får köra innan den stoppas. Tom (standard) använder 6. Tillåtna värden är 1 till 48, och gränsen hålls en timme under BACKUP_MAX_HOURS (på hälften av den när den är under två timmar), så en lång dump avbryts av sin egen gräns och rapporteras som det i stället för att dra ner säkerhetskopieringen med sig. En dump som inte gör några framsteg stoppas tidigare, efter BACKUP_STALL_HOURS. En stoppad dump misslyckas för sig och containersäkerhetskopian fortsätter. På Unraid lägger du till den i BombVault-containern med Add another Path, Port, Variable. |
TZ |
Nej | Tidszon för schemaläggaren (till exempel Europe/Berlin). Lämnar du den osatt körs varje schema i UTC: ett som är satt till 02:30 avfyras då 02:30 UTC i stället för på din egen klocka. På Unraid sätter du aldrig den själv: systemet skickar in sin egen tidszon i varje container. Startloggen säger vilken zon den kom fram till. En zon med sommartid hoppar över en körning på våren och kör en två gånger på hösten, medan UTC inte gör något av det men glider en timme mot din klocka två gånger om året. |
DATA_DIR |
Nej | Var BombVault håller sin databas, sina nycklar och cachar (standard /config). Låt den vara i containern. Den spelar roll när du kör binären utanför Docker. |
FLASH_DIR, FLASH_TEMPLATES_DIR |
Nej | Var flashenheten och dess Docker-mallar är monterade inuti containern (standard /host/boot och /host/boot/config/plugins/dockerMan/templates-user). De följer mallens /boot-montering, så lämna dem osatta. |
MODE |
Nej | full (standard) kör hela appen. node kör en nod: inget webbgränssnitt och inga egna scheman, bara det som dess hemmainstans säger åt den. Alla andra värden stoppar starten med ett meddelande. Hemmainstansen fyller i det åt dig i nodens compose-fil. |
NODE_HOME |
På en nod | Vilken hemmainstans noden hör till, med hemmainstansens nyckel och relä, som ett enda värde som börjar med bvhome1.. Hemmainstansen skriver det i nodens compose-fil. Utan det startar noden, men ingen hemmainstans når den. En nod som en hemmainstans har tagit hand om vägrar starta när NODE_HOME anger en annan, tills den första släpper den. |
NODE_NAME |
Nej | Nodens namn, så som hemmainstansen fyllde i det utifrån namnet du gav den. |
Monteringar¶
Montera Docker-socketen, flashen (/boot) och Host Data-roten (/mnt) som visas i CA-mallen. Säkerhetskopieringens källor och mål ligger båda under Host Data, och den monteras som slave så att en fjärrresurs som monteras efter att containern startat (till exempel under /mnt/remotes) blir synlig utan omstart.
På TrueNAS är Host Data en datauppsättningssökväg som /mnt/tank, aldrig en ixVolume. Data som en app håller i en ixVolume ligger utanför den och säkerhetskopieras inte. Se TrueNAS SCALE.
Säkerhetskopiering av ZFS-datauppsättningar behöver också det här läget: värden monterar en datauppsättnings ögonblicksbild först efter att containern har startat. Se ZFS-datauppsättningar.
Lokala repositorier är som standard /mnt/user/bombvault/{container,vms,flash,config,files,zfs}, som skapas vid den första säkerhetskopian. De är avsnittens egna mappar och bildar lagringsmålet Lokal. På dess sida under Lagringsmål ändrar kortet Anslutning mappen för varje avsnitt.
Ett avsnitts egna mapp kan också ligga i ett lagringsmål du redan har, till exempel en NAS eller en S3-hink: Använd som egen mapp på målets sida flyttar den dit och säger först vad som händer med de säkerhetskopior som redan finns. Se Ett avsnitts egna mapp.
De lokala repositoriemapparna stannar på lägena 0755 och 0644, så att en icke-root-synkanvändare över SMB inte stängs ute, och repositorierna är krypterade, så det här avslöjar ingenting. Återställningsdefinitionerna ligger inuti varje repositorium, så en kopierad mapp är fullständig i sig själv. Repositoriet för auto-säkerhetskopian förblir läsbart bara för root.
Värdintegrationskontroll
Kortet Värdintegration på översikten (lägg till det under Anpassa) sonderar varje montering och CLI (Docker-socket, libvirt, restic, qemu-img, rclone) och rapporterar eventuella saknade delar.
Igenkänning av säkerhetskopieringens källor¶
För varje container väljer BombVault automatiskt vilka bind-monteringar och namngivna volymer som ska säkerhetskopieras. En sökväg plockas upp när något av följande gäller (du kan alltid ändra resultatet i kortet Säkerhetskopierade mappar på containerns flik Inställningar):
- Träff på datarotens segment: bindens värdkälla innehåller ett av segmenten i
DATA_ROOT_SEGMENTSsom en hel sökvägskomponent (standard baraappdata). - Namngivna Docker-volymer tas alltid med, eftersom de inte har någon motsvarighet att kasta och det inte finns något att filtrera, men bara när volymens verkliga lagringssökväg på värden själv går att nå genom Host Data-monteringen, precis som vilken annan värdsökväg som helst som BombVault säkerhetskopierar. Dockers standarddrivrutin för lokala volymer lagrar en volym under daemonens egen datarot (
/var/lib/docker/volumes/<name>/_dataom du inte anpassat den. Kontrollera meddocker info -f '{{.DockerRootDir}}'), som inte täcks av den smala Host Data-montering på en enda katalog som den generiskadocker-compose.ymlanvänder som standard. En volym som inte går att nå hoppas över tyst, det är inget fel. För att faktiskt säkerhetskopiera namngivna volymer på en generisk värd riktar du Host Data (ochHOST_SOURCE_ROOT) mot en gemensam överordnad mapp som också täcker Dockers datarot. Kommentaren om Host Data i compose-filen förklarar avvägningen (Unraid kringgår detta genom att montera hela/mnt, sin egen universella konvention på toppnivå, av samma skäl). - Docker Compose-projektets katalog: om containern bär den vanliga etiketten
com.docker.compose.project.working_dir(sätts automatiskt avdocker compose up) läggs den katalogen också till, oavsett om någon bind matchade ett datarotssegment. - Etiketten
bombvault.data: sätt etikettenbombvault.data=truepå en container för att ta med alla dess bind-monteringar, för en uppläggning som ingen av konventionerna ovan fångar (till exempel en enda/srv/plex/config-bind utan Compose-projekt). Vilket icke-tomt värde som helst utomfalseräknas som sant. En saknad etikett ellerbombvault.data=falseändrar ingenting. - Etiketten
bombvault.dbdump: sättbombvault.dbdump=falsepå en container för att stänga av dess automatiska databasdump (0,noochoffgör detsamma), eller ange motorn (postgres,mysql,mariadb) för att dumpa en container som BombVault inte känner igen själv. Etiketten gäller före omkopplaren i kortet Databas på containerns flik Inställningar, som är sättet att göra det på Unraid.
Säkerhetsmodell¶
Root-likvärdig kontroll över värden
Via Docker-socketen kan BombVault stoppa, ta bort och återskapa containrar och läsa/skriva appdata, och för VM-säkerhetskopiering loggar den in på värden över SSH (qemu+ssh://, som standard root) för att köra virsh. Vem som helst som kan nå dess webbgränssnitt har i praktiken root på värden.
Inloggning¶
- Valfritt lösenordsskydd (kortet Lösenord under Inställningar, Säkerhet): sätt ett lösenord för att kräva inloggning, ta bort det för att stänga av. Av som standard för användning i ett betrott LAN. Lösenordet lagras med Argon2id över en
APP_KEY-nyckelad pepper, så en kopierad/configär värdelös utan nyckeln och långsam att angripa med den. Ett nytt lösenord behöver minst 12 tecken. Ett befintligt kortare fortsätter att fungera tills det ändras. Sessioner är signerade (HMAC härlett frånAPP_KEY) och att ändra lösenordet gör dem ogiltiga. Inloggningar begränsas till fem misslyckanden i minuten per klient. Att ändra eller ta bort lösenordet frågar efter Nuvarande lösenord och, med tvåfaktorsautentisering på, koden. - Vissa saker kräver ett lösenord. Att ladda ner återställningskitet, felrapporten och ZIP-filen för en flash-säkerhetskopia, att exportera en flash- eller auto-säkerhetskopia, att deponera nyckeln hos en nyckelförvarare, att tillåta att en deposition lämnas ut, att göra en ny återställningskod, att exportera inställningar med inloggningsuppgifter, tvåfaktorsautentisering, lösennycklar, att lägga till en nod, att visa en nods compose-fil igen och att öppna en nods poster nekas tills ett inloggningslösenord är satt, och de kräver en inloggning på själva instansen. Att radera säkerhetskopior fungerar utan lösenord. När ett lösenord är satt kräver även det den inloggningen.
- Ett lagringsmål visar inget lösenord. Ett lagringsmål kan innehålla en inloggning, som i
rest:https://user:password@host/repo, och varje sida och varje API-svar visar det somrest:https://[redacted]@host/repo, med eller utan inloggningslösenord. Ändrar du sökvägen bakom det, blir det lagrade lösenordet kvar. För att peka lagringsmålet mot en annan server skriver du hela målet med dess lösenord, eftersom ett dolt lösenord stannar hos sin server. - Tvåfaktorsautentisering (Inställningar, Säkerhet): en tidskod från en autentiseringsapp utöver lösenordet, plus åtta engångskoder för återställning som lämnas ut en gång när den slås på. Den delade hemligheten lagras krypterad med
APP_KEY, och att stänga av faktorn igen kräver en giltig kod. - Lösennycklar (WebAuthn) har ett eget kort när ett lösenord är satt, vid sidan av lösenordet och aldrig i stället för det, så att ta bort varje lösennyckel stänger inte ute någon. De kräver ett riktigt domännamn och ett certifikat som webbläsaren litar på. Standardadressen
https://<ip>:3443är precis vad WebAuthn nekar, och kortet säger det i stället för att erbjuda en knapp som misslyckas. Med tvåfaktorsautentisering på måste en lösennyckel kontrollera din PIN, ditt fingeravtryck eller ditt ansikte, annars ber inloggningen om koden också. - En konfigurationsåterställning (Återställ inställningar i Nödguiden) avslutar varje session, tar bort varje lösennyckel och återkallar varje API-token och MCP-nyckel, eftersom de återställda inställningarna kan föra tillbaka sådana som togs bort efter att de sparades. Logga in med lösenordet och sätt upp dina lösennycklar igen under Inställningar, Säkerhet.
- Ett glömt lösenord återställs på inloggningssidan. Glömt lösenordet? låter BombVault skriva en kod på 12 tecken, i tre grupper om fyra, till sin containerlogg (på Unraid: fliken Docker, BombVault-ikonen, Loggar). Den koden och ett nytt lösenord loggar in dig. Återställningen stänger också av tvåfaktorsautentisering, tar bort varje lösennyckel, återkallar varje API-token, MCP-nyckel och OAuth-inloggning, avslutar varje annan session, loggar ut varje parkopplad telefon och stänger av telefonparkoppling. Sidan efteråt listar vad som försvann. En kod gäller i 10 minuter, och fel gissningar förbrukar den inte. Widget- och metrics-token stannar, eftersom de bara läser.
- Den som kan läsa containerloggen kan återställa lösenordet. Det är root på värden, men också en loggvisare som Dozzle, varje container som fått Docker-socketen (skrivskyddad räcker) och en logginsamlare som vidarebefordrar containerutdata. Ge dem bara till människor du skulle lita på med lösenordet. Den som bara når webbgränssnittet ser aldrig koden.
Telefoner och gruppmedlemmar¶
- Parkopplade telefoner når en tillåtelselista. En telefon som kan gruppens tolv ord loggar in utan lösenordet, så länge Telefoner kan parkopplas med gruppens tolv ord är på i kortet Android-app under Inställningar, Säkerhet. Dess session når bara det appen visar: översikten, körningarna, säkerhetskopiorna att titta på, start och återställning, avvikelserna att läsa och sidan Instanser att titta på. Lagringsmål och kommandon når den med adresser och hemligheter borttagna, och en återställning som ersätter originalet säkerhetskopierar först det nuvarande läget. En återställning till en mapp tar bara en ny eller tom mapp inuti återställningsmappen, och en telefon kan inte titta in i någon annan mapp. Allt annat svarar att det behöver en inloggning på själva instansen: nycklar, återställningskitet, nyckeldepositioner, inställningar, att radera säkerhetskopior. En återställning av lösenordet stänger av telefonparkoppling tills du slår på den igen. En telefon som tas bort från sidan Instanser, eller med Fråga av den här instansen avstängt i sina detaljer, förlorar sin session direkt, och en borttagen telefon som öppnar sin app igen kommer tillbaka avstängd.
- Borta från hemmet öppnar en telefon sidor via reläet. Varje begäran från sidan förseglas med gruppens nyckel, som reläet varken kan läsa eller ändra, och signeras med en egen nyckel för telefonen, som servern fäster vid telefonens första anrop och släpper in så snart någon godkänner telefonen på parkopplingssidan. Servern kör en begäran en gång och bara medan den är ny. Den svarar bara en telefon som står på sidan Instanser medan telefonparkoppling är på, och bara med en session den gav den telefonen, så att logga ut överallt och en lösenordsåterställning avslutar också de här sidorna. Servern signerar varje svar, och appen kontrollerar signaturen mot nyckeln den fäste för den servern och varnar när nyckeln ändras. En sådan sida når samma tillåtelselista som en parkopplad telefon, med eller utan inloggningslösenord, plus inloggningsstatusen som sidan läser först. Att logga in och ut, lösenordsåterställningen och nedladdningar stannar på serverns egen adress, och ett svar begränsas till 16 MB.
- Medlemmar signerar det de frågar efter. Rollförfrågningar och deras svar, lagringserbjudanden, utlämnandet av ett restic-lösenord till en mottagare eller hämtare, mottagarinloggningar och nyckeldepositioner signeras med en nyckel för varje medlem, som en instans fäster första gången den ser den medlemmen. Ett anrop signerat med en annan nyckel nekas. Glöm nyckeln i en instanss detaljer släpper den fästa nyckeln, för fallet där den som är känd här inte är medlemmens egen. Medlemmen tillfrågas om sin nyckel igen vid sitt nästa signerade anrop. Medlemmar på BombVault 9.x signerar inte och kan imiteras av vem som helst som har orden, som i 9.9. En rollförfrågan eller ett lagringserbjudande från en medlem på 10.4 eller äldre nekas tills den medlemmen har uppdaterats.
- De tolv orden är ett lösenord. Den som har dem går med i gruppen, ser medlemmarnas skyddsstatus och kan be om roller, som en person på den andra instansen fortfarande måste tillåta. Utan inloggningslösenord kan vem som helst som kan öppna webbgränssnittet läsa dem, och parkopplingskortet säger det tills ett lösenord är satt.
Nycklar¶
- APP_KEY gör två saker. Den förseglar det den här installationen lagrar (lösenord, inloggningar, token) och den är nyckeln till säkerhetskopiorna: restic-lösenordet härleds från den, och container- och VM-definitioner förseglas med den.
- En övertagen nyckel hålls isär. När Nödguiden tar över en annan servers säkerhetskopior fortsätter den här installationen att försegla med sin egen APP_KEY och lagrar den andra serverns nyckel som sin säkerhetskopienyckel, förseglad som varje annan hemlighet. Återställningskitet skriver då ut båda. Om APP_KEY ändras efteråt går säkerhetskopienyckeln inte längre att öppna: BombVault slutar säkerhetskopiera och säger det under Behöver uppmärksamhet, i stället för att skriva med fel nyckel. Ladda upp återställningskitet igen under Återställning, Nödläge, eller sätt tillbaka APP_KEY. Se Nödguide.
- Kryptering är på som standard (Kryptera säkerhetskopior i kortet Kryptering under Inställningar, Säkerhet). Säkerhetskopior krypteras av restic med lösenordet som härleds från säkerhetskopienyckeln.
- Nyckeldepositioner. En nyckelförvarare i din grupp håller en förseglad kopia av den här serverns återställningskit som den inte kan öppna själv. Bara återställningskoden på 20 tecken öppnar den, och förvararen lämnar ut den först när någon där trycker på Tillåt. Se Nyckelförvarare.
Noder¶
En nod är en BombVault utan webbgränssnitt som tar emot order från en hemmainstans.
- Hemmainstansen styr noden. En nod monterar sin servers Docker-socket, vilket är root där, och hemmainstansen styr noden. Om hemmainstansen tas över styr angriparen också alla dess noder. Ge hemmainstansen ett inloggningslösenord och håll dess webbgränssnitt borta från internet.
- En nod har lite att ge. Om en nod tas över får angriparen ingen parkopplingsgrupp, ingen fästning, ingen annan nod och inget annat repositorium. Noden har bara en länk till sin hemmainstans, en egen inloggning på mottagarservern och en egen mapp på ett lagringsmål. På mottagarservern kan den inte radera historik, eftersom servern är append-only. Den kan fylla serverns disk, eftersom rest-server inte sätter någon kvot, så ge mottagarservern utrymme eller en egen delad resurs. På ett lagringsmål kan dess inloggning oftast radera det som ligger där. Säkerhetskopior som behålls på noden är i angriparens händer, och därför hämtar hemmainstansen en kopia av dem.
- Länken är privat och signerad. Hemmainstansen och noden pratar via reläet över en egen länk, förseglad med en hemlighet som härleds från nodens
APP_KEY. Varje sida känner den andras nyckel före det första anropet, så det finns inget godkännandesteg. Hemmainstansen signerar varje anrop med sin egen nyckel och en räknare, och noden nekar ett anrop som inte är signerat av hemmainstansen eller som den redan har tagit emot. Noden anropar ingenting på hemmainstansen utom sitt hej. - Hemmainstansen når en fast lista. Begäranden som hemmainstansen skickar vidare till en nod körs bara på en fast lista över nodens rutter, som visas på
GET /api/nodes/routes, och noden svarar bara med JSON. Ingenting på listan raderar något eller når inställningarna, lagringen, nycklarna, gruppen eller tokens. På hemmainstansen kräver de en inloggning med lösenordet: parkopplade telefoner, API-tokens och MCP-nycklar når ingen nod. Säkerhetskopieringar och återställningar som startas så visas som startade av hemmainstansen. - Nyckeldepositioner bär nodnycklar. Hemmainstansen behåller varje nods
APP_KEY, och återställningskitet skriver ut den i sitt kapitel Nodes, så en nyckeldeposition bär den också. En nyckelförvarare som får depositionen och utlämningskoden kan öppna dina noders repositorier, men kan inte ge order till någon nod, eftersom det kräver hemmainstansens signatur. - Att släppa är för gott. En släppt nod tar inte emot någon hemmainstans igen med samma
APP_KEY. En nod som är borta när du släpper den får veta det av hemmainstansen så snart den är tillbaka.
Nätverk¶
- Ändringar kräver JSON. En begäran som ändrar något måste skicka
Content-Type: application/jsonoch får inte vara markerad som cross-site av webbläsaren, så en sida på en annan webbplats kan inte få din webbläsare att ändra inställningar på en LAN-adress. Ett skript som styr API:et skickar det HTTP-huvudet. Allt annat nekas med415. - Eftersom spärren är frivillig kan hela gränssnittet och API:et (inklusive lagringsmålen, manipuleringstestets rutter och återställningsrutterna) nås av vem som helst som når porten när den inte är satt. Sätt ett inloggningslösenord så fort off-site-säkerhetskopior, append-only eller kryptering används.
- Kör BombVault bara på ett betrott, icke-exponerat nätverk. För fjärråtkomst lägger du det bakom en omvänd proxy som lägger till autentisering och TLS. Svar bär grundläggande säkerhetshuvuden (CSP,
nosniff,X-Frame-Options,Referrer-Policy). - Bakom en omvänd proxy bär varje begäran proxyns adress, så utan
TRUSTED_PROXYräknar inloggningsspärren alla klienter i en hink och en angripares misslyckanden stänger ute dig också. Ange proxyn iTRUSTED_PROXYför att få tillbaka räkning per klient. - En omvänd proxy framför BombVault måste släppa igenom HTTP-huvudet
AuthorizationellerX-API-Keytill/mcpoch får inte buffra sina svar, annars kan assistenter inte ansluta. Se MCP-server. - MCP-slutpunkten
/mcpsvarar404tills en nyckel finns eller inloggning via OAuth är påslagen, och den ber varje klient om sin nyckel eller token även med inloggningslösenordet av. Ingen adress är undantagen, inte enslocalhost. Den har inga verktyg för återställning eller radering, och att återställa en konfigurationssäkerhetskopia återkallar varje nyckel. Se MCP-server. - Med
HTTP_ONLY=trueförlorar sessionskakan sin flaggaSecure(den måste, för att fungera över vanlig HTTP), så slå bara på lösenordet bakom en proxy som avslutar TLS om sekretess spelar roll. - SSH-anslutningen för VM-säkerhetskopiering litar på värdnyckeln vid första anslutningen (TOFU) och fäster den därefter. Verifiera värdens nyckel på annat sätt om vägen mellan container och värd inte är betrodd.
- Länkar leder inte ut ur monteringen. En säkerhetskopiering eller en återställning på plats stoppar med ett meddelande när en länk ovanför dess sökväg leder ut ur värdmonteringen, eftersom en container som skriver i sin egen share skulle kunna placera en sådan länk. Ett lagringsmål vars värd eller rclone-remote börjar med ett bindestreck nekas på samma sätt, när det sparas och vid nästa körning, eftersom
sshellerrcloneskulle läsa det som ett alternativ.
MCP-server¶
MCP-servern behöver ingen miljövariabel. Du slår på den genom att skapa en nyckel under Inställningar, Integrationer, MCP-server, och den svarar på /mcp på samma port som webbgränssnittet (till exempel https://192.168.1.10:3443/mcp). Utan en aktiv nyckel svarar den sökvägen 404. Klienter, certifikat och gränser beskrivs på MCP-server.
VM-säkerhetskopiering över SSH¶
BombVault säkerhetskopierar KVM/libvirt-VM:ar utan att montera någon libvirt-sökväg. Den kör virsh på värden över SSH (qemu+ssh://), så den kan aldrig påverka värdens VM Manager.
Att montera värdens libvirt-socket i en container är bräckligt på Unraid: VM Manager äger de sökvägarna, och att slå av "Enable VMs" kan lämna libvirt oförmöget att starta. SSH-nyckeln ger root på värden, samma förtroendenivå som Docker-socketen som BombVault redan använder.
Snabb uppsättning:
- Inställningar, Integrationer, Värd-SSH: kopiera den visade publika nyckeln.
- Lägg till den i Unraids
/root/.ssh/authorized_keys(sparas också på flashen så att den överlever omstarter). - Klicka på Testa anslutning.
Mallen lägger till --add-host=host.docker.internal:host-gateway så att containern når värden. Sätt LIBVIRT_HOST till din Unraid-LAN-IP om det namnet inte går att slå upp (till exempel när containern körs på ett anpassat br0.x-nätverk). Om du ändrat Unraids SSH-port, sätt LIBVIRT_SSH_PORT så att den stämmer. Live-ögonblicksbilder behöver också qemu guest agent i VM:en och disken på /mnt/cache (inte /mnt/user).
Fullständig VM-uppsättning och nätverksguide
Den kompletta steg-för-steg-guiden (SSH-aktivering, beständig nyckelauktorisering, routing för anpassade nätverk och VLAN, metod per VM och felsökning på värdsidan) är guiden för VM-säkerhetskopiering.
Off-site-uppsättning¶
Off-site-kopior går till lagringsmål. Öppna Lagringsmål från dess inställningsbricka (eller fäst den i sidofältet) och välj Lägg till mål. Se Off-site och återställning för hela arbetsflödet (skydd mot radering, manipuleringstest och DR-övningar). I korthet:
- Backends: SMB/CIFS och WebDAV via rclone utan en värdmontering, NFS (montera exporten på värden och använd den som en lokal mapp), inbyggda restic-backends utan rclone (
s3:...,rest:http://host:8000/repo,sftp:user@host:/repo), eller vilken rclone-remote som helst (rclone:<remote>:<bucket>/path). Backblaze B2 har ingen inbyggd backend här: nå det via dess S3-slutpunkt (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>) med nyckel-ID och applikationsnyckel som S3-inloggningsuppgifter. - Inloggningar lagras krypterade, som en lista med sparade inloggningar i kortet Inloggningar under Inställningar, Lagringsmål. En stjärna markerar standarden, som används överallt där ingen inloggning är vald. Ett måls egen sida väljer den det använder i sitt kort Autentiseringsuppgifter. Se Inloggningar.
- SSH-mål behöver ingenting installerat på andra sidan.
sftp:behöver bara en SSH-server. Lägg till den publika nyckeln från Inställningar, Integrationer, Värd-SSH (finns också på/config/ssh/id_ed25519.pub) i målanvändarens~/.ssh/authorized_keys, eller låt Lägg till nyckel i Lägg till mål lägga dit den med kontots lösenord. - rest-server med ett självsignerat certifikat: lägg dess certifikat, eller det från myndigheten som signerade det, som en PEM-fil i mappen
certsi BombVaults datamapp (/config/certsi containern,appdata/bombvault/certspå Unraid). Säkerhetskopior, kopior och testet av skydd mot radering litar på det utan omstart. - Off-site-kopia: BombVault kopierar nya ögonblicksbilder med
restic copyefter bästa förmåga, ovanpå en (oftast lokal) primär. Ett måls kort Kopiera avgör om det kopierar Efter varje säkerhetskopia eller enligt en egen plan, och Inställningar, Schema, Externa kopior per avsnitt ger ett avsnitt en egen kopieringsplan. Replikera nu finns på avsnittets rad i kortet Externa kopior under Inställningar, Lagringsmål. - Flera lagringsmål per avsnitt: kortet Mål per avsnitt på sidan Lagringsmål slår på eller av varje rad från ett avsnitt till ett mål med ett klick, Lokal inkluderad. Ett avsnitt med bara externa mål säkerhetskopierar rakt till dem, och ett med varje rad av säkerhetskopieras inte. Ett måls Regler per avsnitt ger ett avsnitt ett eget repositorium, en egen gallring eller komprimering där.
- Placering per post: varje container, VM och mappuppsättning tänder Lokal och de mål som får dess säkerhetskopior, i kortet Schema och mål på dess flik Inställningar. Poster utan ett eget val följer sitt avsnitt. Se Placering per post.
- Gallring: varje lagringsmål behåller säkerhetskopior enligt sitt kort Hur länge det bevaras, och ett avsnitt kan behålla egna värden där under Regler per avsnitt. Det gäller också kopian i ett avsnitts off-site-fält. Alla noll trimmar aldrig ett måls ögonblicksbilder.
- Bandbreddsgränser: begränsa restics upp- och nedladdningstakt i kortet Off-site-bandbredd under Inställningar, Lagringsmål, eller per mål i dess kort Kopiera. Du anger KiB/s, och fältet visar samma takt i MB/s och Mbit/s.
- Streaming först: välj mediaservrarna i kortet Streaming på sidan Lagringsmål (Plex, Jellyfin och Emby är förvalda efter imagenamn), sändningstakten från vilken en räknas som strömmande, uppladdningsgränsen medan den strömmar och hur länge efter en ström den normala gränsen kommer tillbaka.
- Kall lagringsklass och arkivklass (S3): för ett S3-lagringsmål väljer du en nivå som går att återställa från (Standard, Standard-IA, One Zone-IA, Intelligent-Tiering, Glacier Instant Retrieval) på dess sida. rclone-remotes ställer in sin klass i rclone-konfigurationen.
- Egen mapp i ett lagringsmål i stället för lokalt: ett avsnitts egna mapp kan ligga i ett av lagringsmålen ovan, utan lokal kopia och utan kopieringssteg. Se Ett avsnitts egna mapp.
Avvikelser¶
Avvikelseupptäckt behöver ingen miljövariabel. Den ställs in i kortet Avvikelser under Inställningar, Verifiera, beskrivet på Avvikelser.
Portabla inställningar (export och import)¶
Kortet Exportera / importera inställningar under Inställningar, System skriver hela din BombVault-konfiguration (avsnittsinställningar, lagringsmål, scheman, gallring, aviseringar) till en portabel JSON-fil som du kan importera på en annan instans, så att flytt till en ny box eller kloning av en uppsättning inte betyder att allt matas in för hand igen. Importen visar en förhandsvisning och ber om bekräftelse, och den rör aldrig dina säkerhetskopieringsdata eller din historik. Länkar i filen till lagringsmål eller repositorier som inte finns längre utelämnas, och förhandsvisningen nämner dem. Medan en ZFS-replik körs nekas en import innan något skrivs.
Exporten kan innehålla inloggningsuppgifter
Du väljer om off-site-, aviserings- och MQTT-broker-uppgifterna ska tas med i filen. Med uppgifterna är exporten lika känslig som ditt återställningskit, så förvara den på en säker plats. Utan dem innehåller filen bara inställningar som inte är hemliga.
APP_KEY följer inte med filen
Repositorierna är låsta med ett lösenord som härleds från APP_KEY, och filen innehåller inte nyckeln. Vid en planerad flytt ger du den nya boxen den gamla APP_KEY i dess mall, eller tar över nyckeln med återställningskitet under Nödläge. Med en annan nyckel svarar repositorierna att lösenordet är fel. Inget går förlorat, och när rätt nyckel är satt öppnas de igen.