Csomópontok¶
A csomópont egy webes felület nélküli BombVault, például egy VPS-en vagy egy barátodnál álló kis szerveren. A saját szerverén lévő konténereket és mappákat menti, azt pedig, hogy mikor mentsen és hová kerüljenek a mentések, az a BombVault mondja meg neki, amelyiken hozzáadod. Ezt ezen az oldalon anyapéldánynak hívjuk. A csomópontot az anyapéldány webes felületéről kezeled, a saját elemeid mellett.

Hogyan működik¶
- Az anyapéldány tartja a csomópont kulcsát. Amikor hozzáadsz egy csomópontot, az anyapéldány elkészíti az
APP_KEYkulcsát, megtart belőle egy lezárt másolatot, és egyszer odaadja neked, a csomópont compose fájljában. Ezzel a másolattal éri el az anyapéldány a csomópontot, és ezzel nyitja meg a mentéseit. - A csomópontnak nem kell nyitott port. Az anyapéldány és a csomópont a relayen át, egy saját, privát kapcsolaton beszél, a párosítási csoportodtól külön. Minden hívást az anyapéldány kezd és ír alá, a csomópont pedig a köszönésén kívül semmit sem kér tőle. Az egyetlen cél, amelyhez nyitott port kell, a mentések megtartása a csomóponton.
- A mentések soha nem mennek át a relayen. A csomópont egyenesen oda küldi őket, ahová választod: az anyapéldány fogadószerverére, az anyapéldány egyik mentési céljába vagy egy rest-serverre magán a csomóponton.
- A csomópont maga semmit sem ütemez. Nem futtat ütemezést, nem küld értesítést, és nem lép be semmilyen csoportba vagy erődbe. Az anyapéldány indítja a mentéseit, figyeli, hogyan mennek, és küldi a riasztásokat.
- A csomópont konténereket és mappakészleteket ment. A VM-ek, a flash, a ZFS-adatkészletek és az önmentés a teljes telepítéseknél maradnak.
A kapcsolat az anyapéldány saját relayét használja, ha a csoportjának van ilyen, egyébként a projekt relayét, akkor is, ha az anyapéldány relay nélkül párosít.
Mielőtt elkezded¶
- Bejelentkezési jelszó az anyapéldányon. A csomópont hozzáadásához, a compose fájljának újbóli megjelenítéséhez és az elemei megnyitásához jelszavas bejelentkezés kell, lásd: Bejelentkezés.
- Docker és Compose a csomópont szerverén.
- Hely a mentéseknek, a Hová kerülnek a mentések alatti három közül az egyik. A fogadószerver a legbiztonságosabb választás, mert ott a csomópont semmit sem tud törölni.
Csomópont hozzáadása¶
- Az anyapéldányon nyisd meg a Példányok oldalt, és válaszd jobb alul a Csomópont hozzáadása gombot.
-
Név. Írd be, milyen néven jelenjen meg itt a csomópont, például a szerver nevén, és válaszd a Tovább gombot.

-
Mentések. Válaszd ki, hová kerüljenek a mentések, és töltsd ki, amit az a hely kér. A Naponta ment ekkor: az az időpont, amikor mindkét szakasz elindul. Az anyapéldány fél órával a saját konténermentései utánra javasolja, hogy a kettő ne egyszerre nyúljon ugyanazokhoz a lemezekhez. Később a kártyán minden szakasznak saját tervet adhatsz. Válaszd a Tovább gombot.

-
Indítás. Az ablak megmutatja a csomópont compose fájlját, kitöltött
MODE,APP_KEY,NODE_HOMEésNODE_NAMEértékkel. Másold ki, és azAPP_KEYkulcsot tedd biztos helyre. A csomópont szerverén:mkdir -p /opt/bombvault-node && cd /opt/bombvault-node nano docker-compose.yml # paste the file from the window docker compose up -dIndítás előtt irányítsd a Host Data kötetet a menteni kívánt adatokra, és állítsd a
HOST_SOURCE_ROOTértékét ugyanarra az útvonalra, ahogy a lenti példa mutatja. -
Az ablak vár a csomópontra. Amint a csomópont válaszol, az anyapéldány megmondja neki, hová kerülnek a mentései, és ellenőrzi, hogy eléri-e őket. Ekkor az ablakban ez áll: vps-helsinki online, és ettől a példánytól kapja az utasításait.

Az ablakot bezárhatod, mielőtt a csomópont válaszol. A kártyáján ilyenkor a Várakozás a csomópontra áll, és az anyapéldány közli vele, hová kerülnek a mentései, amint megjelenik.
Példa: egy VPS, amely a fogadószerverre ment¶
Az anyapéldány egy tower nevű Unraid-gép, amely a fogadószervert futtatja. Egy fordított proxy https://backup.tower.example.org címen teszi elérhetővé. A vps-helsinki VPS Nextcloudot és Caddyt futtat, az adataik a /srv/appdata alatt vannak.
- A
towergépen: Példányok, Csomópont hozzáadása, a névvps-helsinki, Tovább. - Válaszd az Ennek a példánynak a fogadószervere lehetőséget, és a Cím a csomópontoknak mezőbe írd be:
https://backup.tower.example.org. Az anyapéldány konténerei 02:30-kor mentenek, ezért az ablak 03:00-t kínál. Hagyd így, és válaszd a Tovább gombot. -
A VPS-en mentsd el az ablakban látható fájlt úgy, hogy a kötetek és a
HOST_SOURCE_ROOTa/srv/appdataútvonalra mutassanak:services: bombvault-node: image: junkerderprovinz/bombvault:latest restart: unless-stopped hostname: bombvault-node container_name: bombvault-node volumes: - ./config:/config - /var/run/docker.sock:/var/run/docker.sock - /srv/appdata:/host/user environment: MODE: node APP_KEY: "<filled in by home>" NODE_HOME: "<filled in by home>" NODE_NAME: "vps-helsinki" PLATFORM: generic HOST_SOURCE_ROOT: /srv/appdata -
docker compose up -d. Néhány másodperc múlva atowerablaka jelzi, hogy a csomópont online, és A biztonsági mentések ide kerülnek: https://backup.tower.example.org. - 03:00-kor az anyapéldány elindítja a csomópont mentéseit. Másnap reggel az áttekintés Csomópontok kártyája mutatja a
vps-helsinkiutolsó mentését, a Biztonsági mentések pedig külön szakaszban sorolja fel a konténereit.
Hogy egy sima Docker-hoszton hogyan találja meg a BombVault egy konténer adatait, azt A mentési források felismerése írja le.
Hová kerülnek a mentések¶
Minden csomópontnak egyetlen célja van mindkét szakaszához. A kártyáján a Cél módosítása megváltoztatja, ha a csomópont online. Az új hely új tárolókat kap, a régi helyen lévő mentések pedig ott maradnak, ahol vannak.
Ennek a példánynak a fogadószervere¶
A csomópont append-only módban ír az anyapéldány fogadószerverére: mentéseket hozzáadhat, de egyet sem törölhet. Saját, a csomópontról elnevezett bejelentkezést kap ott, és szakaszonként egy tárolót a saját mappájában. Az anyapéldány minden tárolóhoz hozzáadja a saját kulcsát, és maga tartja rendben őket, mert a csomópont erre nem képes.
A csomópont a Cím a csomópontoknak címen éri el a szervert, amelyet a második lépésben vagy a Fogadószerver ablakban állítasz be. Egy csomópont általában az internetről küld, ezért a cím ezek egyike legyen:
https://, például fordított proxy, Pangolin vagy alagút mögött. Ha a szerver nyilvános hitelesítésszolgáltatótól kapott tanúsítvány helyett sajátot mutat, illeszd be PEM formában a Tanúsítvány mezőbe.http://privát IP-címmel, például10.0.0.5egy WireGuard-kapcsolaton vagy100.101.102.103Tailscale-en.
A sima http:// nyilvános címre el van utasítva, mert a csomópont titkosítatlanul küldené a mentéseit az interneten át. Ha megváltoztatod a címet, az anyapéldány szól minden csomópontnak a fogadón, az éppen távol lévő csomópont pedig akkor értesül, amikor visszatér.
Egy cél¶
A csomópont az anyapéldány egyik olyan mentési céljába ír, amelyet maga is elér: egy S3-szolgáltatásba vagy egy REST-szerverre, https:// címen vagy privát címen. A tárolói ott a bombvault-node-<node id>-containers és a bombvault-node-<node id>-files alatt vannak.
A csomópont egy neki készült mentett bejelentkezéssel jelentkezik be, amelynek különböznie kell attól, amellyel az anyapéldány a célba ír. Ha az ablak szerint nincs ilyen, előbb vegyél fel egyet. Ezzel a bejelentkezéssel a csomópont a célban általában törölni is tudja, ami ott van, a fogadószerverrel ellentétben, és ezt az ablak jelzi is.
Maradjanak a csomóponton¶
A csomópont maga őrzi a mentéseit, egy saját, append-only módú rest-server mögött, az anyapéldány pedig minden szakaszról másolatot hív le a saját tárolójába. Ez annak a csomópontnak való, amelynek az anyapéldány nem tud helyet kínálni. Ez az egyetlen cél, amelyhez nyitott port kell.

- A csomópont címe mezőbe írd be, hol éri el az anyapéldány a csomópontot: a nyilvános címét és egy szabad portot, például
https://203.0.113.7:8443, mappa nélkül a végén. Ahttp://címet csak privát címmel használd, ahogy fent. - A csomópont ezen a porton elindítja a
bombvault-node-rest-serverkonténert, a tárolóit a Host Data alattibombvault-nodemappában tartva.https://esetén tanúsítványt készít erre a címre, az anyapéldány pedig rögzíti. - Engedd át a portot a csomópont tűzfalán, hogy az anyapéldány elérje. Ha a portot egy másik konténer foglalja a csomóponton, a BombVault elutasítja, és megnevezi a konténert.
Az anyapéldány egy szakaszt rögtön azután hív le, hogy a csomóponton véget értek a mentései, tartalékként pedig óránként negyed után, akkor is, ha a Lehívás ki van kapcsolva. Amit az anyapéldány lehívott, az nála marad, mint bármely lehívott másolat, akkor is, ha a csomópont már nincs meg. A csomópont kérésre maga tartja rendben a tárolóit, mert a rest-servere nem fogad törlést, a mappakészletei pedig kihagyják a bombvault-node mappát, így soha nem menti a saját mentéseit.
Mikor mentenek a csomópontok¶
Minden csomópont ütemezése az anyapéldányé. A kártya szakaszonként mutat egy tervet, például Konténerek naponta 2:00-kor és Mappák hetente (V) 4:00-kor. Egy kattintás ugyanazt a szerkesztőt nyitja meg, mint az Ütemezések alatt, és a módosítás azonnal mentődik.

- A távol lévő csomópont, amint visszatér, elindítja a kimaradt mentéseit. Az anyapéldány ötpercenként néz rá.
- A foglalt csomópontot öt perc múlva újra megkérdezi.
- Amíg az anyapéldány rendet rak egy csomópont régi mentései között, a csomópont semmit sem indít, amíg az anyapéldány el nem készül. A fogadószerveren és magán a csomóponton ez az időablak minden vasárnap 03:00-kor nyílik, és legfeljebb hat óráig tart. Egy célnál az anyapéldány ahhoz a célhoz tartozó telephelyen kívüli másolási tervét követi. Az anyapéldány a mentéseket a szakasz saját szabálya szerint őrzi meg a Meddig őrizze meg alatt, vagy a cél szabálya szerint, ha annak van ilyen.
- A csomópont futáslistájában az anyapéldány által indított mentések és visszaállítások az anyapéldány indításaként jelennek meg.
A csomópontok figyelése¶
Az áttekintés Csomópontok kártyája minden csomópontot felsorol az állapotával, az utolsó mentésével, a hibáival és a nyitott anomáliáival. Akkor jelenik meg, amikor már van csomópontod.

Az anyapéldány epizódonként egy riasztást küld az értesítési csatornáin, a következőt pedig csak akkor, ha az az epizód véget ért:
- Egy mentés sikertelen, például BombVault: vps-helsinki: backup failed, az elemmel és az okkal. Az epizódot az elem egy későbbi, sikeres mentése zárja le.
- A csomópont nem érhető el, például BombVault: vps-helsinki is out of reach. Az anyapéldány a csomópont tárolóin beállított legrövidebb holtember-kapcsoló idejéig vár, ami 26 óra, ha nem módosítod, vagy 6 óra, amíg a csomópontnak még nincs célja.
Az anyapéldány fogadófigyelése a csomópont minden tárolójára is ügyel, holtember-kapcsolóval és napi restic check futtatással 04:00-kor, lásd: Fogadó és lehívó.
Egy csomópont elemei¶
A Biztonsági mentések alatt a Konténerek és a Mappák lista a saját elemeid alatt minden csomópontnak külön szakaszt ad. A csomópont saját konténere kimarad. Egy elem menüjében a Biztonsági mentés most elindítja a mentését a csomóponton, a Megnyitás pedig megnyitja az oldalát.
Egy csomópont szakaszában a Mappák listában a Mappakészlet hozzáadása mappakészletet ad a csomóponthoz, egy készlet menüjében a Szerkesztés pedig módosítja azt. Mindkettő ugyanazt az ablakot nyitja meg, mint a saját készleteidnél. Az ablak mappaválasztója a csomópont mappáit böngészi, de új mappát nem hoz létre ott.

Egy csomóponti elem oldalán az Itt: felirat és a csomópont neve áll, alatta a mentései. Az egyik melletti Visszaállítás a csomóponton állítja vissza az elemet, és lecseréli azt, ami most ott van. A konténer ehhez leáll, ugyanúgy, mint az anyapéldányon.

Az anyapéldányon át a csomópont saját útvonalainak egy rögzített listáját éred el: a konténereit, mappakészleteit, futásait és anomáliáit, valamint ezek mentését és visszaállítását. A csomópont beállításai, kulcsai és tárolója elérhetetlenek maradnak, és a listán semmi sem töröl. Lásd: Csomópontok az API-ban.
Csere és elengedés¶
A Csere jelszavas bejelentkezés után újra megmutatja a csomópont compose fájlját. Akkor használd, ha másik szerverre viszed vagy újraépíted a csomópontot: indítsd el ott a fájlt, és állítsd le a régi szervert. Ugyanaz az APP_KEY és NODE_HOME ugyanazzá a csomóponttá teszi újra, a mentéseivel és az előzményeivel együtt. Az anyapéldány minden csomóponttól megőrzi a mappakészleteit, a konténereit mindazzal, ami az újbóli létrehozásukhoz kell, és a futásait. Ha a csomópont üres config mappával indul, az anyapéldány újra magához veszi, megmondja neki, hová mennek a mentései, és a következő mentés előtt mindezt visszaadja neki, így a csomópont egy már nem létező konténert is vissza tud állítani. Új szerveren az a csomópont, amely maga őrzi a mentéseit, üres tárolókkal kezd. A korábbi mentései az anyapéldány által lehívott másolatokban maradnak. Két szerver ugyanazzal az APP_KEY kulccsal egy csomópontnak számít, ezért soha ne futtasd mindkettőt.
Az Elengedés elengedi a csomópontot. Többé nem fogad utasítást az anyapéldánytól, és semmit sem ment. A mentései ott maradnak, ahol vannak, ahogy minden másolat is, amelyet az anyapéldány lehívott. A bejelentkezése a fogadószerveren megszűnik, és az anyapéldány már nem figyeli a tárolóit. Ha a csomópont távol van, amikor elengeded, a kártyája Elengedés folyamatban állapotban marad, amíg értesül róla. Az elengedett csomópont ugyanazzal az APP_KEY kulccsal nem fogad el újra anyapéldányt. Ha újra használnád a szervert, add hozzá új csomópontként, és indítsd az új compose fájllal és egy üres config mappával.
Biztonság¶
Ha valaki átveszi az anyapéldányt, a csomópontjait is irányítja, a csomópont pedig kezében tartja a szervere Dockerét, ami ott root jogot jelent. Védd az anyapéldányt jelszóval, és tartsd távol az internettől. Ha valaki egy csomópontot vesz át, nem kapja meg a párosítási csoportot, az erődöt, más csomópontot vagy más tárolót, és a fogadószerveren nem tud előzményeket törölni. A részletek a Csomópontok a biztonsági modellben alatt vannak.
A helyreállítási csomag Csomópontok fejezete tartalmazza minden csomópont APP_KEY kulcsát, restic-jelszavát és tárolóit, így a csomópontot vagy a mentéseit sima restickel is visszahozhatod.