Konfiguráció¶
Ez az oldal a konténer környezeti változóit, a sablon által biztosított csatolásokat, a biztonsági modellt, a VM-mentést SSH-n keresztül, valamint a telephelyen kívüli beállítást ismerteti. Azt, hogy a mentések hová kerüljenek, az alkalmazáson belül állítod be célokként, nem környezeti változókkal.
Környezeti változók¶
| Változó | Kötelező | Leírás |
|---|---|---|
APP_KEY |
Igen | 32 bájtos hexadecimális titok (64 hexadecimális karakter), amely a restic tároló jelszavának származtatására szolgál. Generáld az openssl rand -hex 32 paranccsal. Óvd ezt: az elvesztése visszaállíthatatlanná teszi a titkosított mentéseket. |
LIBVIRT_HOST |
VM-ekhez és ZFS-adatkészletekhez | Az SSH-n keresztül elért Unraid hoszt a VM- és a ZFS-adatkészlet-mentéshez (sablonmező: Host SSH: Address, alapból host.docker.internal). A sablon a 192.168.x.x helykitöltőt tölti ki előre, ez nem beállítottnak számít. Használd az Unraid LAN IP-jét, egyéni br0.x hálózaton kötelező. Ha a host.docker.internal nem oldható fel, mint egy TrueNAS-alkalmazásban, és a LIBVIRT_URI sem nevez meg hosztot, a BombVault a konténer alapértelmezett átjáróját használja, és az indulási napló megnevezi. |
LIBVIRT_SSH_PORT |
Nem | A hoszt SSH-portja a VM- és a ZFS-adatkészlet-mentéshez (sablonmező: Host SSH: Port, alapból 22). |
LIBVIRT_SSH_USER |
Nem | SSH-felhasználó a hoszton a VM- és a ZFS-adatkészlet-mentéshez (sablonmező: Host SSH: User, alapból root). |
LIBVIRT_URI |
Nem | Teljes libvirt kapcsolati URI, amelyet a rendszer szó szerint használ a fenti három LIBVIRT_* változóból történő összeállítás helyett (ezeket a kapcsolati karakterlánc előállításakor ekkor figyelmen kívül hagyja). Alapból nincs beállítva. TrueNAS Scale-en szükséges, ahol a libvirtd egy nem szabványos socketen figyel, amit az összeállított forma nem tud kifejezni: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. Lásd a VM-mentési útmutatót. Ha ez egy qemu+ssh:// URI, a LIBVIRT_HOST, LIBVIRT_SSH_USER és LIBVIRT_SSH_PORT közül mindegyik, amelyik nincs beállítva, ebből kerül átvételre, a BombVault saját SSH-parancsaihoz is (NVRAM-átvitel, ZFS-adatkészletek). |
PORT |
Nem | HTTP-port (alapból 3000. Csak HTTP_ONLY=true mellett használatos). |
HTTPS_PORT |
Nem | HTTPS-port (alapból 3443. A sablon 1:1 arányban teszi közzé, így a WebUI a https://<ip>:3443 címen válaszol). |
HTTP_ONLY |
Nem | Állítsd true-ra az önaláírt HTTPS-figyelő letiltásához, és csak egyszerű HTTP kiszolgálásához (egy TLS-lezáró reverse proxy mögötti használatra). |
BIND_HOST |
Nem | A cím, amelyen a WebUI figyel (alapból 0.0.0.0, minden interfész). A konténerben hagyd beállítatlanul, mert a közzétett portjai minden interfészt igényelnek. A 127.0.0.1 a Dockeren kívüli futtatáshoz való. A healthcheck ugyanezt a címet kérdezi. |
TRUSTED_PROXY |
Nem | A BombVault előtt álló fordított proxy vesszővel elválasztott címei vagy CIDR-tartományai (például 192.168.20.11 vagy 10.0.0.0/8). Az X-Forwarded-For fejlécet csak ezekről az ugrásokról hisszük el, és a bejelentkezési fék ilyenkor valódi ügyfelenként számolja a hibákat, ahelyett hogy a proxy mögötti mindenkit egy vödörbe tenné. Beállítatlanul (alapértelmezés) senkinek sem hiszünk: a feltétel nélkül elhitt fejléc bárkinek megengedné, hogy saját vödröt válasszon. |
HOST_SOURCE_ROOT |
Nem | A Host Data-ként csatolt hoszt-útvonal (alapból /mnt). A BombVault a Docker által jelentett bind-mount forrásokat lefordítja az ez alatti csatolás útvonalaira. Csak akkor változtasd meg, ha eltérő hoszt-gyökeret csatoltál. |
HOST_MOUNT_ROOT |
Nem | Ahová a Host Data a konténeren belül csatolva van (alapból /host/user). TrueNAS-on a Host Data a saját hoszt-útvonalán van csatolva, ezért ez és a HOST_SOURCE_ROOT is ezt az útvonalat adja meg, például /mnt/tank (lásd: TrueNAS SCALE). |
DATA_ROOT_SEGMENTS |
Nem | Vesszővel elválasztott útvonal-szegmens nevek, amelyek egy bind-mount forrást mentési adatként jelölnek meg (alapból appdata, az Unraid /mnt/user/appdata/<container> konvenciójának megfelelően). Egy konténer bind-mountja automatikusan kiválasztódik mentésre, ha a felsorolt szegmensek közül BÁRMELYIK teljes útvonal-összetevőként megjelenik a hoszt-forrásában. Például a DATA_ROOT_SEGMENTS=appdata,config a .../config csatolást is felveszi. Az illesztés nem tesz különbséget kis- és nagybetű között, így az alapérték a ZimaOS /DATA/AppData/<container> útvonalát is lefedi. A konténer adatmappájának megtalálására szolgáló további, mindig aktív módszerekért lásd: A mentési források felismerése. |
PLATFORM |
Nem | Kikényszeríti, hogy a BombVault milyen platformon fut szerinte, ahelyett hogy automatikusan felismerné: unraid, generic vagy truenas (alapból nincs beállítva: a flash csatolás alatti dockerMan jelző keresésével automatikusan felismeri az Unraidet, egyébként generic. Egy nem felismert érték szintén generic-re esik vissza, naplózva). Állítsd be kifejezetten egy generikus Docker-hoszton vagy TrueNAS Scale-en, ahelyett hogy a csak Unraidre működő automatikus felismerésre hagyatkoznál. Az általános compose-fájl ezt teszi. Megváltoztatja az appdata-tartalék konvenciót, a példányok közötti visszaállítási cél alapértelmezéseit, valamint azt, hogy a csak Unraidre vonatkozó értesítési és kísérő bővítmény lépéseket egyáltalán megkísérli-e (lásd: internal/platform). |
BOMBVAULT_SELF_CONTAINER |
Nem | Magának a BombVault konténernek a neve, hogy soha ne mentse (és így ne állítsa le) önmagát. |
BACKUP_MAX_HOURS |
Nem | A maximális valós idejű órák száma, ameddig egyetlen mentési futás a szakasza zárolását tarthatja, mielőtt kényszerítve megszakadna (egy védelem, hogy egy beragadt futás ne blokkolhassa örökre a szakaszt). Üresen (az alapértelmezett) 48-at használ. Emeld nagyon nagy vagy lassú felhőmentésekhez (egy a korlátnál megszakított futás context deadline exceeded hibával hiúsul meg). Állítsd 0-ra a korlát teljes letiltásához. A nyesésre ugyanez a korlát vonatkozik, egy ellenőrzés vagy nyesés pedig addig fut, amíg a restic jelenti a haladást. |
BACKUP_STALL_HOURS |
Nem | Órák, ameddig egy mentés egyáltalán nem haladhat, mielőtt megszakad. Üresen (az alapértelmezett) 2-t használ. Állítsd 0-ra, hogy elakadás miatt soha ne szakadjon meg. Ez a két védelem közül a finomabb, és általában ez lép működésbe: azt figyeli, történik-e még valami, nem azt, mennyi ideje tart a futás, így egy lassú, de egészséges, több terabájtos mentést békén hagy, míg egy nem válaszoló megosztáson beragadt mentést napok helyett órák alatt leállít. 30 perc csend után, még mielőtt bármi megszakadna, figyelmeztetés kerül a naplóba. A bejárás haladásnak számít: a restic egy nagy fa bejárása közben egyetlen bájtot sem ír, és ezt a szakaszt a fájl- és bájtösszesítői alapján figyeli, nem a kiírt bájtok alapján. A két változó független egymástól, és a BACKUP_MAX_HOURS továbbra is korlátozza a tényleges mentés utáni szakaszokat (megőrzés, statisztikák, telephelyen kívüli másolat), ahol nincsenek figyelhető számlálók. |
DB_DUMP_MAX_HOURS |
Nem | Órák, ameddig egy automatikus adatbázis-dump futhat, mielőtt leállítják. Üresen (az alapértelmezett) 6-ot használ. A megengedett értékek 1-től 48-ig tartanak, és a korlát egy órával a BACKUP_MAX_HOURS alatt marad (két óránál rövidebb érték esetén annak felénél), hogy egy hosszú dumpot a saját korlátja vágjon el és így is jelentsék, ahelyett hogy magával rántaná a mentést. Az a dump, amelyik nem halad tovább, már a BACKUP_STALL_HOURS után leáll. A leállított dump önmagában lesz sikertelen, a konténer mentése pedig folytatódik. Unraidon a változót a BombVault konténerhez az Add another Path, Port, Variable ponttal veszed fel. |
TZ |
Nem | Időzóna az ütemezőhöz (például Europe/Berlin). Ha nincs beállítva, minden ütemezés UTC szerint fut: a 02:30-ra állított ütemezés ekkor 02:30 UTC-kor indul, nem a helyi idő szerint. Unraidon ezt soha nem kell beállítanod: a rendszer a saját időzónáját adja át minden konténernek. Az indulási napló megmondja, melyik zónát állapította meg. Egy nyári időszámítást használó zóna tavasszal kihagy egy futást, ősszel pedig egyet kétszer futtat, az UTC egyiket sem teszi, viszont évente kétszer egy órát elcsúszik az órádhoz képest. |
DATA_DIR |
Nem | Ahol a BombVault az adatbázisát, a kulcsait és a gyorsítótárait tartja (alapból /config). A konténerben hagyd békén. Akkor számít, ha a binárist a Dockeren kívül futtatod. |
FLASH_DIR, FLASH_TEMPLATES_DIR |
Nem | Ahová a flash és a Docker-sablonjai a konténeren belül csatolva vannak (alapból /host/boot és /host/boot/config/plugins/dockerMan/templates-user). Követik a sablon /boot csatolását, ezért hagyd beállítatlanul. |
MODE |
Nem | A full (alapértelmezés) a teljes alkalmazást futtatja. A node egy csomópontot futtat: webes felület és saját ütemezés nélkül, csak azt, amit az anyapéldánya mond neki. Bármely más érték üzenettel leállítja az indulást. Az anyapéldány kitölti helyetted a csomópont compose fájljában. |
NODE_HOME |
Csomóponton | Melyik anyapéldányhoz tartozik a csomópont, az anyapéldány kulcsával és relayével együtt, egyetlen, bvhome1. kezdetű értékként. Az anyapéldány beírja a csomópont compose fájljába. Nélküle a csomópont elindul, de egyetlen anyapéldány sem éri el. Az anyapéldány által átvett csomópont nem indul el, ha a NODE_HOME egy másik anyapéldányt nevez meg, amíg az előző el nem engedi. |
NODE_NAME |
Nem | A csomópont neve, ahogy az anyapéldány a tőled kapott névből kitöltötte. |
Csatolások¶
Csatold a Docker socketet, a flasht (/boot) és a Host Data gyökeret (/mnt), ahogy a CA-sablonban látható. A mentési források és célok egyaránt a Host Data alatt találhatók, és slave módban van csatolva, így egy távoli megosztás, amely a konténer indulása után csatolódik (például a /mnt/remotes alatt), újraindítás nélkül válik láthatóvá.
TrueNAS-on a Host Data egy adatkészlet útvonala, például /mnt/tank, sosem ixVolume. Az adatok, amelyeket egy alkalmazás ixVolume-ban tart, kívül esnek rajta, és nem kerülnek mentésre. Lásd: TrueNAS SCALE.
A ZFS-adatkészletek mentéséhez is ez a mód kell: egy adatkészlet pillanatképét a hoszt csak a konténer indulása után csatolja. Lásd: ZFS-adatkészletek.
A helyi tárolók alapértelmezetten a /mnt/user/bombvault/{container,vms,flash,config,files,zfs} útvonalra mutatnak, és az első mentéskor jönnek létre. Ezek a szakaszok saját mappái, és a Helyi célt alkotják. Ennek oldalán, a Célok alatt a Kapcsolat kártya szakaszonként módosítja a mappát.
Egy szakasz saját mappája egy már meglévő célon is lehet, például egy NAS-on vagy egy S3-vödörben: a cél oldalán a Használat saját mappaként odaköltözteti, és előbb elmondja, mi lesz a már elkészült mentésekkel. Lásd: Egy szakasz saját mappája.
A helyi tárolómappák 0755 és 0644 módon maradnak, hogy egy nem root szinkronfelhasználót SMB-n ne zárjanak ki, a tárolók pedig titkosítottak, így ez nem fed fel semmit. A helyreállítási definíciók minden tárolón belül élnek, így egy lemásolt mappa önmagában teljes. Az önmentés tárolója csak a root számára olvasható marad.
Hosztintegráció-ellenőrzés
Az áttekintés Hosztintegráció kártyája (a Testreszabás alatt adható hozzá) minden csatolást és CLI-t megvizsgál (Docker socket, libvirt, restic, qemu-img, rclone), és jelenti a hiányzó darabokat.
A mentési források felismerése¶
Minden konténernél a BombVault maga választja ki, mely bind csatolások és nevesített kötetek kerülnek mentésre. Egy útvonal akkor kerül be, ha az alábbiak bármelyike teljesül (az eredményt bármikor felülírhatod a konténer Beállítások lapján lévő Mentett mappák kártyán):
- Találat egy adatgyökér-szakaszra: a bind hoszt oldali forrása a
DATA_ROOT_SEGMENTSvalamelyik szakaszát teljes útvonalelemként tartalmazza (alapértelmezés szerint csakappdata). - A nevesített Docker-kötetek mindig bekerülnek, mert nincs eldobható megfelelőjük, így nincs mit kiszűrni, de csak akkor, ha a kötet valódi tárolási útvonala a hoszton maga is elérhető a Host Data csatoláson át, pontosan úgy, mint bármely más hoszt-útvonal, amit a BombVault ment. A helyi kötetek alapértelmezett meghajtója a kötetet a démon saját adatgyökere alá teszi, vagyis a
/var/lib/docker/volumes/<név>/_datahelyre, hacsak nem módosítottad (ellenőrizd adocker info -f '{{.DockerRootDir}}'paranccsal). Ezt a helyet nem fedi le az az egyetlen könyvtárból álló szűk Host Data csatolás, amit az általánosdocker-compose.ymlalapból használ. Az elérhetetlen kötet csendben kimarad, ez nem hiba. Ahhoz, hogy általános hoszton a nevesített kötetek tényleg mentésre kerüljenek, irányítsd a Host Data csatolást (és aHOST_SOURCE_ROOTértéket) egy olyan közös szülőkönyvtárra, amely a Docker adatgyökerét is lefedi. A mérlegelést a compose fájl Host Data megjegyzése írja le (az Unraid ezt úgy kerüli meg, hogy ugyanezért az egész/mntkönyvtárat csatolja, a saját, legfelső szintű általános szokása szerint). - Docker Compose projektkönyvtár: ha a konténeren ott a szokásos
com.docker.compose.project.working_dircímke (adocker compose upautomatikusan felteszi), az a könyvtár is bekerül, függetlenül attól, hogy bármelyik bind illeszkedett-e egy adatgyökér-szakaszra. - Felülbírálás a
bombvault.datacímkével: tedd a konténerre abombvault.data=truecímkét, hogy az összes bind csatolása bekerüljön, olyan elrendezéshez, amit a fenti két szokás egyike sem fog meg (például egyetlen/srv/plex/configbind Compose projekt nélkül). Minden nem üres,false-tól különböző érték igaznak számít. Hiányzó címke vagybombvault.data=falsesemmit nem változtat. bombvault.dbdumpcímke: tedd a konténerre abombvault.dbdump=falsecímkét, hogy kikapcsold az automatikus adatbázis-dumpját (0,noésoffugyanezt teszi), vagy nevezd meg a motort (postgres,mysql,mariadb), hogy olyan konténerről készüljön dump, amelyet a BombVault magától nem ismer fel. A címke erősebb a konténer Beállítások lapján lévő Adatbázis kártya kapcsolójánál, ami Unraidon a megszokott út.
Biztonsági modell¶
Root-szintű vezérlés a hoszt felett
A Docker socketen keresztül a BombVault le tud állítani, el tud távolítani és újra létre tud hozni konténereket, valamint olvasni és írni tudja az appdatát, a VM-mentéshez pedig SSH-n keresztül bejelentkezik a hosztra (qemu+ssh://, alapból root), hogy futtassa a virsh parancsot. Aki eléri a webes felületét, annak gyakorlatilag root-jogosultsága van a hoszton.
Bejelentkezés¶
- Opcionális jelszóvédelem (a Jelszó kártya a Beállítások, Biztonság alatt): állíts be jelszót a bejelentkezés megköveteléséhez, töröld a kikapcsoláshoz. Alapértelmezés szerint kikapcsolva, megbízható LAN-on való használatra. A jelszót Argon2id tárolja egy
APP_KEY-jel borsozott érték felett, így egy lemásolt/configkulcs nélkül értéktelen, kulccsal pedig lassú támadni. Az új jelszónak legalább 12 karakteresnek kell lennie. Egy meglévő rövidebb a módosításig tovább működik. A munkamenetek aláírtak (azAPP_KEY-ből származtatott HMAC), a jelszó módosítása érvényteleníti őket. A bejelentkezések ügyfelenként percenként öt sikertelen próbálkozásra vannak korlátozva. A jelszó módosításához vagy törléséhez meg kell adni a régit a Jelenlegi jelszó mezőben, bekapcsolt kétlépcsős azonosításnál pedig a kódot is. - Néhány dolog jelszót kér. A helyreállítási csomag, a hibajelentés és egy flash-mentés ZIP-jének letöltése, egy flash-mentés vagy önmentés exportálása, a kulcs letétbe helyezése egy kulcsőrzőnél, egy letét kiadásának engedélyezése, új feloldókód készítése, a beállítások exportálása hitelesítő adatokkal, a kétlépcsős azonosítás, a hozzáférési kulcsok, egy csomópont hozzáadása, egy csomópont compose fájljának újbóli megjelenítése és egy csomópont elemeinek megnyitása addig le vannak tiltva, amíg nincs beállítva bejelentkezési jelszó, és magán a példányon kell hozzájuk bejelentkezni. A mentések törlése jelszó nélkül is működik. Ha van jelszó, ehhez is ez a bejelentkezés kell.
- A cél nem mutat jelszót. Egy cél tartalmazhat bejelentkezést, mint a
rest:https://user:password@host/repoesetében, és minden oldal és API-válaszrest:https://[redacted]@host/repoformában mutatja, bejelentkezési jelszóval vagy anélkül. Ha a mögötte lévő útvonalat módosítod, a tárolt jelszó megmarad. Ha a célt egy másik szerverre akarod irányítani, írd be a teljes célt a jelszavával együtt, mert a rejtett jelszó a saját szerverénél marad. - Kétlépcsős azonosítás (Beállítások, Biztonság): időalapú kód egy hitelesítő alkalmazásból a jelszó mellé, továbbá nyolc egyszer használatos helyreállítási kód, amelyeket a bekapcsoláskor egyszer adunk ki. A közös titkot
APP_KEY-jel titkosítva tároljuk, a kikapcsoláshoz pedig aktuális kód kell. - Hozzáférési kulcsok (WebAuthn): saját kártyán jelennek meg, amint van beállított jelszó, a jelszó mellett és soha nem helyette, így az összes hozzáférési kulcs eltávolítása senkit sem zár ki. Valódi domainnév és a böngésző által megbízhatónak tartott tanúsítvány kell hozzájuk. Az alapértelmezett
https://<ip>:3443pontosan az, amit a WebAuthn elutasít, és a kártya ezt meg is mondja, ahelyett hogy egy kudarcra ítélt gombot kínálna. Bekapcsolt kétlépcsős azonosításnál a hozzáférési kulcsnak ellenőriznie kell a PIN-kódodat, az ujjlenyomatodat vagy az arcodat, különben a bejelentkezés a kódot is kéri. - A konfiguráció visszaállítása (Beállítások visszahozása a Vészvarázslóban) lezár minden munkamenetet, eltávolít minden hozzáférési kulcsot, és visszavon minden API-tokent és MCP-kulcsot, mert a visszahozott beállítások olyanokat is visszahozhatnának, amelyeket a mentésük után eltávolítottak. Jelentkezz be a jelszóval, és állítsd be újra a hozzáférési kulcsaidat a Beállítások, Biztonság alatt.
- Az elfelejtett jelszó a bejelentkezési oldalon állítható vissza. Az Elfelejtetted a jelszót? gombra a BombVault egy 12 karakteres, három négyes csoportból álló kódot ír a konténere naplójába (Unraidon: Docker fül, BombVault ikon, Logs). Ezzel a kóddal és egy új jelszóval be vagy jelentkezve. A visszaállítás a kétlépcsős azonosítást is kikapcsolja, eltávolít minden hozzáférési kulcsot, visszavon minden API-tokent, MCP-kulcsot és OAuth-bejelentkezést, lezár minden más munkamenetet, kijelentkeztet minden párosított telefont, és kikapcsolja a telefonok párosítását. Az ezt követő oldal megmutatja, mi tűnt el. Egy kód 10 percig érvényes, és a hibás próbálkozások nem használják el. A widget- és metrikatokenek megmaradnak, mert csak olvasnak.
- Aki olvasni tudja a konténer naplóját, az vissza tudja állítani a jelszót. Ez a hoszt rootja, de egy naplómegjelenítő is, például a Dozzle, bármely konténer, amely hozzáfér a Docker-sockethez (a csak olvasás is elég), és egy naplótovábbító, amely továbbküldi a konténerek kimenetét. Ilyen hozzáférést csak annak adj, akire a jelszót is rábíznád. Aki csak a webes felületet éri el, sosem látja a kódot.
Telefonok és csoporttagok¶
- A párosított telefonok egy engedélyezőlistát érnek el. Az a telefon, amely ismeri a csoport tizenkét szavát, jelszó nélkül bejelentkezik, amíg a Beállítások, Biztonság alatti Android-alkalmazás kártyán be van kapcsolva az A telefonok párosíthatók a csoport tizenkét szavával kapcsoló. A munkamenete csak azt éri el, amit az alkalmazás mutat: az áttekintést, a futásokat, a megtekinthető, indítható és visszaállítható mentéseket, az elolvasható anomáliákat és a Példányok oldalt megtekintésre. A célok és a parancsok a címeik és titkaik nélkül jutnak el hozzá, az eredetit felváltó visszaállítás pedig előbb lementi a jelenlegi állapotot. A mappába történő visszaállítás csak egy új vagy üres mappát fogad el a visszaállítási mappán belül, és a telefon más mappába nem láthat bele. Minden más azt válaszolja, hogy magán a példányon kell bejelentkezni: kulcsok, a helyreállítási csomag, kulcsletétek, beállítások, mentések törlése. A jelszó visszaállítása kikapcsolja a telefonok párosítását, amíg újra be nem kapcsolod. Az a telefon, amelyet eltávolítottak a Példányok oldalról, vagy amelynél a részleteiben kikapcsolták az Ennek a példánynak a lekérdezése kapcsolót, azonnal elveszíti a munkamenetét, az eltávolított telefon pedig, ha újra megnyitja az alkalmazását, kikapcsolva tér vissza.
- Otthonról távol a telefon a relayn át nyitja meg az oldalakat. Az oldal minden kérése le van zárva a csoport kulcsával, amelyet a relay nem tud elolvasni vagy módosítani, és alá van írva a telefon saját kulcsával, amelyet a szerver a telefon első hívásakor rögzít, majd beengedi, amint valaki jóváhagyja a telefont a párosítási oldalon. A szerver egy kérést csak egyszer és csak addig hajt végre, amíg friss. Csak olyan telefonnak válaszol, amely szerepel a Példányok oldalon, amíg be van kapcsolva a telefonok párosítása, és csak olyan munkamenettel, amelyet ennek a telefonnak adott, ezért a mindenhonnan való kijelentkezés és a jelszó visszaállítása ezeket az oldalakat is lezárja. A szerver minden választ aláír, az alkalmazás pedig ellenőrzi az aláírást azzal a kulccsal, amelyet ahhoz a szerverhez rögzített, és figyelmeztet, ha a kulcs megváltozik. Egy ilyen oldal ugyanazt az engedélyezőlistát éri el, mint egy párosított telefon, bejelentkezési jelszóval vagy anélkül, és ezen felül a bejelentkezési állapotot, amelyet az oldal elsőként olvas. A be- és kijelentkezés, a jelszó visszaállítása és a letöltések a szerver saját címén maradnak, és egy válasz legfeljebb 16 MB lehet.
- A tagok aláírják, amit kérnek. A szerepkérések és válaszaik, a célajánlatok, a restic-jelszó kiadása egy fogadónak vagy lehívónak, a fogadó bejelentkezései és a kulcsletétek a tagok egy-egy kulcsával vannak aláírva, amelyet egy példány az első találkozáskor rögzít az adott tagról. A más kulccsal aláírt hívást elutasítja. A Kulcs elfelejtése egy példány részleteiben eldobja a rögzített kulcsot, arra az esetre, ha az itt ismert nem a tag saját kulcsa. A tagtól a következő aláírt hívásnál újra elkéri a kulcsát. A BombVault 9.x-en futó tagok nem írnak alá, és bárki megszemélyesítheti őket, aki ismeri a szavakat, ahogy a 9.9-ben. Egy 10.4-es vagy régebbi verziót futtató tag szerepkérését vagy célajánlatát elutasítja, amíg azt a tagot nem frissítik.
- A tizenkét szó jelszó. Aki ismeri őket, csatlakozik a csoporthoz, látja a tagok védettségi állapotát, és szerepköröket kérhet, amelyeket a másik példányon még egy embernek engedélyeznie kell. Bejelentkezési jelszó nélkül bárki elolvashatja őket, aki megnyitja a webes felületet, és a párosítási kártya ezt jelzi, amíg nincs jelszó.
Kulcsok¶
- Az APP_KEY két dolgot tesz. Lezárja, amit ez a telepítés tárol (jelszavak, bejelentkezések, tokenek), és ez a mentések kulcsa: ebből származik a restic jelszava, és a konténer- és VM-definíciók is ezzel vannak lezárva.
- Az átvett kulcs külön marad. Amikor a Vészvarázsló átveszi egy másik szerver mentéseit, ez a telepítés a saját APP_KEY-jével zár tovább, a másik szerver kulcsát pedig mentési kulcsként tárolja, ugyanúgy lezárva, mint minden más titkot. A helyreállítási csomag ekkor mindkettőt kiírja. Ha az APP_KEY-t utólag megváltoztatod, a mentési kulcs már nem nyitható ki: a BombVault leáll a mentéssel, és a Figyelmet igényel alatt jelzi, ahelyett hogy rossz kulccsal írna. Töltsd fel újra a helyreállítási csomagot a Visszaállítás, Vészhelyzet alatt, vagy állítsd vissza az APP_KEY-t. Lásd: Vészvarázsló.
- A titkosítás alapból be van kapcsolva (Mentések titkosítása a Beállítások, Biztonság alatti Titkosítás kártyán). A mentéseket a restic titkosítja, a mentési kulcsból származtatott jelszóval.
- Kulcsletétek. A csoportod egy kulcsőrzője a szerver helyreállítási csomagjának lezárt másolatát tartja, amelyet maga nem tud kinyitni. Csak a 20 karakteres feloldókód nyitja ki, és az őrző csak akkor adja ki, ha valaki ott megnyomja az Engedélyezés gombot. Lásd: Kulcsőrző.
Csomópontok¶
A csomópont egy webes felület nélküli BombVault, amely egy anyapéldánytól kapja az utasításait.
- Az anyapéldány tartja a csomópontot. A csomópont csatolja a szervere Docker-socketjét, ami ott root jogot jelent, és az anyapéldány irányítja a csomópontot. Ha valaki átveszi az anyapéldányt, az összes csomópontját is irányítja. Adj az anyapéldánynak bejelentkezési jelszót, és tartsd a webes felületét távol az internettől.
- A csomóponton kevés van. Ha valaki átvesz egy csomópontot, nem kapja meg a párosítási csoportot, az erődöt, más csomópontot vagy más tárolót. A csomópontnak csak az anyapéldányához vezető kapcsolata van, egy saját bejelentkezése a fogadószerveren és egy saját mappája egy célban. A fogadószerveren nem tud előzményeket törölni, mert a szerver append-only. Meg tudja tölteni a szerver lemezét, mert a rest-server nem állít be kvótát, ezért adj a fogadószervernek elég helyet vagy saját megosztást. Egy célban a bejelentkezésével általában törölni tudja, ami ott van. A csomóponton őrzött mentések a támadó kezében vannak, ezért hív le róluk másolatot az anyapéldány.
- A kapcsolat privát és aláírt. Az anyapéldány és a csomópont a relayen át egy saját kapcsolaton beszél, amelyet a csomópont
APP_KEYkulcsából származtatott titok zár le. Mindkét fél már az első hívás előtt ismeri a másik kulcsát, ezért nincs jóváhagyási lépés. Az anyapéldány minden hívást a saját kulcsával és egy számlálóval ír alá, a csomópont pedig elutasítja azt a hívást, amelyet nem az anyapéldány írt alá, vagy amelyet már egyszer fogadott. A csomópont a köszönésén kívül semmit sem hív az anyapéldányon. - Az anyapéldány egy rögzített listát ér el. Az anyapéldány által a csomópontnak továbbított kérések csak a csomópont útvonalainak rögzített listáján futnak, amely a
GET /api/nodes/routescímen látható, és a csomópont csak JSON-nal válaszol rájuk. A listán semmi sem töröl, és semmi sem éri el a beállításokat, a tárolót, a kulcsokat, a csoportot vagy a tokeneket. Az anyapéldányon jelszavas bejelentkezés kell hozzájuk: a párosított telefonok, az API-tokenek és az MCP-kulcsok nem érnek el csomópontot. Az így indított mentések és visszaállítások az anyapéldány indításaként jelennek meg. - A kulcsletétek a csomópontok kulcsait is viszik. Az anyapéldány megőrzi minden csomópont
APP_KEYkulcsát, a helyreállítási csomag pedig kiírja a Csomópontok fejezetében, így a kulcsletét is tartalmazza. Az a kulcsőrző, amely megkapja a letétet és a feloldókódot, meg tudja nyitni a csomópontjaid tárolóit, de csomópontot nem tud utasítani, mert ahhoz az anyapéldány aláírása kell. - Az elengedés végleges. Az elengedett csomópont ugyanazzal az
APP_KEYkulccsal nem fogad el újra anyapéldányt. Az a csomópont, amely távol van, amikor elengeded, akkor értesül róla az anyapéldánytól, amikor visszatér.
Hálózat¶
- A módosításokhoz JSON kell. Egy kérésnek, amely módosít valamit,
Content-Type: application/jsonfejlécet kell küldenie, és a böngésző nem jelölheti cross-site kérésnek, így egy másik webhely oldala nem veheti rá a böngésződet, hogy egy LAN-címen beállításokat módosítson. Az API-t vezérlő szkript küldi ezt a fejlécet. Minden mást415kóddal elutasít. - Mivel a védelem opcionális, ha nincs beállítva, a teljes felület és API (beleértve a célokat, a manipulációs teszt útvonalait és a visszaállítási útvonalakat) elérhető bárki számára, aki eléri a portot. Állíts be bejelentkezési jelszót, amint telephelyen kívüli, append-only mentések vagy titkosítás van használatban.
- A BombVaultot csak megbízható, nem kitett hálózaton futtasd. A távoli hozzáféréshez tedd egy reverse proxy mögé, amely hitelesítést és TLS-t ad hozzá. A válaszok alapszintű biztonsági fejléceket hordoznak (CSP,
nosniff,X-Frame-Options,Referrer-Policy). - Fordított proxy mögött minden kérés a proxy címét viseli, így
TRUSTED_PROXYnélkül a fék minden ügyfelet egy vödörben számol, és egy támadó hibái téged is kizárnak. Add meg a proxyt aTRUSTED_PROXYértékeként, hogy visszatérjen az ügyfelenkénti számolás. - A BombVault előtti fordított proxynak tovább kell adnia az
Authorizationvagy azX-API-Keyfejlécet a/mcpfelé, és nem pufferelheti a válaszokat, különben az asszisztensek nem tudnak csatlakozni. Lásd: MCP-kiszolgáló. - Az MCP-végpont (
/mcp)404-et ad, amíg nincs kulcs, vagy amíg nincs bekapcsolva az OAuth-bejelentkezés, és minden klienstől elkéri a kulcsát vagy tokenjét akkor is, ha a bejelentkezési jelszó ki van kapcsolva. Egyetlen cím sem kivétel, alocalhostsem. Nincsenek visszaállító vagy törlő eszközei, és egy konfigurációs mentés visszaállítása minden kulcsot visszavon. Lásd: MCP-kiszolgáló. - A
HTTP_ONLY=truemellett a munkamenet-süti elveszíti aSecurejelzőjét (muszáj, hogy egyszerű HTTP-n működjön), így csak egy TLS-lezáró proxy mögött kapcsold be a jelszót, ha a bizalmasság számít. - A VM-mentés SSH-kapcsolata az első kapcsolatfelvételkor megbízik a hoszt-kulcsban (TOFU), és utána rögzíti. Ellenőrizd a hoszt kulcsát sávon kívül, ha a konténer-hoszt útvonalad nem megbízható.
- A linkek nem vezetnek ki a csatolásból. Egy mentés vagy egy helyben történő visszaállítás üzenettel leáll, ha az útvonala fölött egy link kivezet a hoszt csatolásából, mert egy konténer, amely a saját megosztásába ír, elhelyezhetne ott egy ilyet. Az a mentési cél, amelynek hosztja vagy rclone-remote-ja kötőjellel kezdődik, ugyanígy elutasításra kerül, mentéskor és a következő futáskor is, mert az
sshvagy azrclonekapcsolóként olvasná.
MCP-kiszolgáló¶
Az MCP-kiszolgálóhoz nem kell környezeti változó. Úgy kapcsolod be, hogy létrehozol egy kulcsot a Beállítások, Integrációk, MCP-kiszolgáló részen, és a /mcp útvonalon válaszol ugyanazon a porton, mint a webes felület (például https://192.168.1.10:3443/mcp). Aktív kulcs nélkül ez az útvonal 404-gyel válaszol. A klienseket, a tanúsítványokat és a korlátokat az MCP-kiszolgáló oldal írja le.
VM-mentés SSH-n keresztül¶
A BombVault a KVM/libvirt VM-eket bármely libvirt-útvonal csatolása nélkül menti. A virsh parancsot a hoszton, SSH-n keresztül futtatja (qemu+ssh://), így soha nem tudja befolyásolni a hoszt VM Managerét.
A hoszt libvirt-socketjének csatolása egy konténerbe Unraidon törékeny megoldás: ezeket az útvonalakat a VM Manager kezeli, és az „Enable VMs” átkapcsolása után előfordulhat, hogy a libvirt nem tud elindulni. Az SSH-kulcs root-jogot ad a hoszton, vagyis ugyanakkora bizalmat, mint a Docker socket, amelyet a BombVault már most is használ.
Gyors beállítás:
- Beállítások, Integrációk, Gazdagép SSH: másold ki a megjelenített nyilvános kulcsot.
- Fűzd hozzá az Unraid
/root/.ssh/authorized_keysfájljához (a flashre is mentve, így túléli az újraindításokat). - Kattints a Kapcsolat tesztelése gombra.
A sablon hozzáadja a --add-host=host.docker.internal:host-gateway opciót, hogy a konténer elérhesse a hosztot. Állítsd a LIBVIRT_HOST-ot az Unraid LAN IP-jére, ha ez a név nem oldódik fel (például amikor a konténer egyéni br0.x hálózaton fut). Ha megváltoztattad az Unraid SSH-portját, állítsd be a LIBVIRT_SSH_PORT-ot, hogy egyezzen. Az élő pillanatképekhez ezen felül szükség van a qemu guest agentre a VM-ben, és arra, hogy a lemez a /mnt/cache-en (ne a /mnt/user-en) legyen.
Teljes VM-beállítási és hálózati útmutató
A teljes, lépésről lépésre útmutató (SSH engedélyezése, tartós kulcs-engedélyezés, egyéni hálózati és VLAN-útválasztás, VM-enkénti módszer és hoszt-oldali hibaelhárítás) a VM-mentési útmutató.
Telephelyen kívüli beállítás¶
A telephelyen kívüli másolatok célokra kerülnek. Nyisd meg a Célok oldalt a beállítási csempéjéről (vagy tűzd az oldalsávra), és válaszd a Cél hozzáadása gombot. A teljes munkafolyamathoz (törlésvédelem, manipulációs tesztelés és DR-próbák) lásd: Telephelyen kívüli mentés és helyreállítás. Röviden:
- Backendek: SMB/CIFS és WebDAV az rclone-on át, hoszt-csatolás nélkül, NFS (csatold az exportot a hoszton, és használd helyi mappaként), natív restic backendek rclone nélkül (
s3:...,rest:http://host:8000/repo,sftp:user@host:/repo), vagy bármely rclone remote (rclone:<remote>:<bucket>/path). A Backblaze B2-nek itt nincs saját backendje: az S3-végpontján keresztül érhető el (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>), a kulcsazonosítóval és az alkalmazáskulccsal mint S3-hitelesítő adatokkal. - A bejelentkezések titkosítva tárolódnak, az elmentett bejelentkezések egyetlen listájaként, a Beállítások, Célok alatti Bejelentkezések kártyán. Egy csillag jelöli az alapértelmezettet, amelyet ott használ, ahol nincs kiválasztva bejelentkezés. A cél saját oldalán a Hitelesítő adatok kártyán választod ki a használtat. Lásd: Bejelentkezések.
- Az SSH-célokhoz semmit sem kell telepíteni a túloldalon. Az
sftp:csak egy SSH-szervert igényel. Add hozzá a nyilvános kulcsot a Beállítások, Integrációk, Gazdagép SSH alól (a/config/ssh/id_ed25519.pubalatt is) a célfelhasználó~/.ssh/authorized_keysfájljához, vagy hagyd, hogy a Cél hozzáadása ablakban a Kulcs hozzáadása a fiók jelszavával tegye oda. - Önaláírt tanúsítványú rest-server: tedd a tanúsítványát, vagy az őt aláíró hitelesítésszolgáltatóét, PEM-fájlként a BombVault adatmappájának
certsmappájába (/config/certsa konténerben,appdata/bombvault/certsUnraidon). A mentések, a másolatok és a törlés elleni védelem tesztje újraindítás nélkül megbíznak benne. - Telephelyen kívüli másolat: a BombVault az új mentéseket
restic copysegítségével, legjobb szándék szerint másolja, egy (általában helyi) elsődleges tároló mellé. A cél Másolás kártyáján állítod be, hogy Minden mentés után másol-e, vagy saját terv szerint, a Beállítások, Ütemezések, Telephelyen kívüli másolatok szakaszonként pedig egy szakasznak saját másolási tervet ad. A Replikálás most a szakasz sorában van a Telephelyen kívüli másolatok kártyán a Beállítások, Célok alatt. - Több cél szakaszonként: a Célok oldalon a Célok szakaszonként kártya egy kattintással be- vagy kikapcsolja az egyes sorokat egy szakasztól egy célig, a Helyit is. Az a szakasz, amelynek csak telephelyen kívüli céljai vannak, közvetlenül oda ment, az a szakasz pedig, amelynek minden sora ki van kapcsolva, nem kap mentést. A cél Szabályok szakaszonként kártyája egy szakasznak saját tárolót, megőrzést vagy tömörítést ad ott.
- Elhelyezés elemenként: minden konténer, VM és mappakészlet világítja be a Helyit és azokat a célokat, amelyek megkapják a mentéseit, a Beállítások lapján az Ütemezés és cél kártyán. A saját választás nélküli elemek a szakaszukat követik. Lásd: Elhelyezés elemenként.
- Megőrzés: minden cél a Meddig őrizze meg kártyája szerint tartja meg a mentéseket, és egy szakasz ott a Szabályok szakaszonként alatt saját értékeket tarthat. Ez a szakasz telephelyen kívüli mezőjében lévő másolatra is érvényes. Ha minden érték nulla, a cél pillanatképeit soha nem nyesi.
- Sávszélesség-korlátok: korlátozd a restic fel- és letöltési sebességét a Beállítások, Célok alatti Telephelyen kívüli sávszélesség kártyán, vagy célonként a Másolás kártyán. KiB/s értéket adsz meg, és a mező ugyanazt a sebességet MB/s-ban és Mbit/s-ban is kiírja.
- Elsőbbség a streamelésnek: a Célok oldal Streamelés kártyáján választod ki a médiaszervereket (a Plex, Jellyfin és Emby a képnév alapján előre ki van jelölve), azt a küldési sebességet, amelytől egy szerver streamelőnek számít, a streamelés alatti feltöltési korlátot, és hogy egy stream után mennyi idővel tér vissza a szokásos korlát.
- Hideg és archív tárolási osztály (S3): egy S3 célhoz válassz egy visszaállításra olvasható szintet (Standard, Standard-IA, One Zone-IA, Intelligent-Tiering, Glacier Instant Retrieval) az oldalán. Az rclone remote-ok a saját osztályukat az rclone konfigban állítják be.
- Saját mappa egy célon helyi helyett: egy szakasz saját mappája a fenti célok egyikén is lehet, helyi másolat és másolási lépés nélkül. Lásd: Egy szakasz saját mappája.
Anomáliák¶
Az anomáliák felismeréséhez nem kell környezeti változó. A Beállítások, Ellenőrzés alatti Anomáliák kártyán állítod be, az Anomáliák oldalon leírva.
Hordozható beállítások (exportálás és importálás)¶
A Beállítások exportálása / importálása kártya a Beállítások, Rendszer alatt a teljes BombVault-konfigurációdat (szakaszbeállítások, célok, ütemezések, megőrzés, értesítések) egy hordozható JSON-fájlba írja, amelyet egy másik példányon importálhatsz, így egy új gépre költözés vagy egy beállítás klónozása nem jelenti azt, hogy mindent kézzel kell újra beírni. Az importálás előnézetet mutat és megerősítést kér, és soha nem érinti a mentési adataidat vagy előzményeidet. A fájlban lévő, már nem létező célokra vagy tárolókra mutató hivatkozásokat kihagyja, és az előnézet megnevezi őket. Amíg egy ZFS-replika fut, az importálást elutasítja, mielőtt bármit írna.
Az export hitelesítő adatokat tartalmazhat
Te választod meg, hogy belefoglalod-e a telephelyen kívüli, értesítési és MQTT-bróker hitelesítő adatokat a fájlba. A hitelesítő adatokkal együtt az export olyan érzékeny, mint a helyreállítási csomagod, ezért tárold biztonságos helyen. Nélkülük a fájl csak nem-titkos beállításokat tartalmaz.
Az APP_KEY nem utazik a fájllal
A tárolók egy APP_KEY-ből származtatott jelszóval vannak lezárva, és a fájl nem tartalmazza. Tervezett költözéskor add meg az új gépnek a sablonjában a régi APP_KEY-t, vagy vedd át a kulcsot a helyreállítási csomaggal a Vészhelyzet alatt. Más kulccsal a tárolók hibás jelszót jeleznek. Semmi sem vész el, és a helyes kulcs beállítása újra megnyitja őket.