Přeskočit obsah

Konfigurace

Tato stránka popisuje proměnné prostředí kontejneru, připojení, která poskytuje šablona, bezpečnostní model, zálohování VM přes SSH a nastavení mimo lokalitu. Kam se zálohy ukládají, se nastavuje přímo v aplikaci jako cíle, ne proměnnými prostředí.

Proměnné prostředí

Proměnná Povinná Popis
APP_KEY Ano 32bajtové hex tajemství (64 hex znaků) použité k odvození hesla k restic repozitáři. Vygeneruj pomocí openssl rand -hex 32. Uchovej v bezpečí: jeho ztráta učiní šifrované zálohy neobnovitelnými.
LIBVIRT_HOST Pro VM a datové sady ZFS Hostitel Unraidu dosažený přes SSH pro zálohu VM (výchozí host.docker.internal; šablona předvyplní zástupný symbol LAN IP). Použij svou LAN IP Unraidu, povinné na vlastní síti br0.x. Používá se i pro zálohy datových sad ZFS (pole šablony Host SSH: Address); zástupná hodnota 192.168.x.x se bere jako nenastavená. Když se host.docker.internal nepřeloží, jako v aplikaci TrueNAS, a ani LIBVIRT_URI neuvádí hostitele, BombVault použije výchozí bránu kontejneru a startovní log ji uvede.
LIBVIRT_SSH_PORT Ne SSH port hostitele pro zálohu VM (výchozí 22). Pole šablony Host SSH: Port, platí i pro datové sady ZFS.
LIBVIRT_SSH_USER Ne SSH uživatel na hostiteli pro zálohu VM (výchozí root). Pole šablony Host SSH: User, platí i pro datové sady ZFS.
LIBVIRT_URI Ne Úplné URI připojení k libvirt, použité doslovně místo sestavení ze tří výše uvedených proměnných LIBVIRT_* (ty se pak pro sestavení URI ignorují). Ve výchozím stavu nenastaveno. Potřebné na TrueNAS Scale, jehož libvirtd naslouchá na nestandardním socketu, který sestavená podoba nedokáže vyjádřit: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. Viz průvodce zálohou VM. Je-li to URI qemu+ssh://, převezme se z něj každá z proměnných LIBVIRT_HOST, LIBVIRT_SSH_USER a LIBVIRT_SSH_PORT, která není nastavená, i pro vlastní SSH příkazy BombVaultu (přenos NVRAM, datové sady ZFS).
PORT Ne HTTP port (výchozí 3000. Použit jen s HTTP_ONLY=true).
HTTPS_PORT Ne HTTPS port (výchozí 3443. Šablona jej publikuje 1:1, takže WebUI odpovídá na https://<ip>:3443).
HTTP_ONLY Ne Nastav true pro zakázání samopodepsaného HTTPS listeneru a obsluhu pouze prostého HTTP (pro použití za reverzní proxy terminující TLS).
BIND_HOST Ne Adresa, na které WebUI naslouchá (výchozí 0.0.0.0, všechna rozhraní). V kontejneru ji nenastavuj, jeho publikované porty potřebují všechna rozhraní. 127.0.0.1 se hodí pro běh mimo Docker. Healthcheck se ptá na stejnou adresu.
TRUSTED_PROXY Ne Čárkami oddělené adresy nebo rozsahy CIDR reverzní proxy před BombVaultem (například 192.168.20.11 nebo 10.0.0.0/8). Jen z těchto uzlů se věří hlavičce X-Forwarded-For a omezení přihlašování pak počítá neúspěchy na skutečného klienta místo toho, aby všechny za proxy házelo do jednoho pytle. Nenastaveno (výchozí) znamená nevěřit nikomu: bezpodmínečně věřená hlavička by každému volajícímu dovolila zvolit si vlastní počítadlo.
HOST_SOURCE_ROOT Ne Hostitelská cesta připojená jako Host Data (výchozí /mnt). BombVault překládá zdroje bind-mountů, které Docker hlásí, na cesty pod tímto připojením. Změň jen pokud jsi připojil jiný kořen hostitele.
HOST_MOUNT_ROOT Ne Kde je Host Data připojeno uvnitř kontejneru (výchozí /host/user). Na TrueNAS je Host Data připojeno pod svou vlastní cestou hostitele, takže tato proměnná i HOST_SOURCE_ROOT uvádějí tutéž cestu, například /mnt/tank (viz TrueNAS SCALE).
DATA_ROOT_SEGMENTS Ne Čárkou oddělené názvy segmentů cesty, které označují zdroj bind-mountu jako zálohovaná data (výchozí appdata, podle konvence Unraidu /mnt/user/appdata/<container>). Bind-mount kontejneru je pro zálohu automaticky vybrán, když se KTERÝKOLI uvedený segment objeví jako celý segment cesty jeho zdroje na hostiteli. Například DATA_ROOT_SEGMENTS=appdata,config zachytí i připojení .../config. Další, vždy aktivní způsoby, jak se najde datová složka kontejneru, viz Detekce zdroje zálohy.
PLATFORM Ne Vynutí platformu, na které BombVault předpokládá, že běží, místo automatické detekce: unraid, generic nebo truenas (výchozí nenastaveno: automaticky detekuje Unraid hledáním jeho značky dockerMan pod připojením flash, jinak generic. Nerozpoznaná hodnota se rovněž vrátí na generic, což se zaznamená do logu). Nastav ji explicitně na obecném Docker hostiteli nebo na TrueNAS Scale, místo spoléhání na automatickou detekci dostupnou jen pro Unraid. Obecný compose soubor to tak dělá. Mění konvenci náhradního umístění appdata, výchozí cíle obnovy mezi instancemi a to, zda se vůbec zkouší kroky oznámení/doprovodného pluginu dostupné jen pro Unraid (viz internal/platform).
BOMBVAULT_SELF_CONTAINER Ne Název samotného kontejneru BombVault, takže nikdy nezálohuje (a tedy nezastaví) sám sebe.
BACKUP_MAX_HOURS Ne Maximální počet hodin reálného času, po které jeden zálohovací běh smí držet zámek své sekce, než je násilně zrušen (pojistka, aby zaseknutý běh nemohl navždy blokovat sekci). Prázdné (výchozí) použije 48. Zvyš pro velmi velké nebo pomalé cloudové zálohy (běh zrušený na stropu selže s context deadline exceeded). Nastav 0 pro úplné vypnutí stropu. Na prune se vztahuje stejný strop a kontrola nebo prune běží tak dlouho, dokud restic hlásí postup.
BACKUP_STALL_HOURS Ne Počet hodin, po které záloha smí vůbec nepostupovat, než je zrušena. Prázdné (výchozí) použije 2. Nastav 0, aby se kvůli zastavení nikdy nerušila. Je to jemnější z obou pojistek a obvykle ta, která zasáhne: sleduje, zda se ještě něco děje, a ne jak dlouho běh trvá, takže pomalá, ale zdravá záloha mnoha terabajtů zůstane nedotčena, zatímco záloha zaseknutá na nereagující sdílené složce se zastaví za hodiny místo za dny. Po 30 minutách ticha, ještě než se cokoli zruší, se do logu zapíše varování. Procházení se počítá jako postup: restic při procházení velkého stromu nezapisuje žádné bajty a tato fáze se sleduje přes jeho součty souborů a bajtů, ne přes zapsané bajty. Obě proměnné jsou nezávislé a BACKUP_MAX_HOURS dál ohraničuje fáze po samotné záloze (uchovávání, statistiky, kopie mimo lokalitu), kde nejsou žádné čítače ke sledování.
DB_DUMP_MAX_HOURS Ne Hodiny, po které smí jeden automatický dump databáze běžet, než je zastaven. Prázdné (výchozí) použije 6. Povolené jsou hodnoty 1 až 48 a limit zůstává hodinu pod BACKUP_MAX_HOURS (je-li kratší než dvě hodiny, na jeho polovině), aby dlouhý dump utnul jeho vlastní limit a byl tak i nahlášen, místo aby strhl zálohu s sebou. Dump, který přestane postupovat, se zastaví dřív, po BACKUP_STALL_HOURS. Zastavený dump selže sám za sebe a záloha kontejneru pokračuje. Na Unraidu přidej proměnnou ke kontejneru BombVault přes Add another Path, Port, Variable.
TZ Ne Časové pásmo pro plánovač (například Europe/Berlin). Pokud ji nenastavíš, běží všechny plány v UTC: plán nastavený na 02:30 se pak spustí ve 02:30 UTC, nikoli podle místního času. Na Unraidu to nikdy nenastavuješ sám: systém předává vlastní časové pásmo do každého kontejneru. Úvodní log při spuštění uvádí, na které pásmo se nastavení přeložilo. Pásmo s letním časem na jaře jeden běh vynechá a na podzim jeden spustí dvakrát, kdežto UTC nedělá ani jedno, zato se dvakrát do roka posune o hodinu oproti tvým hodinám.
DATA_DIR Ne Kde BombVault drží svou databázi, klíče a mezipaměti (výchozí /config). V kontejneru to nech být. Hodí se, když spouštíš binárku mimo Docker.
FLASH_DIR, FLASH_TEMPLATES_DIR Ne Kde je uvnitř kontejneru připojená flashka a její šablony Dockeru (výchozí /host/boot a /host/boot/config/plugins/dockerMan/templates-user). Řídí se připojením /boot ze šablony, takže je nech nenastavené.
MODE Ne full (výchozí) spouští celou aplikaci. node spouští uzel: bez webového rozhraní a bez vlastních plánů, jen to, co mu řekne jeho domovská instance. Jakákoli jiná hodnota zastaví start se zprávou. Domovská instance ji za tebe vyplní do souboru compose uzlu.
NODE_HOME Na uzlu Ke které domovské instanci uzel patří, s klíčem a přeposílačem domovské instance, jako jedna hodnota začínající bvhome1.. Domovská instance ji zapíše do souboru compose uzlu. Bez ní se uzel spustí, ale žádná domovská instance na něj nedosáhne. Uzel, který si domovská instance převzala, odmítne start, když NODE_HOME jmenuje jinou domovskou instanci, dokud ho ta domovská instance neuvolní.
NODE_NAME Ne Jméno uzlu, jak ho domovská instance vyplnila podle názvu, který jsi mu dal.

Připojení

Připoj Docker socket, flash (/boot) a kořen Host Data (/mnt), jak je zobrazeno v CA šabloně. Zdroje i cíle záloh žijí pod Host Data, a to je připojeno jako slave, takže vzdálená sdílená složka, která se připojí až po spuštění kontejneru (například pod /mnt/remotes), se stane viditelnou bez restartu.

Na TrueNAS je Host Data cesta k datové sadě, například /mnt/tank, nikdy ixVolume. Data, která aplikace drží v ixVolume, leží mimo něj a nezálohují se. Viz TrueNAS SCALE.

Zálohy datových sad ZFS tento režim potřebují také: snímek datové sady hostitel připojí až poté, co kontejner nastartoval. Viz Datové sady ZFS.

Místní repozitáře mají ve výchozím stavu /mnt/user/bombvault/{container,vms,flash,config,files,zfs} a vytvoří se při první záloze. Jsou to vlastní složky sekcí a tvoří cíl Místní. Na jeho stránce v Cíle karta Připojení mění složku každé sekce.

Vlastní složka sekce může ležet i v cíli, který už máš, třeba na NAS nebo v bucketu S3: Použít jako vlastní složku na stránce toho cíle ji tam přesune a nejdřív řekne, co se stane se zálohami, které už existují. Viz Vlastní složka sekce.

Složky místních repozitářů zůstávají v režimech 0755 a 0644, aby nebyl vyloučen uživatel synchronizace bez práv root přes SMB, a repozitáře jsou šifrované, takže to nic neprozrazuje. Definice pro obnovu leží uvnitř každého repozitáře, takže zkopírovaná složka je kompletní sama o sobě. Repozitář autozálohy zůstává čitelný jen pro roota.

Kontrola integrace hostitele

Karta Integrace hostitele v Přehledu (přidáš ji pod Přizpůsobit) prozkoumá každé připojení a CLI (Docker socket, libvirt, restic, qemu-img, rclone) a nahlásí případné chybějící části.

Rozpoznávání zdrojů zálohy

Pro každý kontejner BombVault sám vybírá, které bind mounty a pojmenované svazky zálohovat. Cesta se vybere, když platí cokoli z následujícího (výsledek můžeš vždy upravit v kartě Zálohované složky na záložce Nastavení kontejneru):

  • Shoda se segmentem kořene dat: hostitelský zdroj bindu obsahuje jeden ze segmentů DATA_ROOT_SEGMENTS jako celou složku cesty (ve výchozím stavu pouze appdata).
  • Pojmenované svazky Dockeru se zahrnují vždy, protože k nim neexistuje jednorázový protějšek, a není tedy co filtrovat, ale jen tehdy, když je skutečná úložná cesta svazku na hostiteli dosažitelná přes připojení Host Data, přesně jako každá jiná hostitelská cesta, kterou BombVault zálohuje. Výchozí ovladač místních svazků ukládá svazek pod kořen dat samotného démona, tedy /var/lib/docker/volumes/<název>/_data, pokud to nebylo upraveno (ověříš příkazem docker info -f '{{.DockerRootDir}}'). Toto místo NENÍ pokryto úzkým, jednoadresářovým připojením Host Data, které obecný docker-compose.yml ve výchozím stavu používá. Nedosažitelný svazek se tiše přeskočí, není to chyba. Aby se pojmenované svazky na obecném hostiteli opravdu zálohovaly, nasměruj Host Data (a HOST_SOURCE_ROOT) na společného předka, který pokrývá i kořen dat Dockeru: kompromis popisuje komentář Host Data v souboru compose (Unraid to obchází tím, že ze stejného důvodu připojí celé /mnt, svou vlastní univerzální konvenci nejvyšší úrovně).
  • Adresář projektu Docker Compose: nese-li kontejner obvyklý štítek com.docker.compose.project.working_dir (nastavuje jej automaticky docker compose up), přidá se i tento adresář, bez ohledu na to, zda některý bind odpovídal segmentu kořene dat.
  • Přepis štítkem bombvault.data: nastav kontejneru štítek bombvault.data=true, aby se zahrnula VŠECHNA jeho připojení bind, pro uspořádání, které nezachytí ani jedna z výše uvedených konvencí (například jediný bind /srv/plex/config bez projektu Compose). Jakákoli neprázdná hodnota jiná než false platí jako pravda. Chybějící štítek nebo bombvault.data=false nemění nic.
  • Štítek bombvault.dbdump: nastav bombvault.dbdump=false na kontejneru, aby se vypnul jeho automatický výpis databáze (totéž dělají 0, no a off), nebo uveď engine (postgres, mysql, mariadb), aby se vypsal kontejner, který BombVault sám nerozpozná. Štítek má přednost před přepínačem v kartě Databáze na záložce Nastavení kontejneru, což je způsob, jak to udělat na Unraidu.

Bezpečnostní model

Kontrola nad hostitelem na úrovni root

Skrze Docker socket může BombVault zastavovat, odebírat a znovu vytvářet kontejnery a číst/zapisovat appdata, a pro zálohu VM se přihlašuje k hostiteli přes SSH (qemu+ssh://, ve výchozím stavu root), aby spustil virsh. Kdokoli, kdo se dostane k jeho webovému rozhraní, má fakticky root na hostiteli.

Přihlášení

  • Volitelná ochrana heslem (karta Heslo v Nastavení, Zabezpečení): nastavením hesla se vyžaduje přihlášení, jeho smazáním se vypne. Ve výchozím stavu vypnuto pro důvěryhodnou LAN. Heslo se ukládá pomocí Argon2id nad pepřem navázaným na APP_KEY, takže zkopírovaný /config je bez klíče bezcenný a s ním pomalý k napadení. Nové heslo potřebuje alespoň 12 znaků. Stávající kratší funguje, dokud se nezmění. Relace jsou podepsané (HMAC odvozený z APP_KEY) a změna hesla je zneplatní. Přihlášení je omezeno na pět neúspěchů za minutu na klienta. Změna nebo smazání hesla si vyžádá Současné heslo a při zapnutém dvoufázovém ověření i kód.
  • Některé věci vyžadují heslo. Stažení sady pro obnovu, hlášení o chybě a ZIPu zálohy flashky, export zálohy flashky nebo autozálohy, uložení klíče u strážce klíče, povolení vydání úschovy, vytvoření nového kódu úschovy, export nastavení s přihlašovacími údaji, dvoufázové ověření, passkeys, přidání uzlu, opětovné zobrazení souboru compose uzlu a otevření položek uzlu jsou odmítnuty, dokud není nastaveno přihlašovací heslo, a vyžadují přihlášení přímo na instanci. Mazání záloh funguje i bez hesla. Když je heslo nastavené, vyžaduje také toto přihlášení.
  • Cíl neukazuje heslo. Cíl může obsahovat přihlašovací údaje, jako v rest:https://user:password@host/repo, a každá stránka i odpověď API ho ukazuje jako rest:https://[redacted]@host/repo, s přihlašovacím heslem i bez něj. Změň cestu za ním a uložené heslo zůstane. Chceš-li cíl nasměrovat na jiný server, napiš celý cíl i s heslem, protože skryté heslo zůstává u svého serveru.
  • Dvoufaktorové ověření (Nastavení, Zabezpečení): časový kód z aplikace pro ověřování navíc k heslu, plus osm jednorázových záložních kódů vydaných jednou při zapnutí. Sdílené tajemství je uloženo zašifrované pomocí APP_KEY a vypnutí tohoto faktoru vyžaduje aktuální kód.
  • Přístupové klíče (WebAuthn) mají vlastní kartu, jakmile je nastavené heslo, a fungují vedle hesla, nikdy místo něj, takže odebráním všech přístupových klíčů se nikdo nezamkne. Potřebují skutečný doménový název a certifikát, kterému prohlížeč důvěřuje. Výchozí https://<ip>:3443 je přesně to, co WebAuthn odmítá, a karta to řekne, místo aby nabídla tlačítko, které selže. Při zapnutém dvoufázovém ověření musí přístupový klíč ověřit tvůj PIN, otisk prstu nebo obličej, jinak se přihlášení zeptá i na kód.
  • Obnova konfigurace (Vrátit nastavení v Nouzovém průvodci) ukončí všechny relace, odstraní všechny přístupové klíče a zruší všechny API tokeny a klíče MCP, protože vrácené nastavení by mohlo přinést zpět ty, které byly odebrány až po jeho uložení. Přihlas se heslem a přístupové klíče si znovu nastav v Nastavení, Zabezpečení.
  • Zapomenuté heslo se resetuje na přihlašovací stránce. Zapomenuté heslo? způsobí, že BombVault zapíše kód o 12 znacích ve třech skupinách po čtyřech do logu svého kontejneru (na Unraidu: záložka Docker, ikona BombVault, Logs). Tento kód a nové heslo tě přihlásí. Reset také vypne dvoufázové ověření, odstraní všechny passkeys, zruší všechny API tokeny, klíče MCP a přihlášení OAuth, ukončí všechny ostatní relace, odhlásí všechny spárované telefony a vypne párování telefonů. Stránka potom vypíše, co zmizelo. Kód platí 10 minut a špatné pokusy ho nespotřebují. Tokeny widgetu a metrik zůstávají, protože jen čtou.
  • Kdo může číst log kontejneru, může resetovat heslo. To je root na hostiteli, ale také prohlížeč logů jako Dozzle, každý kontejner s přidělenou Docker socket (stačí jen pro čtení) a nástroj, který přeposílá výstup kontejnerů. Dávej je jen lidem, kterým bys svěřil heslo. Kdo se dostane jen k webovému rozhraní, kód nikdy neuvidí.

Telefony a členové skupiny

  • Spárované telefony dosáhnou na povolený seznam. Telefon, který zná dvanáct slov skupiny, se přihlásí bez hesla, dokud je zapnuto Telefony se mohou spárovat s dvanácti slovy skupiny v kartě Aplikace pro Android v Nastavení, Zabezpečení. Jeho relace sahá jen k tomu, co aplikace ukazuje: přehled, běhy, zálohy k prohlížení, spuštění a obnově, anomálie ke čtení a stránku Instance k prohlížení. Cíle a příkazy k němu dorazí bez adres a tajemství a obnova, která nahrazuje originál, nejdřív zazálohuje aktuální stav. Obnova do složky přijme jen novou nebo prázdnou složku uvnitř složky pro obnovu a telefon nemůže nahlédnout do žádné jiné složky. Všechno ostatní odpoví, že potřebuje přihlášení přímo na instanci: klíče, sada pro obnovu, úschovy klíčů, nastavení, mazání záloh. Reset hesla vypne párování telefonů, dokud ho znovu nezapneš. Telefon odebraný ze stránky Instance nebo s vypnutým Dotázat se na tuto instanci v podrobnostech hned ztratí relaci, a odebraný telefon, který znovu otevře aplikaci, se vrátí vypnutý.
  • Mimo domov otevírá telefon stránky přes relay. Každý požadavek stránky je zapečetěný klíčem skupiny, který relay nemůže přečíst ani změnit, a podepsaný vlastním klíčem telefonu, který si server připne při prvním volání telefonu a pustí ho dál, jakmile někdo telefon schválí na stránce párování. Server požadavek provede jen jednou a jen dokud je čerstvý. Odpovídá jen telefonu, který je na stránce Instance, dokud je zapnuté párování telefonů, a jen v rámci relace, kterou tomuto telefonu dal, takže odhlášení všude i reset hesla tyto stránky také ukončí. Server podepisuje každou odpověď a aplikace ověřuje podpis proti klíči, který si pro tento server připnula, a při změně klíče upozorní. Taková stránka dosáhne na stejný povolený seznam jako spárovaný telefon, s přihlašovacím heslem i bez něj, a navíc na stav přihlášení, který stránka čte jako první. Přihlášení a odhlášení, reset hesla a stahování zůstávají u vlastní adresy serveru a jedna odpověď je omezena na 16 MB.
  • Členové podepisují, o co žádají. Žádosti o role a odpovědi na ně, nabídky úložiště, vydání hesla resticu příjemci nebo stahovači, přihlášení příjemce a úschovy klíčů se podepisují klíčem každého člena, který si instance připne, když člena poprvé uvidí. Volání podepsané jiným klíčem se odmítne. Zapomenout klíč v podrobnostech instance připnutý klíč zahodí, pro případ, že ten známý tady není klíčem samotného člena. Člen je při dalším podepsaném volání požádán o klíč znovu. Členové na BombVaultu 9.x nepodepisují a kdokoli se slovy je může napodobit, jako v 9.9. Žádost o roli nebo nabídka úložiště od člena na verzi 10.4 nebo starší se odmítne, dokud se tento člen neaktualizuje.
  • Dvanáct slov je heslo. Kdo je má, vstoupí do skupiny, vidí stav ochrany členů a může žádat o role, které musí osoba na druhé instanci ještě povolit. Bez přihlašovacího hesla je může přečíst každý, kdo otevře webové rozhraní, a karta párování to říká, dokud se heslo nenastaví.

Klíče

  • APP_KEY dělá dvě věci. Zapečeťuje, co tato instalace ukládá (hesla, přihlášení, tokeny), a je klíčem záloh: odvozuje se z něj heslo resticu a zapečeťují se jím definice kontejnerů a VM.
  • Převzatý klíč se drží zvlášť. Když Nouzový průvodce převezme zálohy jiného serveru, tato instalace dál pečeťuje vlastním APP_KEY a klíč druhého serveru uloží jako svůj Klíč záloh, zapečetěný jako každé jiné tajemství. Sada pro obnovu pak vytiskne oba. Pokud se APP_KEY později změní, klíč záloh už nejde otevřít: BombVault přestane zálohovat a řekne to pod Vyžaduje pozornost, místo aby zapisoval špatným klíčem. Nahraj sadu pro obnovu znovu v Obnova, Nouze, nebo vrať APP_KEY zpět. Viz Nouzový průvodce.
  • Šifrování je ve výchozím stavu zapnuté (Šifrovat zálohy v kartě Šifrování v Nastavení, Zabezpečení). Zálohy šifruje restic heslem odvozeným z klíče záloh.
  • Úschova klíčů. Strážce klíče ve tvé skupině drží zapečetěnou kopii sady pro obnovu tohoto serveru, kterou sám otevřít nemůže. Otevře ji jen kód úschovy o 20 znacích a strážce ji vydá, až když tam někdo stiskne Povolit. Viz Strážce klíče.

Uzly

Uzel je BombVault bez webového rozhraní, který přijímá pokyny od domovské instance.

  • Domovská instance drží uzel. Uzel připojuje Docker socket svého serveru, což je tam root, a domovská instance uzel řídí. Pokud někdo převezme domovskou instanci, ovládá i všechny její uzly. Dej domovské instanci přihlašovací heslo a její webové rozhraní drž mimo internet.
  • Uzel drží málo. Pokud někdo převezme uzel, nezíská skupinu párování, pevnost, žádný jiný uzel ani jiný repozitář. Uzel má jen spojení se svou domovskou instancí, vlastní přihlášení na přijímacím serveru a vlastní složku v cíli. Na přijímacím serveru nemůže smazat historii, protože server je append-only. Může zaplnit disk serveru, protože rest-server nenastavuje kvótu, takže dej přijímacímu serveru dost místa nebo vlastní sdílenou složku. V cíli může jeho přihlášení obvykle smazat, co tam leží. Zálohy uchované na uzlu jsou v rukou útočníka, a proto si z nich domovská instance stahuje kopii.
  • Spojení je soukromé a podepsané. Domovská instance a uzel spolu mluví přes přeposílač vlastním spojením, zapečetěným tajemstvím odvozeným z APP_KEY uzlu. Každá strana zná klíč té druhé už před prvním požadavkem, takže není žádný krok schválení. Domovská instance podepisuje každý požadavek svým klíčem a počítadlem a uzel odmítne požadavek, který domovská instance nepodepsala nebo který už jednou přijal. Uzel na domovské instanci nevolá nic kromě svého pozdravu.
  • Domovská instance dosáhne na pevný seznam. Požadavky, které domovská instance předává uzlu, běží jen na pevném seznamu cest uzlu, uvedeném na GET /api/nodes/routes, a uzel na ně odpovídá jen v JSON. Nic na seznamu nemaže ani nesahá na nastavení, úložiště, klíče, skupinu či tokeny. Na domovské instanci vyžadují přihlášení heslem: spárované telefony, tokeny API a klíče MCP na uzel nedosáhnou. Zálohy a obnovy spuštěné tímto způsobem se ukazují jako spuštěné domovskou instancí.
  • Úschova klíčů nese klíče uzlů. Domovská instance si drží APP_KEY každého uzlu a sada pro obnovu ho vypisuje v kapitole Uzly, takže ho nese i úschova klíče. Strážce klíče, který dostane úschovu a kód úschovy, může otevřít repozitáře tvých uzlů, ale uzlu nemůže nic přikázat, protože k tomu je potřeba podpis domovské instance.
  • Uvolnění je navždy. Uvolněný uzel už se stejným APP_KEY žádnou domovskou instanci nepřijme. Uzel, který je pryč, když ho uvolníš, se to od domovské instance dozví, až se vrátí.

Síť

  • Změny vyžadují JSON. Požadavek, který něco mění, musí posílat Content-Type: application/json a prohlížeč ho nesmí označit jako cross-site, takže stránka na jiném webu nemůže přimět tvůj prohlížeč, aby změnil nastavení na adrese v LAN. Skript, který ovládá API, tuto hlavičku posílá. Cokoli jiného se odmítne s 415.
  • Protože je brána volitelná, je při nenastavení celé UI a API (včetně cílů, tamper-test cest a cest obnovy) dostupné každému, kdo se dostane na port. Nastav přihlašovací heslo, jakmile používáš zálohy mimo lokalitu, append-only zálohy nebo šifrování.
  • Provozuj BombVault pouze v důvěryhodné, nevystavené síti. Pro vzdálený přístup jej umísti za reverzní proxy, která přidává autentizaci a TLS. Odpovědi nesou základní bezpečnostní hlavičky (CSP, nosniff, X-Frame-Options, Referrer-Policy).
  • Za reverzní proxy nese každý požadavek adresu proxy, takže bez TRUSTED_PROXY počítá omezení všechny klienty dohromady a neúspěchy útočníka zamknou i tebe. Uveď proxy v TRUSTED_PROXY a počítání se vrátí na jednotlivé klienty.
  • Reverzní proxy před BombVaultem musí předávat hlavičku Authorization nebo X-API-Key na /mcp a nesmí bufferovat odpovědi, jinak se asistenti nepřipojí. Viz Server MCP.
  • Endpoint MCP /mcp odpovídá 404, dokud neexistuje klíč nebo není zapnuté přihlašování přes OAuth, a od každého klienta vyžaduje jeho klíč nebo token i při vypnutém přihlašovacím heslu. Žádná adresa není výjimkou, ani localhost. Nemá nástroje pro obnovu ani mazání a obnova autozálohy odvolá všechny klíče. Viz Server MCP.
  • S HTTP_ONLY=true ztrácí session cookie svůj příznak Secure (musí, aby fungovala přes prosté HTTP), takže zapni heslo za proxy terminující TLS jen pokud je důvěrnost důležitá.
  • SSH připojení pro zálohu VM důvěřuje hostitelskému klíči při prvním připojení (TOFU) a poté jej připne. Ověř hostitelský klíč mimo pásmo, pokud tvoje cesta z kontejneru k hostiteli není důvěryhodná.
  • Odkazy nevedou ven z mountu. Záloha nebo obnova na místě se zastaví se zprávou, když odkaz nad její cestou vede ven z mountu hostitele, protože kontejner, který zapisuje do vlastní sdílené složky, by tam takový odkaz mohl podstrčit. Cíl, jehož hostitel nebo remote rclone začíná pomlčkou, se odmítne stejně, při uložení i při dalším běhu, protože ssh nebo rclone by ho přečetly jako volbu.

Server MCP

Server MCP nepotřebuje žádnou proměnnou prostředí. Zapneš ho vytvořením klíče v Nastavení, Integrace, Server MCP a odpovídá na /mcp na stejném portu jako webové rozhraní (například https://192.168.1.10:3443/mcp). Bez aktivního klíče tato cesta odpovídá 404. Klienty, certifikáty a limity popisuje stránka Server MCP.

Záloha VM přes SSH

BombVault zálohuje KVM/libvirt VM bez připojení jakékoli libvirt cesty. Spouští virsh na hostiteli přes SSH (qemu+ssh://), takže nikdy nemůže ovlivnit tvůj hostitelský VM Manager.

Připojit socket libvirt hostitele do kontejneru je na Unraidu křehké: tyto cesty spravuje VM Manager a přepnutí "Enable VMs" může libvirt zanechat ve stavu, kdy se nedokáže spustit. SSH klíč dává na hostiteli práva roota, tedy stejnou úroveň důvěry jako Docker socket, který už BombVault používá.

Rychlé nastavení:

  1. Nastavení, Integrace, SSH k hostiteli: zkopíruj zobrazený veřejný klíč.
  2. Připoj jej do /root/.ssh/authorized_keys Unraidu (také persistováno na flash, aby přežilo restarty).
  3. Klikni na Otestovat připojení.

Šablona přidává --add-host=host.docker.internal:host-gateway, aby kontejner dosáhl na hostitele. Nastav LIBVIRT_HOST na svou LAN IP Unraidu, pokud se ten název neresolvuje (například když kontejner běží na vlastní síti br0.x). Pokud jsi změnil SSH port Unraidu, nastav LIBVIRT_SSH_PORT, aby odpovídal. Živé snímky také potřebují qemu guest agent ve VM a disk na /mnt/cache (nikoli /mnt/user).

Kompletní průvodce nastavením VM a sítí

Kompletní krok za krokem průvodce (povolení SSH, persistentní autorizace klíče, směrování ve vlastní síti a VLAN, metoda na VM a řešení problémů na straně hostitele) je průvodce zálohou VM.

Nastavení mimo lokalitu

Kopie mimo lokalitu jdou do cílů. Otevři Cíle z jejich dlaždice v nastavení (nebo je připni do postranního panelu) a zvol Přidat cíl. Úplný postup (ochrana proti mazání, tamper testy a DR cvičení) viz Mimo lokalitu a obnova. Ve zkratce:

  • Backendy: SMB/CIFS a WebDAV přes rclone bez připojení na hostiteli, NFS (připoj export na hostiteli a použij ho jako místní složku), nativní backendy resticu bez rclone (s3:..., rest:http://host:8000/repo, sftp:user@host:/repo) nebo libovolný rclone remote (rclone:<remote>:<bucket>/path). Backblaze B2 tu nativní backend nemá: dosáhni na něj přes jeho S3 endpoint (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>) s ID klíče a aplikačním klíčem jako S3 přihlašovacími údaji.
  • Přihlašovací údaje se ukládají zašifrované, jako jeden seznam uložených přihlášení v kartě Přihlašovací údaje v Nastavení, Cíle. Hvězdička označuje výchozí, které se používá všude, kde není vybráno žádné. Stránka samotného cíle vybírá to, které používá, ve své kartě Přihlašovací údaje. Viz Přihlašovací údaje.
  • SSH cíle nevyžadují nic nainstalovaného na druhé straně. sftp: potřebuje jen SSH server. Přidej veřejný klíč z Nastavení, Integrace, SSH k hostiteli (také na /config/ssh/id_ed25519.pub) do ~/.ssh/authorized_keys cílového uživatele, nebo ho tam nech uložit přes Přidat klíč v okně Přidat cíl s heslem účtu.
  • rest-server se samopodepsaným certifikátem: ulož jeho certifikát, nebo certifikát autority, která ho podepsala, jako soubor PEM do složky certs v datové složce BombVaultu (/config/certs v kontejneru, appdata/bombvault/certs na Unraidu). Zálohy, kopie i test ochrany proti smazání mu důvěřují bez restartu.
  • Kopie mimo lokalitu: BombVault kopíruje nové zálohy pomocí restic copy na základě nejlepší snahy, nad (obvykle místním) primárním repozitářem. Karta Kopírovat cíle určuje, zda kopíruje Po každé záloze, nebo podle vlastního plánu, a Nastavení, Plán, Kopie mimo lokalitu podle sekcí dá jedné sekci vlastní plán kopírování. Replikovat nyní je v řádku sekce v kartě Kopie mimo lokalitu v Nastavení, Cíle.
  • Několik cílů na sekci: karta Cíle podle sekcí na stránce Cíle zapíná nebo vypíná každou linku ze sekce do cíle jedním klepnutím, včetně Místní. Sekce jen s cíli mimo lokalitu zálohuje přímo na ně a sekce, jejíž linky jsou všechny vypnuté, se nezálohuje. Pravidla podle sekcí cíle dají jedné sekci tam vlastní repozitář, uchovávání nebo kompresi.
  • Umístění podle položky: každý kontejner, VM a sada složek rozsvítí Místní a cíle, které dostávají její zálohy, v kartě Plán a cíl na záložce Nastavení. Položky bez vlastní volby se řídí svou sekcí. Viz Umístění podle položky.
  • Uchovávání: každý cíl drží zálohy podle své karty Jak dlouho uchovávat a sekce tam může mít vlastní hodnoty pod Pravidla podle sekcí. Kopie v poli sekce mimo lokalitu drží pravidla karty Uchovávání mimo lokalitu v Nastavení, Cíle, která má Pravidla uchovávání podle zdroje pro jednotlivé sekce (nech vše na nule, aby se zálohy mimo lokalitu nikdy automaticky neořezávaly).
  • Limity šířky pásma: omez rychlost nahrávání/stahování resticu v kartě Šířka pásma mimo lokalitu v Nastavení, Cíle, nebo pro každý cíl v jeho kartě Kopírovat. Zadáváš KiB/s a pole ukáže stejnou rychlost i v MB/s a Mbit/s.
  • Nejdřív streamování: v kartě Streamování na stránce Cíle vyber mediální servery (Plex, Jellyfin a Emby jsou předvybrané podle názvu image), rychlost odesílání, od které se počítá streamování, limit nahrávání při streamování a jak dlouho po streamu se vrátí běžný limit.
  • Studená a archivní třída úložiště (S3): pro cíl S3 vyber na jeho stránce úroveň čitelnou při obnově (Standard, Standard-IA, One Zone-IA, Intelligent-Tiering, Glacier Instant Retrieval). Rclone remoty nastavují třídu v konfiguraci rclone.
  • Vlastní složka v cíli místo místní: vlastní složka sekce může ležet v jednom z cílů výše, bez místní kopie a bez kroku kopírování. Viz Vlastní složka sekce.

Anomálie

Zjišťování anomálií nepotřebuje žádnou proměnnou prostředí. Nastavuje se v kartě Anomálie v Nastavení, Ověření a je popsáno na stránce Anomálie.

Přenositelná nastavení (export a import)

Karta Export / import nastavení v Nastavení, Systém zapíše celou konfiguraci BombVaultu (nastavení sekcí, cíle, plány, uchovávání, oznámení) do přenosného souboru JSON, který můžeš importovat na jiné instanci, takže přesun na nový stroj nebo klonování nastavení neznamená zadávat všechno ručně. Import ukáže náhled a požádá o potvrzení a nikdy se nedotkne dat záloh ani historie. Odkazy v souboru na cíle nebo repozitáře, které už neexistují, se vynechají a náhled je jmenuje. Dokud běží replika ZFS, import se odmítne dřív, než se cokoli zapíše.

Export může obsahovat přihlašovací údaje

Ty zvolíš, zda do souboru zahrnout přihlašovací údaje mimo lokalitu, oznámení a brokeru MQTT. Se zahrnutými přihlašovacími údaji je export stejně citlivý jako tvoje sada pro obnovu, takže jej ulož na bezpečné místo. Bez nich soubor obsahuje jen netajná nastavení.

APP_KEY se souborem necestuje

Repozitáře jsou zamčené heslem odvozeným z APP_KEY a soubor ho neobsahuje. Při plánovaném přesunu dej novému stroji v jeho šabloně starý APP_KEY, nebo klíč převezmi sadou pro obnovu pod Nouze. S jiným klíčem repozitáře odpovídají, že heslo je špatné. Nic se neztratí a nastavení správného klíče je zase otevře.