Kokoonpano¶
Tällä sivulla käsitellään kontin ympäristömuuttujat, mallin tarjoamat liitokset, tietoturvamalli, VM-varmuuskopiointi SSH:n yli ja etäkohteiden määritys. Se, minne varmuuskopiot menevät, määritetään sovelluksen sisällä kohteina, ei ympäristömuuttujilla.
Ympäristömuuttujat¶
| Muuttuja | Vaadittu | Kuvaus |
|---|---|---|
APP_KEY |
Kyllä | 32-tavuinen heksasalaisuus (64 heksamerkkiä), jolla johdetaan resticin repon salasana. Luo komennolla openssl rand -hex 32. Pidä se turvassa: sen menettäminen tekee salatuista varmuuskopioista palauttamattomia. |
LIBVIRT_HOST |
Virtuaalikoneille ja ZFS-tietojoukoille | Unraid-isäntä, johon otetaan yhteys SSH:n yli virtuaalikoneiden ja ZFS-tietojoukkojen varmuuskopiointia varten (mallin kenttä Host SSH: Address, oletus host.docker.internal). Malli esitäyttää paikanvaraajan 192.168.x.x, joka lasketaan asettamattomaksi. Käytä Unraidisi lähiverkon IP-osoitetta, pakollinen mukautetussa br0.x-verkossa. Kun host.docker.internal ei ratkea, kuten TrueNAS-sovelluksessa, eikä LIBVIRT_URI nimeä isäntää, BombVault käyttää kontin oletusyhdyskäytävää, ja käynnistysloki nimeää sen. |
LIBVIRT_SSH_PORT |
Ei | Isännän SSH-portti virtuaalikoneiden ja ZFS-tietojoukkojen varmuuskopioinnissa (mallin kenttä Host SSH: Port, oletus 22). |
LIBVIRT_SSH_USER |
Ei | SSH-käyttäjä isännällä virtuaalikoneiden ja ZFS-tietojoukkojen varmuuskopioinnissa (mallin kenttä Host SSH: User, oletus root). |
LIBVIRT_URI |
Ei | Täysi libvirt-yhteyden URI, jota käytetään sellaisenaan sen sijaan, että yhteys rakennettaisiin kolmesta yllä olevasta LIBVIRT_*-muuttujasta (jotka jätetään silloin huomiotta yhteysmerkkijonossa). Oletuksena asettamatta. Tarvitaan TrueNAS Scalella, jonka libvirtd kuuntelee epästandardia soketia, jota rakennettu merkkijono ei voi ilmaista: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. Katso VM-varmuuskopiointiopas. Kun se on qemu+ssh://-URI, jokainen asettamaton muuttujista LIBVIRT_HOST, LIBVIRT_SSH_USER ja LIBVIRT_SSH_PORT otetaan siitä, myös BombVaultin omille SSH-komennoille (NVRAM-siirto, ZFS-tietojoukot). |
PORT |
Ei | HTTP-portti (oletus 3000. Käytössä vain asetuksella HTTP_ONLY=true). |
HTTPS_PORT |
Ei | HTTPS-portti (oletus 3443. Malli julkaisee sen 1:1, joten WebUI vastaa osoitteessa https://<ip>:3443). |
HTTP_ONLY |
Ei | Aseta true kytkeäksesi itse allekirjoitetun HTTPS-kuuntelijan pois ja tarjotaksesi vain tavallista HTTP:tä (TLS:n päättävän käänteisen välityspalvelimen taakse). |
BIND_HOST |
Ei | Osoite, jota WebUI kuuntelee (oletus 0.0.0.0, jokainen liitäntä). Jätä asettamatta kontissa, jonka julkaistut portit tarvitsevat jokaisen liitännän. 127.0.0.1 sopii ajoon Dockerin ulkopuolella. Terveystarkistus kysyy samaa osoitetta. |
TRUSTED_PROXY |
Ei | Pilkulla erotetut osoitteet tai CIDR-alueet käänteisestä välityspalvelimesta BombVaultin edessä (esimerkiksi 192.168.20.11 tai 10.0.0.0/8). X-Forwarded-For-otsikkoon uskotaan vain näiltä hypyiltä, ja kirjautumisrajoitus laskee silloin epäonnistumiset todellista asiakasta kohti sen sijaan, että kaikki välityspalvelimen takana olevat pantaisiin samaan koriin. Asettamatta (oletus) ei luoteta keneenkään: ehdoitta uskottu otsikko antaisi jokaisen kutsujan valita oman korinsa. |
HOST_SOURCE_ROOT |
Ei | Isännän polku, joka liitetään Host Dataksi (oletus /mnt). BombVault muuntaa Dockerin raportoimat bind mount -lähteet poluiksi tämän liitoksen alle. Muuta vain, jos liitit eri isäntäjuuren. |
HOST_MOUNT_ROOT |
Ei | Mihin Host Data liitetään kontin sisällä (oletus /host/user). TrueNASissa Host Data liitetään omaan isäntäpolkuunsa, joten sekä tämä että HOST_SOURCE_ROOT nimeävät kyseisen polun, esimerkiksi /mnt/tank (katso TrueNAS SCALE). |
DATA_ROOT_SEGMENTS |
Ei | Pilkulla erotetut polun osien nimet, jotka merkitsevät bind mount -lähteen varmuuskopioitavaksi dataksi (oletus appdata, Unraidin käytännön /mnt/user/appdata/<container> mukaisesti). Kontin bind mount valitaan automaattisesti varmuuskopioitavaksi, kun MIKÄ TAHANSA listattu osa esiintyy sen isäntälähteen täytenä polun osana. Esimerkiksi DATA_ROOT_SEGMENTS=appdata,config poimii myös .../config-liitoksen. Vertailu ei erottele kirjainkokoa, joten oletus kattaa myös ZimaOS:n /DATA/AppData/<container>. Katso Varmuuskopiolähteen tunnistus muista, aina päällä olevista tavoista, joilla kontin datakansio löydetään. |
PLATFORM |
Ei | Pakottaa, minkä alustan BombVault katsoo itse olevansa, automaattisen tunnistuksen sijaan: unraid, generic tai truenas (oletuksena asettamatta: tunnistaa Unraidin automaattisesti etsimällä sen dockerMan-merkin flash-liitoksen alta, muuten generic. Tuntematon arvo palautuu myös arvoon generic, kirjattuna lokiin). Aseta se erikseen yleisellä Docker-isännällä tai TrueNAS Scalella sen sijaan, että luottaisit pelkästään Unraidin automaattiseen tunnistukseen. Yleinen compose-tiedosto tekee tämän. Muuttaa appdata-varakäytäntöä, instanssien välisen palautuskohteen oletuksia ja sitä, yritetäänkö Unraid-kohtaisia ilmoitus- ja kumppaniliitännäisvaiheita lainkaan (katso internal/platform). |
BOMBVAULT_SELF_CONTAINER |
Ei | BombVault-kontin oma nimi, jotta se ei koskaan varmuuskopioi (eikä siis pysäytä) itseään. |
BACKUP_MAX_HOURS |
Ei | Enimmäismäärä seinäkelloaikaa tunteina, jonka yksittäinen varmuuskopioajo saa pitää osionsa lukkoa, ennen kuin se perutaan väkisin (suoja, ettei jumittunut ajo voi estää osiota ikuisesti). Tyhjä (oletus) käyttää arvoa 48. Nosta sitä erittäin suurille tai hitaille pilvivarmuuskopioille (ajo, joka peruutetaan rajalla, epäonnistuu viestillä context deadline exceeded). Aseta 0 poistaaksesi rajan kokonaan. Karsinta pidetään samassa rajassa, ja tarkistus tai karsinta ajaa niin kauan kuin restic jatkaa edistymisen raportointia. |
BACKUP_STALL_HOURS |
Ei | Tunnit, jotka varmuuskopio saa olla ilman mitään edistymistä, ennen kuin se perutaan. Tyhjä (oletus) käyttää arvoa 2. Aseta 0, jos et halua koskaan perua jumiutumisen vuoksi. Tämä on kahdesta suojasta hienompi ja yleensä se, joka laukeaa: se seuraa, tapahtuuko vielä mitään, ei sitä, kuinka kauan ajo on kestänyt, joten hidas mutta terve usean teratavun varmuuskopio jätetään rauhaan, kun taas vastaamattomaan jakoon jumittunut pysäytetään tunneissa päivien sijaan. Varoitus kirjataan lokiin 30 minuutin hiljaisuuden jälkeen, ennen kuin mitään perutaan. Skannaus lasketaan edistymiseksi: restic ei kirjoita tavuja kävellessään suurta puuta, ja kyseistä vaihetta seurataan sen tiedosto- ja tavusummien eikä kirjoitettujen tavujen kautta. Nämä kaksi muuttujaa ovat riippumattomia, ja BACKUP_MAX_HOURS rajaa edelleen varmuuskopiota itseään seuraavat vaiheet (säilytys, tilastot, etäkopio), joissa ei ole laskureita seurattavaksi. |
DB_DUMP_MAX_HOURS |
Ei | Tunnit, jotka yksi automaattinen tietokantavedos saa ajaa, ennen kuin se pysäytetään. Tyhjä (oletus) käyttää arvoa 6. Sallitut arvot ovat 1-48, ja raja pidetään tunnin BACKUP_MAX_HOURS-arvon alapuolella (puolessa siitä, kun se on alle kaksi tuntia), jotta pitkä vedos katkaistaan sen omaan rajaan ja raportoidaan sellaisena sen sijaan, että se veisi varmuuskopion mukanaan. Vedos, joka ei edisty, pysäytetään aiemmin, BACKUP_STALL_HOURS jälkeen. Pysäytetty vedos epäonnistuu yksinään, ja kontin varmuuskopio jatkuu. Unraidissa lisää se BombVault-konttiin valinnalla Add another Path, Port, Variable. |
TZ |
Ei | Ajastimen aikavyöhyke (esimerkiksi Europe/Berlin). Jätä se asettamatta, niin jokainen aikataulu ajetaan UTC:ssä: kello 02.30 asetettu laukeaa silloin kello 02.30 UTC eikä oman seinäkellosi mukaan. Unraidissa et koskaan aseta tätä itse: järjestelmä välittää oman aikavyöhykkeensä jokaiseen konttiin. Käynnistysloki kertoo, mihin vyöhykkeeseen se ratkesi. Kesäaikaa käyttävä vyöhyke ohittaa yhden ajon keväällä ja ajaa yhden kahdesti syksyllä, kun taas UTC ei tee kumpaakaan mutta ajautuu tunnin kellostasi kahdesti vuodessa. |
DATA_DIR |
Ei | Missä BombVault pitää tietokantansa, avaimensa ja välimuistinsa (oletus /config). Jätä se rauhaan kontissa. Sillä on merkitystä, kun ajat binaaria Dockerin ulkopuolella. |
FLASH_DIR, FLASH_TEMPLATES_DIR |
Ei | Missä flash-asema ja sen Docker-mallit on liitetty kontin sisällä (oletukset /host/boot ja /host/boot/config/plugins/dockerMan/templates-user). Ne seuraavat mallin /boot-liitosta, joten jätä ne asettamatta. |
MODE |
Ei | full (oletus) ajaa koko sovelluksen. node ajaa solmun: ei verkkokäyttöliittymää eikä omia aikatauluja, vain se, mitä sen kotiinstanssi käskee. Mikä tahansa muu arvo pysäyttää käynnistyksen viestiin. Kotiinstanssi täyttää arvon puolestasi solmun compose-tiedostoon. |
NODE_HOME |
Solmulla | Mihin kotiinstanssiin solmu kuuluu, kotiinstanssin avaimen ja releen kanssa, yhtenä arvona, joka alkaa bvhome1.. Kotiinstanssi kirjoittaa sen solmun compose-tiedostoon. Ilman sitä solmu käynnistyy, mutta mikään kotiinstanssi ei tavoita sitä. Solmu, jonka kotiinstanssi on ottanut hoitoonsa, kieltäytyy käynnistymästä, kun NODE_HOME nimeää toisen kotiinstanssin, kunnes se kotiinstanssi vapauttaa sen. |
NODE_NAME |
Ei | Solmun nimi sellaisena kuin kotiinstanssi täytti sen antamastasi nimestä. |
Liitokset¶
Liitä Docker-soketti, flash (/boot) ja Host Data -juuri (/mnt) kuten CA-mallissa on esitetty. Varmuuskopioiden lähteet ja kohteet sijaitsevat molemmat Host Datan alla, ja se liitetään slave-tilassa, jotta etäjako, joka liitetään kontin käynnistyksen jälkeen (esimerkiksi polun /mnt/remotes alle), tulee näkyviin ilman uudelleenkäynnistystä.
TrueNASissa Host Data on tietojoukon polku, kuten /mnt/tank, ei koskaan ixVolume. Data, jonka sovellus pitää ixVolumessa, on sen ulkopuolella eikä sitä varmuuskopioida. Katso TrueNAS SCALE.
Myös ZFS-tietojoukkojen varmuuskopiointi tarvitsee tämän tilan: isäntä liittää tietojoukon tilannevedoksen vasta kontin käynnistyttyä. Katso ZFS-tietojoukot.
Paikalliset repot ovat oletuksena polussa /mnt/user/bombvault/{container,vms,flash,config,files,zfs}, ja ne luodaan ensimmäisessä varmuuskopiossa. Ne ovat osioiden omat kansiot ja muodostavat Paikallinen-kohteen. Sen sivulla kohdassa Kohteet Yhteys-kortti vaihtaa kunkin osion kansion.
Osion oma kansio voi sijaita myös kohteessa, joka sinulla jo on, kuten NAS tai S3-ämpäri: Käytä omana kansiona kohteen sivulla siirtää sen sinne ja kertoo ensin, mitä jo tehdyille varmuuskopioille tapahtuu. Katso Osion oma kansio.
Paikallisten repojen kansiot pysyvät tiloissa 0755 ja 0644, jotta SMB:n yli toimiva ei-root-synkronointikäyttäjä ei jää ulos, ja repot ovat salattuja, joten tämä ei paljasta mitään. Palautusmääritykset ovat jokaisen repon sisällä, joten kopioitu kansio on kokonainen sellaisenaan. Itsevarmuuskopion repo pysyy vain rootin luettavana.
Isäntäintegraation tarkistus
Yleiskatsauksen Isäntäintegraatio-kortti (lisää se kohdassa Mukauta) koettelee jokaisen liitoksen ja komentorivityökalun (Docker-soketti, libvirt, restic, qemu-img, rclone) ja raportoi puuttuvat osat.
Varmuuskopiolähteen tunnistus¶
BombVault valitsee jokaiselle kontille automaattisesti, mitkä bind mountit ja nimetyt taltiot varmuuskopioidaan. Polku poimitaan, kun jokin seuraavista pätee (voit aina ohittaa tuloksen kontin Asetukset-välilehden Varmuuskopioitavat kansiot -kortissa):
- Dataan viittaavan polunosan vastaavuus: bindin isäntälähde sisältää yhden
DATA_ROOT_SEGMENTS-osista täytenä polun komponenttina (oletuksena vainappdata). - Docker-nimetyt taltiot sisällytetään aina, koska niillä ei ole kertakäyttöistä vastinetta eikä mitään suodatettavaa, mutta vain kun taltion todellinen isäntätallennuspolku on itse tavoitettavissa Host Data -liitoksen kautta, aivan kuten mikä tahansa muu isäntäpolku, jonka BombVault varmuuskopioi. Dockerin oletuksena oleva paikallinen taltioajuri tallentaa taltion daemonin oman datajuuren alle (
/var/lib/docker/volumes/<name>/_data, ellet ole mukauttanut sitä. Tarkista komennolladocker info -f '{{.DockerRootDir}}'), jota ei kata kapea, yhden hakemiston Host Data -liitos, jota yleinendocker-compose.ymlkäyttää oletuksena. Tavoittamaton taltio ohitetaan hiljaa, se ei ole virhe. Varmuuskopioidaksesi nimetyt taltiot yleisellä isännällä osoita Host Data (jaHOST_SOURCE_ROOT) yhteiseen kantahakemistoon, joka kattaa myös Dockerin datajuuren. Compose-tiedoston Host Data -kommentti selittää kompromissin (Unraid kiertää tämän liittämällä koko/mnt:n, oman yleisen ylätason käytäntönsä, samasta syystä). - Docker Composen projektihakemisto: jos kontilla on tavallinen
com.docker.compose.project.working_dir-tunniste (asetetaan automaattisesti komennolladocker compose up), myös kyseinen hakemisto lisätään, riippumatta siitä, täsmäsikö mikään bind datajuuren osaan. bombvault.data-tunnisteen ohitus: aseta kontille tunnistebombvault.data=truesisällyttääksesi kaikki sen bind mountit asetteluun, jota kumpikaan yllä oleva käytäntö ei havaitse (esimerkiksi yksittäinen/srv/plex/config-bind ilman Compose-projektia). Mikä tahansa tyhjä arvo paitsifalselasketaan tosiksi. Puuttuva tunniste taibombvault.data=falseei muuta mitään.bombvault.dbdump-tunniste: aseta kontillebombvault.dbdump=falsekytkeäksesi sen automaattisen tietokantavedoksen pois (myös0,nojaofftoimivat), tai nimeä moottori (postgres,mysql,mariadb) vedostaaksesi kontin, jota BombVault ei tunnista itse. Tunniste voittaa kontin Asetukset-välilehden Tietokanta-kortin kytkimen, joka on tapa tehdä se Unraidissa.
Tietoturvamalli¶
Isännän roottia vastaava hallinta
Docker-soketin kautta BombVault voi pysäyttää, poistaa ja luoda uudelleen kontteja sekä lukea ja kirjoittaa appdataa, ja virtuaalikoneiden varmuuskopiointia varten se kirjautuu isäntään SSH:n yli (qemu+ssh://, oletuksena root) ajaakseen virsh-komentoa. Jokaisella, joka pääsee sen verkkokäyttöliittymään, on käytännössä root isännällä.
Kirjautuminen¶
- Valinnainen salasanasuojaus (Salasana-kortti kohdassa Asetukset, Turvallisuus): aseta salasana vaatiaksesi kirjautumisen, tyhjennä se kytkeäksesi pois. Oletuksena pois luotetussa lähiverkossa. Salasana tallennetaan Argon2id:llä
APP_KEY-avaimella suolatun pepperin päälle, joten kopioitu/configon arvoton ilman avainta ja hidas murtaa sen kanssa. Uusi salasana tarvitsee vähintään 12 merkkiä. Olemassa oleva lyhyempi toimii, kunnes se vaihdetaan. Istunnot allekirjoitetaan (HMAC johdettunaAPP_KEY-avaimesta), ja salasanan vaihtaminen mitätöi ne. Kirjautumiset rajoitetaan viiteen epäonnistumiseen minuutissa asiakasta kohti. Salasanan vaihtaminen tai tyhjentäminen kysyy Nykyisen salasanan ja kaksivaiheisen tunnistautumisen ollessa päällä koodin. - Jotkin asiat vaativat salasanan. Palautuspaketin, virheraportin ja flash-varmuuskopion ZIP-tiedoston lataaminen, flash- tai itsevarmuuskopion vienti, avaimen tallettaminen säilyttäjälle, avaintallenteen luovutuksen sallimisen, uuden palautuskoodin tekemisen, asetusten viennin tunnuksineen, kaksivaiheisen tunnistautumisen, pääsyavaimet, solmun lisääminen, solmun compose-tiedoston näyttäminen uudelleen ja solmun merkintöjen avaaminen kielletään, kunnes kirjautumissalasana on asetettu, ja ne vaativat kirjautumisen itse ilmentymässä. Varmuuskopioiden poistaminen toimii ilman salasanaa. Kun salasana on asetettu, sekin vaatii tämän kirjautumisen.
- Kohde ei näytä salasanaa. Kohde voi sisältää tunnukset, kuten
rest:https://user:password@host/repo, ja jokainen sivu ja API-vastaus näyttää sen muodossarest:https://[redacted]@host/repo, oli kirjautumissalasana asetettu tai ei. Jos muutat sen takana olevaa polkua, tallennettu salasana säilyy. Kun haluat kohteen osoittavan toiseen palvelimeen, kirjoita koko kohde salasanoineen, koska piilotettu salasana pysyy palvelimensa mukana. - Kaksivaiheinen tunnistautuminen (Asetukset, Turvallisuus): tunnistussovelluksen aikakoodi salasanan lisäksi sekä kahdeksan kertakäyttöistä palautuskoodia, jotka annetaan kerran, kun se kytketään päälle. Jaettu salaisuus tallennetaan salattuna
APP_KEY-avaimella, ja tekijän kytkeminen jälleen pois vaatii voimassa olevan koodin. - Pääsyavaimet (WebAuthn) ovat omalla kortillaan, kun salasana on asetettu, salasanan rinnalla eivätkä koskaan sen sijaan, joten kaikkien pääsyavainten poistaminen ei sulje ketään ulos. Ne tarvitsevat oikean verkkotunnuksen ja varmenteen, johon selain luottaa. Oletuksena oleva
https://<ip>:3443on täsmälleen se, minkä WebAuthn hylkää, ja kortti kertoo sen sen sijaan, että tarjoaisi painikkeen, joka epäonnistuu. Kaksivaiheisen tunnistautumisen ollessa päällä pääsyavaimen on tarkistettava PIN, sormenjälkesi tai kasvosi, tai kirjautuminen kysyy myös koodia. - Asetusten palautus (Palauta asetukset Hätäohjatussa toiminnossa) päättää jokaisen istunnon, poistaa jokaisen pääsyavaimen ja kumoaa jokaisen API-tokenin ja MCP-avaimen, koska palautetut asetukset voisivat tuoda takaisin sellaisia, jotka poistettiin niiden tallentamisen jälkeen. Kirjaudu salasanalla ja aseta pääsyavaimesi uudelleen kohdassa Asetukset, Turvallisuus.
- Unohtunut salasana nollataan kirjautumissivulla. Unohtuiko salasana? saa BombVaultin kirjoittamaan 12 merkin koodin, kolmessa neljän ryhmässä, konttinsa lokiin (Unraidissa: Docker-välilehti, BombVaultin kuvake, Lokit). Kyseinen koodi ja uusi salasana kirjaavat sinut sisään. Nollaus kytkee myös kaksivaiheisen tunnistautumisen pois, poistaa jokaisen pääsyavaimen, kumoaa jokaisen API-tokenin, MCP-avaimen ja OAuth-kirjautumisen, päättää jokaisen muun istunnon, kirjaa ulos jokaisen pariliitetyn puhelimen ja kytkee puhelinten pariliitoksen pois. Sivu listaa sen jälkeen, mitä meni. Koodi on voimassa 10 minuuttia, eivätkä väärät arvaukset kuluta sitä. Widget- ja metriikkatokenit säilyvät, koska ne vain lukevat.
- Se, joka voi lukea kontin lokia, voi nollata salasanan. Se on root isännällä, mutta myös lokinkatselin, kuten Dozzle, mikä tahansa kontti, jolle on annettu Docker-soketti (vain luku riittää) sekä lokinsiirtäjä, joka välittää kontin tulosteen. Anna ne vain ihmisille, joihin luottaisit salasanankin kanssa. Joku, joka tavoittaa vain verkkokäyttöliittymän, ei koskaan näe koodia.
Puhelimet ja ryhmän jäsenet¶
- Pariliitetyt puhelimet yltävät sallittujen listalle. Puhelin, joka tuntee ryhmän kaksitoista sanaa, kirjautuu ilman salasanaa, kunhan Puhelimet voivat pariutua ryhmän kahdentoista sanan avulla on päällä Android-sovellus-kortissa kohdassa Asetukset, Turvallisuus. Sen istunto yltää vain siihen, mitä sovellus näyttää: yleiskatsaus, ajot, varmuuskopiot katsottavaksi, käynnistettäväksi ja palautettavaksi, poikkeamat luettaviksi ja Ilmentymät-sivu katsottavaksi. Kohteet ja komennot tavoittavat sen osoitteet ja salaisuudet poistettuina, ja palautus, joka korvaa alkuperäisen, varmuuskopioi nykytilan ensin. Palautus kansioon hyväksyy vain uuden tai tyhjän kansion palautuskansion sisällä, eikä puhelin voi katsoa mihinkään muuhun kansioon. Kaikki muu vastaa, että vaatii kirjautumisen itse ilmentymässä: avaimet, palautuspaketti, avaintallenteet, asetukset, varmuuskopioiden poistaminen. Salasanan nollaus kytkee puhelinten pariliitoksen pois, kunnes kytket sen takaisin päälle. Puhelin, joka poistetaan Ilmentymät-sivulta tai jonka Kysele tätä instanssia on kytketty pois sen tiedoissa, menettää istuntonsa heti, ja poistettu puhelin, joka avaa sovelluksensa uudelleen, palaa kytkettynä pois.
- Kodin ulkopuolella puhelin avaa sivut releen kautta. Jokainen sivun pyyntö sinetöidään ryhmän avaimella, jota rele ei voi lukea eikä muuttaa, ja allekirjoitetaan puhelimen omalla avaimella, jonka palvelin kiinnittää puhelimen ensimmäisellä kutsulla ja päästää sisään, kun joku hyväksyy puhelimen pariliitossivulla. Palvelin ajaa pyynnön kerran ja vain niin kauan kuin se on tuore. Se vastaa vain puhelimelle, joka on listattu Ilmentymät-sivulla puhelinten pariliitoksen ollessa päällä, ja vain istunnolla, jonka se antoi kyseiselle puhelimelle, joten kaikkialta ulos kirjautuminen ja salasanan nollaus päättävät nämä sivut myös. Palvelin allekirjoittaa jokaisen vastauksen, ja sovellus tarkistaa allekirjoituksen avainta vasten, jonka se kiinnitti kyseiselle palvelimelle, ja varoittaa, kun avain muuttuu. Tällainen sivu yltää samaan sallittujen listaan kuin pariliitetty puhelin, kirjautumissalasanalla tai ilman, sekä kirjautumistilaan, jonka sivu lukee ensin. Sisään- ja uloskirjautuminen, salasanan nollaus ja lataukset pysyvät palvelimen omassa osoitteessa, ja yksi vastaus rajataan 16 MB:hen.
- Jäsenet allekirjoittavat sen, mitä pyytävät. Roolipyynnöt ja niiden vastaukset, kohdetarjoukset, restic-salasanan luovutus vastaanottajalle tai noutajalle, vastaanottajan kirjautumiset ja avaintallenteet allekirjoitetaan kunkin jäsenen avaimella, jonka ilmentymä kiinnittää ensimmäisellä kerralla, kun se näkee kyseisen jäsenen. Toisella avaimella allekirjoitettu kutsu hylätään. Unohda avain ilmentymän tiedoissa pudottaa kiinnitetyn avaimen sellaisessa tapauksessa, että täällä tunnettu ei ole jäsenen oma. Jäseneltä pyydetään sen avainta uudelleen seuraavassa allekirjoitetussa kutsussa. BombVault 9.x -jäsenet eivät allekirjoita, ja heiksi voi esiintyä kuka tahansa, jolla on sanat, kuten versiossa 9.9. Roolipyyntö tai kohdetarjous jäseneltä, jolla on versio 10.4 tai vanhempi, hylätään, kunnes jäsen on päivitetty.
- Kaksitoista sanaa ovat salasana. Jokainen, jolla ne on, liittyy ryhmään, näkee jäsenten suojauksen tilan ja voi pyytää rooleja, jotka toisen ilmentymän ihmisen on vielä sallittava. Ilman kirjautumissalasanaa jokainen, joka voi avata verkkokäyttöliittymän, voi lukea ne, ja pariliitoskortti kertoo sen, kunnes salasana on asetettu.
Avaimet¶
- APP_KEY tekee kaksi asiaa. Se sinetöi sen, minkä tämä asennus tallentaa (salasanat, tunnukset, tokenit), ja se on varmuuskopioiden avain: restic-salasana johdetaan siitä, ja kontti- ja virtuaalikonemääritykset sinetöidään sillä.
- Käyttöön otettu avain pidetään erillään. Kun Hätäohjattu toiminto ottaa käyttöön toisen palvelimen varmuuskopiot, tämä asennus jatkaa sinetöintiä omalla APP_KEYllään ja tallentaa toisen palvelimen avaimen varmuuskopioavaimekseen, sinetöitynä kuten jokainen muu salaisuus. Palautuspaketti tulostaa silloin molemmat. Jos APP_KEY muutetaan sen jälkeen, varmuuskopioavainta ei voi enää avata: BombVault lopettaa varmuuskopioinnin ja kertoo sen kohdassa Vaatii huomiota sen sijaan, että kirjoittaisi väärällä avaimella. Lähetä palautuspaketti uudelleen kohdassa Palautus, Hätätilanne tai aseta APP_KEY takaisin. Katso Hätäohjattu toiminto.
- Salaus on oletuksena päällä (Salaa varmuuskopiot Salaus-kortissa kohdassa Asetukset, Turvallisuus). Restic salaa varmuuskopiot salasanalla, joka johdetaan varmuuskopioavaimesta.
- Avaintallenteet. Ryhmäsi säilyttäjä pitää sinetöityä kopiota tämän palvelimen palautuspaketista, jota se ei voi itse avata. Vain 20 merkin palautuskoodi avaa sen, ja säilyttäjä luovuttaa sen vasta, kun joku siellä painaa Salli. Katso Säilyttäjä.
Solmut¶
Solmu on BombVault ilman verkkokäyttöliittymää, joka ottaa ohjeensa kotiinstanssilta.
- Kotiinstanssi hallitsee solmua. Solmu liittää palvelimensa Docker-soketin, mikä vastaa siellä root-oikeuksia, ja kotiinstanssi ohjaa solmua. Jos kotiinstanssi kaapataan, hyökkääjä hallitsee myös kaikkia sen solmuja. Anna kotiinstanssille kirjautumissalasana ja pidä sen verkkokäyttöliittymä poissa internetistä.
- Solmulla on vähän. Jos solmu kaapataan, hyökkääjä ei saa pariliitosryhmää, linnoitusta, muita solmuja eikä muita repositoryja. Solmulla on vain yhteys kotiinstanssiinsa, oma tunnus vastaanottopalvelimella ja oma kansio kohteessa. Vastaanottopalvelimella se ei voi poistaa historiaa, koska palvelin on append-only-tilassa. Se voi täyttää palvelimen levyn, koska rest-server ei aseta kiintiötä, joten anna vastaanottopalvelimelle tilaa tai oma jako. Kohteessa sen tunnuksilla voi yleensä poistaa sinne tallennettua. Solmulla säilytetyt varmuuskopiot ovat hyökkääjän käsissä, ja siksi kotiinstanssi hakee niistä kopion.
- Yhteys on yksityinen ja allekirjoitettu. Kotiinstanssi ja solmu keskustelevat releen kautta omaa yhteyttään pitkin, joka on sinetöity solmun
APP_KEY-avaimesta johdetulla salaisuudella. Kumpikin osapuoli tuntee toisen avaimen jo ennen ensimmäistä kutsua, joten hyväksymisvaihetta ei ole. Kotiinstanssi allekirjoittaa jokaisen kutsun omalla avaimellaan ja laskurilla, ja solmu hylkää kutsun, jota kotiinstanssi ei ole allekirjoittanut tai jonka se on jo ottanut vastaan. Solmu ei kutsu kotiinstanssissa mitään muuta kuin tervehdystään. - Kotiinstanssi tavoittaa kiinteän listan. Pyynnöt, jotka kotiinstanssi välittää solmulle, toimivat vain solmun kiinteän reittilistan reiteillä, jotka näkyvät osoitteessa
GET /api/nodes/routes, ja solmu vastaa niihin vain JSONilla. Mikään listalla ei poista mitään eikä ulotu asetuksiin, tallennustilaan, avaimiin, ryhmään tai tokeneihin. Kotiinstanssissa ne vaativat kirjautumisen salasanalla: pariutetut puhelimet, API-tokenit ja MCP-avaimet eivät ulotu solmuun. Näin käynnistetyt varmuuskopiot ja palautukset näkyvät kotiinstanssin käynnistäminä. - Avaintallenteet sisältävät solmujen avaimet. Kotiinstanssi pitää jokaisen solmun
APP_KEY-avainta, ja palautuspaketti tulostaa sen luvussaan Solmut, joten avaintallenne sisältää sen myös. Säilyttäjä, joka saa talletuksen ja palautuskoodin, voi avata solmujesi repositoryt, mutta se ei voi komentaa solmua, koska siihen tarvitaan kotiinstanssin allekirjoitus. - Vapautus on lopullinen. Vapautettu solmu ei ota uutta kotiinstanssia samalla
APP_KEY-avaimella. Solmu, joka on poissa, kun vapautat sen, kuulee asiasta kotiinstanssilta palattuaan.
Verkko¶
- Muutokset vaativat JSONin. Pyynnön, joka muuttaa jotakin, on lähetettävä
Content-Type: application/json, eikä selain saa merkitä sitä sivustojen väliseksi, joten toisen sivuston sivu ei voi saada selaintasi muuttamaan asetuksia lähiverkon osoitteessa. API:a ajava skripti lähettää tämän otsikon. Kaikki muu hylätään koodilla415. - Koska portti on valinnainen, kun se on asettamatta, koko käyttöliittymä ja API (kohteet, peukalointitestin reitit ja palautusreitit mukaan lukien) ovat jokaisen tavoitettavissa, joka pääsee porttiin. Aseta kirjautumissalasana heti, kun etäpään, vain lisäävät varmuuskopiot tai salaus ovat käytössä.
- Aja BombVaultia vain luotetussa, ulos paljastamattomassa verkossa. Etäkäyttöä varten laita se käänteisen välityspalvelimen taakse, joka lisää tunnistautumisen ja TLS:n. Vastaukset kantavat perustason tietoturvaotsikot (CSP,
nosniff,X-Frame-Options,Referrer-Policy). - Käänteisen välityspalvelimen takana jokainen pyyntö kantaa välityspalvelimen osoitetta, joten ilman
TRUSTED_PROXY-asetusta kirjautumisrajoitus laskee kaikki asiakkaat yhteen koriin ja hyökkääjän epäonnistumiset lukitsevat myös sinut. Nimeä välityspalvelin asetuksessaTRUSTED_PROXYsaadaksesi asiakaskohtaisen laskennan takaisin. - BombVaultin edessä olevan käänteisen välityspalvelimen on välitettävä
Authorization- taiX-API-Key-otsikko läpi kohteelle/mcp, eikä se saa puskuroida vastauksiaan, tai avustajat eivät saa yhteyttä. Katso MCP-palvelin. - MCP-päätepiste
/mcpvastaa404, kunnes avain on olemassa tai kirjautuminen OAuthilla on kytketty päälle, ja se kysyy jokaiselta asiakkaalta sen avainta tai tunnistetta, vaikka kirjautumissalasana olisi pois päältä. Mikään osoite ei ole vapautettu, ei edeslocalhost. Siinä ei ole palautus- eikä poistotyökaluja, ja asetusvarmuuskopion palautus kumoaa jokaisen avaimen. Katso MCP-palvelin. - Asetuksella
HTTP_ONLY=trueistuntoevästeeltä puuttuuSecure-lippu (niin täytyy olla, jotta se toimii tavallisella HTTP:llä), joten ota salasana käyttöön vain TLS:n päättävän välityspalvelimen takana, jos luottamuksellisuus on tärkeää. - VM-varmuuskopioinnin SSH-yhteys luottaa isäntäavaimeen ensimmäisellä yhteydellä (TOFU) ja kiinnittää sen sen jälkeen. Varmista isännän avain toista kautta, jos kontin ja isännän välinen reitti ei ole luotettu.
- Linkit eivät johda liitoksen ulkopuolelle. Varmuuskopiointi tai paikalleen tehtävä palautus pysähtyy ilmoitukseen, kun sen polun yläpuolella oleva linkki johtaa isäntäliitoksen ulkopuolelle, koska kontti, joka kirjoittaa omaan jakoonsa, voisi istuttaa sellaisen. Kohde, jonka isäntä tai rclone-remote alkaa viivalla, hylätään samalla tavalla tallennettaessa ja seuraavassa ajossa, koska
sshtairclonelukisi sen valitsimena.
MCP-palvelin¶
MCP-palvelin ei tarvitse ympäristömuuttujaa. Kytket sen päälle luomalla avaimen kohdassa Asetukset, Integraatiot, MCP-palvelin, ja se vastaa osoitteessa /mcp samassa portissa kuin verkkokäyttöliittymä (esimerkiksi https://192.168.1.10:3443/mcp). Ilman aktiivista avainta kyseinen polku vastaa 404. Asiakkaat, varmenteet ja rajat kuvataan sivulla MCP-palvelin.
VM-varmuuskopiointi SSH:n yli¶
BombVault varmuuskopioi KVM/libvirt-virtuaalikoneet liittämättä yhtään libvirt-polkua. Se ajaa virsh-komentoa isännällä SSH:n yli (qemu+ssh://), joten se ei voi koskaan vaikuttaa isäntäsi VM Manageriin.
Isännän libvirt-soketin liittäminen konttiin on hauras tapa Unraidissa: VM Manager omistaa kyseiset polut, ja "Enable VMs" -asetuksen vaihtaminen voi jättää libvirtin kykenemättömäksi käynnistymään. SSH-avain antaa rootin isännällä, saman luottamustason kuin Docker-soketti, jota BombVault jo käyttää.
Pikaopas:
- Asetukset, Integraatiot, Palvelimen SSH: kopioi näytetty julkinen avain.
- Lisää se Unraidin tiedoston
/root/.ssh/authorized_keysloppuun (tallennetaan myös flashille, jotta se säilyy uudelleenkäynnistyksissä). - Napsauta Testaa yhteys.
Malli lisää --add-host=host.docker.internal:host-gateway, jotta kontti tavoittaa isännän. Aseta LIBVIRT_HOST Unraidisi lähiverkon IP-osoitteeksi, jos kyseinen nimi ei ratkea (esimerkiksi kun kontti ajaa mukautetussa br0.x-verkossa). Jos vaihdoit Unraidin SSH-portin, aseta LIBVIRT_SSH_PORT vastaamaan sitä. Live-tilannekuvat tarvitsevat lisäksi qemu guest agentin virtuaalikoneessa ja levyn polussa /mnt/cache (ei /mnt/user).
Täydellinen VM-asennus- ja verkko-opas
Täydellinen vaiheittainen opas (SSH:n käyttöönotto, pysyvä avaimen valtuutus, mukautetun verkon ja VLANin reititys, virtuaalikonekohtainen menetelmä ja isäntäpuolen vianmääritys) on VM-varmuuskopiointiopas.
Etäkohteiden määritys¶
Etäkopiot menevät kohteisiin. Avaa Kohteet sen asetusruudusta (tai kiinnitä se sivupalkkiin) ja valitse Lisää kohde. Katso Etäsijainti ja palautus koko työnkulusta (poistosuoja, peukalointitestaus ja DR-harjoitukset). Lyhyesti:
- Taustajärjestelmät: SMB/CIFS ja WebDAV rclonen kautta ilman isäntäliitosta, NFS (liitä jako isännälle ja käytä sitä paikallisena kansiona), natiivit restic-taustajärjestelmät ilman rclonea (
s3:...,rest:http://host:8000/repo,sftp:user@host:/repo) tai mikä tahansa rclone-remote (rclone:<remote>:<bucket>/path). Backblaze B2:lla ei ole natiivia taustajärjestelmää täällä: käytä sitä sen S3-päätepisteen kautta (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>) avaintunnuksella ja sovellusavaimella S3-tunnuksina. - Tunnukset tallennetaan salattuina yhtenä listana tallennettuja tunnuksia Tunnukset-kortissa kohdassa Asetukset, Kohteet. Tähti merkitsee oletuksen, jota käytetään kaikkialla, missä tunnusta ei ole valittu. Kohteen oma sivu valitsee käytettävän Tunnistetiedot-kortissaan. Katso Tunnukset.
- SSH-kohteet eivät tarvitse mitään asennettuna toiseen päähän.
sftp:tarvitsee vain SSH-palvelimen. Lisää julkinen avain kohdasta Asetukset, Integraatiot, Palvelimen SSH (myös polussa/config/ssh/id_ed25519.pub) kohdekäyttäjän tiedostoon~/.ssh/authorized_keystai anna Lisää avain kohdassa Lisää kohde laittaa se sinne tilin salasanalla. - Rest-palvelin itse allekirjoitetulla varmenteella: laita sen varmenne tai sen allekirjoittaneen tahon varmenne PEM-tiedostona BombVaultin datakansion
certs-kansioon (/config/certskontissa,appdata/bombvault/certsUnraidissa). Varmuuskopiot, kopiot ja poistosuojan testi luottavat siihen ilman uudelleenkäynnistystä. - Etäkopio: BombVault kopioi uudet tilannevedokset komennolla
restic copyparhaan mahdollisen yrityksen periaatteella, (yleensä paikallisen) ensisijaisen lisäksi. Kohteen Kopioi-kortti asettaa, kopioiko se Jokaisen varmuuskopion jälkeen vai omalla aikataulullaan, ja Asetukset, Aikataulut, Etäkopiot osioittain antaa yhdelle osiolle oman kopioaikataulun. Replikoi nyt on osion rivillä Etäkopiot-kortissa kohdassa Asetukset, Kohteet. - Useita kohteita osiota kohti: Kohteet osioittain -kortti Kohteet-sivulla kytkee jokaisen osiosta kohteeseen vievän rivin päälle tai pois yhdellä napsautuksella, Paikallinen mukaan lukien. Osio, jolla on vain etäkohteita, varmuuskopioi suoraan niihin, ja osiota, jonka jokainen rivi on pois, ei varmuuskopioida. Kohteen Säännöt osioittain antavat yhdelle osiolle oman repon, säilytyksen tai pakkauksen siellä.
- Sijoittelu merkinnän mukaan: jokainen kontti, virtuaalikone ja kansiojoukko valaisee Paikallinen-kohdan ja ne kohteet, jotka saavat sen varmuuskopiot, Aikataulu ja kohde -kortissa sen Asetukset-välilehdellä. Merkinnät ilman omaa valintaa seuraavat osiotaan. Katso Sijoittelu merkinnän mukaan.
- Säilytys: jokainen kohde säilyttää varmuuskopioita Kuinka kauan säilytetään -korttinsa mukaan, ja osio voi pitää siellä omat arvonsa kohdassa Säännöt osioittain. Se koskee myös osion etäkentässä olevaa kopiota. Kaikki nollia ei koskaan karsi kohteen tilannevedoksia.
- Kaistanleveysrajat: rajaa resticin lähetys- ja latausnopeutta Etäkaistanleveys-kortissa kohdassa Asetukset, Kohteet tai kohteittain sen Kopioi-kortissa. Syötät KiB/s, ja kenttä näyttää saman nopeuden yksiköissä MB/s ja Mbit/s.
- Suoratoisto ensin: valitse Suoratoisto-kortissa Kohteet-sivulla mediapalvelimet (Plex, Jellyfin ja Emby on esivalittu imagen nimen perusteella), lähetysnopeus, josta alkaen jokin lasketaan suoratoistoksi, lähetysraja suoratoiston aikana ja kuinka pitkän ajan kuluttua suoratoiston jälkeen normaali raja palaa.
- Kylmä ja arkistoitu tallennusluokka (S3): S3-kohteelle valitse sen sivulla palautuskelpoinen taso (Standard, Standard-IA, One Zone-IA, Intelligent-Tiering, Glacier Instant Retrieval). rclone-remotet asettavat luokkansa rclone-kokoonpanossa.
- Oma kansio kohteessa paikallisen sijaan: osion oma kansio voi sijaita yhdessä yllä olevista kohteista, ilman paikallista kopiota ja ilman kopiointivaihetta. Katso Osion oma kansio.
Poikkeamat¶
Poikkeamien tunnistus ei tarvitse ympäristömuuttujaa. Se asetetaan Poikkeamat-kortissa kohdassa Asetukset, Tarkista, kuvattuna sivulla Poikkeamat.
Siirrettävät asetukset (vienti ja tuonti)¶
Vie / tuo asetukset -kortti kohdassa Asetukset, Järjestelmä kirjoittaa koko BombVault-kokoonpanosi (osioiden asetukset, kohteet, aikataulut, säilytys, ilmoitukset) siirrettävään JSON-tiedostoon, jonka voit tuoda toiseen ilmentymään, joten uuteen laatikkoon siirtyminen tai asetuksen kloonaaminen ei tarkoita kaiken kirjoittamista käsin uudelleen. Tuonti näyttää esikatselun ja pyytää vahvistuksen, eikä se koskaan kosketa varmuuskopiodataasi tai historiaasi. Tiedoston linkit kohteisiin tai repoihin, joita ei enää ole, jätetään pois, ja esikatselu nimeää ne. ZFS-replikan ollessa käynnissä tuonti kielletään ennen kuin mitään kirjoitetaan.
Vienti voi sisältää tunnuksia
Valitset, otetaanko etäpään, ilmoitusten ja MQTT-välittäjän tunnukset mukaan tiedostoon. Tunnusten ollessa mukana vienti on yhtä arkaluonteinen kuin palautuspakettisi, joten säilytä se turvallisessa paikassa. Ilman niitä tiedosto sisältää vain ei-salaisia asetuksia.
APP_KEY ei kulje tiedoston mukana
Repot on lukittu salasanalla, joka johdetaan APP_KEY:stä, eikä tiedosto sisällä avainta. Kun siirryt suunnitellusti uuteen laatikkoon, anna sille vanha APP_KEY sen mallissa tai ota avain käyttöön palautuspaketilla kohdassa Hätätilanne. Toisella avaimella repot vastaavat, että salasana on väärä. Mitään ei ole menetetty, ja oikean avaimen asettaminen avaa ne taas.