Konfiguration¶
Diese Seite behandelt die Umgebungsvariablen des Containers, die Mounts, die das Template bereitstellt, das Sicherheitsmodell, die VM-Sicherung über SSH und die Off-site-Einrichtung. Wohin Sicherungen gehen, richtest du in der App als Speicherorte ein, nicht über Umgebungsvariablen.
Umgebungsvariablen¶
| Variable | Erforderlich | Beschreibung |
|---|---|---|
APP_KEY |
Ja | Hex-Geheimnis mit 32 Byte (64 Hex-Zeichen), aus dem das restic-Repo-Passwort abgeleitet wird. Erzeuge es mit openssl rand -hex 32. Bewahre es sicher auf: Geht es verloren, sind verschlüsselte Sicherungen unwiederbringlich. |
LIBVIRT_HOST |
Für VMs und ZFS-Datasets | Unraid-Host, der über SSH für VM- und ZFS-Dataset-Sicherungen erreicht wird (Template-Feld Host SSH: Address, Vorgabe host.docker.internal). Das Template trägt den Platzhalter 192.168.x.x vor, der als nicht gesetzt gilt. Nimm die LAN-IP deines Unraid, nötig in einem eigenen Netz br0.x. Löst sich host.docker.internal nicht auf, wie in einer TrueNAS-App, und nennt auch LIBVIRT_URI keinen Host, nutzt BombVault das Standard-Gateway des Containers, und das Boot-Protokoll nennt es. |
LIBVIRT_SSH_PORT |
Nein | SSH-Port des Hosts für VM- und ZFS-Dataset-Sicherungen (Template-Feld Host SSH: Port, Vorgabe 22). |
LIBVIRT_SSH_USER |
Nein | SSH-Benutzer auf dem Host für VM- und ZFS-Dataset-Sicherungen (Template-Feld Host SSH: User, Vorgabe root). |
LIBVIRT_URI |
Nein | Vollständige libvirt-Verbindungs-URI, die unverändert genutzt wird, statt aus den drei oben genannten LIBVIRT_*-Variablen eine zu bauen (die dann für die Verbindungszeichenfolge ignoriert werden). Vorgabe: nicht gesetzt. Nötig auf TrueNAS Scale, dessen libvirtd auf einem nicht standardmäßigen Socket lauscht, den die gebaute Form nicht ausdrücken kann: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. Siehe die Anleitung zur VM-Sicherung. Ist es eine qemu+ssh://-URI, wird jede der Variablen LIBVIRT_HOST, LIBVIRT_SSH_USER und LIBVIRT_SSH_PORT, die nicht gesetzt ist, daraus übernommen, auch für die eigenen SSH-Befehle von BombVault (NVRAM-Übertragung, ZFS-Datasets). |
PORT |
Nein | HTTP-Port (Vorgabe 3000. Wird nur mit HTTP_ONLY=true genutzt). |
HTTPS_PORT |
Nein | HTTPS-Port (Vorgabe 3443. Das Template veröffentlicht ihn 1:1, die WebUI antwortet also unter https://<ip>:3443). |
HTTP_ONLY |
Nein | Setze true, um den selbstsignierten HTTPS-Listener abzuschalten und nur einfaches HTTP zu liefern (zur Nutzung hinter einem Reverse-Proxy, der TLS beendet). |
BIND_HOST |
Nein | Adresse, auf der die WebUI lauscht (Vorgabe 0.0.0.0, jede Schnittstelle). Lass es im Container ungesetzt, dessen veröffentlichte Ports jede Schnittstelle brauchen. 127.0.0.1 passt zu einem Lauf außerhalb von Docker. Der Healthcheck fragt dieselbe Adresse. |
TRUSTED_PROXY |
Nein | Kommagetrennte Adressen oder CIDR-Bereiche des Reverse-Proxys vor BombVault (zum Beispiel 192.168.20.11 oder 10.0.0.0/8). Nur von diesen Hops wird X-Forwarded-For geglaubt, und die Login-Bremse zählt Fehlversuche dann pro echtem Client, statt alle hinter dem Proxy in einen Topf zu werfen. Ungesetzt (die Vorgabe) vertraut sie niemandem: Ein bedingungslos geglaubter Header ließe jeden Aufrufer seinen eigenen Topf wählen. |
HOST_SOURCE_ROOT |
Nein | Der Host-Pfad, der als Host Data gemountet ist (Vorgabe /mnt). BombVault übersetzt die Bind-Mount-Quellen, die Docker meldet, in Pfade unter diesem Mount. Ändere es nur, wenn du eine andere Host-Wurzel gemountet hast. |
HOST_MOUNT_ROOT |
Nein | Wo Host Data im Container gemountet ist (Vorgabe /host/user). Auf TrueNAS ist Host Data unter seinem eigenen Host-Pfad gemountet, daher nennen dieses und HOST_SOURCE_ROOT beide diesen Pfad, zum Beispiel /mnt/tank (siehe TrueNAS SCALE). |
DATA_ROOT_SEGMENTS |
Nein | Kommagetrennte Pfadsegment-Namen, die eine Bind-Mount-Quelle als Sicherungsdaten kennzeichnen (Vorgabe appdata, passend zur Unraid-Konvention /mnt/user/appdata/<container>). Der Bind-Mount eines Containers wird automatisch für die Sicherung gewählt, wenn IRGENDEIN aufgeführtes Segment als vollständiges Pfadsegment in seiner Host-Quelle vorkommt. Beispiel: DATA_ROOT_SEGMENTS=appdata,config greift auch einen .../config-Bind auf. Der Vergleich ignoriert Groß- und Kleinschreibung, die Vorgabe deckt also auch /DATA/AppData/<container> von ZimaOS ab. Siehe Erkennung der Sicherungsquellen für die anderen, immer aktiven Wege, wie der Datenordner eines Containers gefunden wird. |
PLATFORM |
Nein | Erzwingt, auf welcher Plattform BombVault sich laufend betrachtet, statt automatisch zu erkennen: unraid, generic oder truenas (Vorgabe nicht gesetzt: erkennt Unraid automatisch, indem es unter dem Flash-Mount nach seiner dockerMan-Markierung sucht, sonst generic. Auch ein unbekannter Wert fällt auf generic zurück, protokolliert). Setze es auf einem generischen Docker-Host oder TrueNAS Scale ausdrücklich, statt dich auf die Unraid-only-Erkennung zu verlassen. Die generische Compose-Datei tut das. Ändert die Appdata-Ausweichkonvention, die Vorgaben für Wiederherstellungsziele zwischen Instanzen und ob die Unraid-only-Schritte für Benachrichtigung und Begleit-Plugin überhaupt versucht werden (siehe internal/platform). |
BOMBVAULT_SELF_CONTAINER |
Nein | Der Name des BombVault-Containers selbst, damit er sich nie selbst sichert (und damit anhält). |
BACKUP_MAX_HOURS |
Nein | Höchstzahl an Stunden Wanduhrzeit, die ein einzelner Sicherungslauf die Sperre seiner Domain halten darf, bevor er zwangsweise abgebrochen wird (ein Schutz, damit ein festhängender Lauf die Domain nicht ewig blockiert). Leer (die Vorgabe) nutzt 48. Erhöhe es für sehr große oder langsame Cloud-Sicherungen (ein an der Grenze abgebrochener Lauf scheitert mit context deadline exceeded). Setze 0, um die Grenze ganz abzuschalten. Ein Aufräumen unterliegt derselben Grenze, und eine Prüfung oder ein Aufräumen läuft so lange, wie restic Fortschritt meldet. |
BACKUP_STALL_HOURS |
Nein | Stunden, die eine Sicherung gar keinen Fortschritt machen darf, bevor sie abgebrochen wird. Leer (die Vorgabe) nutzt 2. Setze 0, um nie wegen Stillstands abzubrechen. Das ist der feinere der beiden Schutzmechanismen und meist der, der greift: Er beobachtet, ob noch etwas passiert, statt wie lange der Lauf gedauert hat, sodass eine langsame, aber gesunde Sicherung mit mehreren Terabyte in Ruhe gelassen wird, während eine, die an einem nicht antwortenden Share hängt, in Stunden statt Tagen gestoppt wird. Nach 30 Minuten Stille wird eine Warnung protokolliert, bevor etwas abgebrochen wird. Das Durchsuchen zählt als Fortschritt: restic schreibt keine Bytes, während es einen großen Baum durchläuft, und diese Phase wird über seine Datei- und Bytesummen statt über die geschriebenen Bytes beobachtet. Die beiden Variablen sind unabhängig, und BACKUP_MAX_HOURS begrenzt weiterhin die Phasen nach der Sicherung selbst (Aufbewahrung, Statistik, Off-site-Kopie), in denen es keine Zähler zu beobachten gibt. |
DB_DUMP_MAX_HOURS |
Nein | Stunden, die ein automatischer Datenbank-Dump laufen darf, bevor er gestoppt wird. Leer (die Vorgabe) nutzt 6. Erlaubt sind die Werte 1 bis 48, und die Grenze bleibt eine Stunde unter BACKUP_MAX_HOURS (bei der Hälfte davon, wenn das unter zwei Stunden liegt), sodass ein langer Dump durch sein eigenes Limit abgeschnitten und als solcher gemeldet wird, statt die Sicherung mit in die Tiefe zu reißen. Ein Dump ohne Fortschritt wird früher gestoppt, nach BACKUP_STALL_HOURS. Ein gestoppter Dump scheitert für sich, und die Container-Sicherung läuft weiter. Auf Unraid füge es dem BombVault-Container mit Add another Path, Port, Variable hinzu. |
TZ |
Nein | Zeitzone für den Scheduler (zum Beispiel Europe/Berlin). Lässt du es ungesetzt, läuft jeder Zeitplan in UTC: Einer, der auf 02:30 steht, feuert dann um 02:30 UTC statt nach deiner eigenen Wanduhr. Auf Unraid setzt du das nie selbst: Das System reicht seine eigene Zeitzone an jeden Container weiter. Das Boot-Protokoll sagt, welche Zone es aufgelöst hat. Eine Zone mit Sommerzeit lässt im Frühjahr einen Lauf aus und führt im Herbst einen zweimal aus, während UTC beides nicht tut, aber zweimal im Jahr eine Stunde gegen deine Uhr driftet. |
DATA_DIR |
Nein | Wo BombVault seine Datenbank, Schlüssel und Caches hält (Vorgabe /config). Lass es im Container in Ruhe. Es zählt, wenn du die Binärdatei außerhalb von Docker laufen lässt. |
FLASH_DIR, FLASH_TEMPLATES_DIR |
Nein | Wo der Flash und seine Docker-Templates im Container gemountet sind (Vorgaben /host/boot und /host/boot/config/plugins/dockerMan/templates-user). Sie folgen dem /boot-Mount des Templates, lass sie also ungesetzt. |
MODE |
Nein | full (die Vorgabe) startet die ganze App. node startet einen Knoten: keine Weboberfläche und keine eigenen Zeitpläne, nur das, was seine Heiminstanz ihm sagt. Jeder andere Wert bricht den Start mit einer Meldung ab. Die Heiminstanz trägt ihn für dich in die Compose-Datei des Knotens ein. |
NODE_HOME |
Auf einem Knoten | Zu welcher Heiminstanz der Knoten gehört, mit ihrem Schlüssel und ihrem Relay, als ein Wert, der mit bvhome1. beginnt. Die Heiminstanz schreibt ihn in die Compose-Datei des Knotens. Ohne ihn startet der Knoten, aber keine Heiminstanz erreicht ihn. Ein Knoten, den eine Heiminstanz übernommen hat, verweigert den Start, wenn NODE_HOME eine andere nennt, bis die erste ihn freigibt. |
NODE_NAME |
Nein | Der Name des Knotens, so wie die Heiminstanz ihn aus dem Namen eingetragen hat, den du ihm gegeben hast. |
Mounts¶
Mounte den Docker-Socket, den Flash (/boot) und die Host Data-Wurzel (/mnt), wie das CA-Template es zeigt. Sicherungs-Quellen und -Ziele liegen beide unter Host Data, und es ist slave gemountet, damit ein entfernter Share, der nach dem Containerstart gemountet wird (zum Beispiel unter /mnt/remotes), ohne Neustart sichtbar wird.
Auf TrueNAS ist Host Data ein Dataset-Pfad wie /mnt/tank, nie ein ixVolume. Daten, die eine App in einem ixVolume hält, liegen außerhalb und werden nicht gesichert. Siehe TrueNAS SCALE.
Auch ZFS-Dataset-Sicherungen brauchen diesen Modus: Der Host mountet den Snapshot eines Datasets erst, nachdem der Container gestartet ist. Siehe ZFS-Datasets.
Lokale Repositories liegen standardmäßig unter /mnt/user/bombvault/{container,vms,flash,config,files,zfs}, bei der ersten Sicherung angelegt. Sie sind die eigenen Ordner der Bereiche und bilden den Speicherort Lokal. Auf seiner Seite unter Speicherorte ändert die Karte Verbindung den Ordner jedes Bereichs.
Der eigene Ordner eines Bereichs kann auch in einem Speicherort liegen, den du schon hast, etwa einem NAS oder einem S3-Bucket: Als eigenen Ordner nutzen auf der Seite dieses Speicherorts verschiebt ihn dorthin und sagt zuerst, was mit den schon gemachten Sicherungen passiert. Siehe Der eigene Ordner eines Bereichs.
Die lokalen Repository-Ordner bleiben bei den Modi 0755 und 0644, damit ein Nicht-Root-Sync-Benutzer über SMB nicht ausgesperrt wird, und die Repositories sind verschlüsselt, das legt also nichts offen. Wiederherstellungsdefinitionen liegen in jedem Repository selbst, ein kopierter Ordner ist daher für sich vollständig. Das Repository der Selbstsicherung bleibt nur für root lesbar.
Host-Integrations-Check
Die Karte Host-Integration in der Übersicht (füge sie unter Anpassen hinzu) prüft jeden Mount und jedes CLI (Docker-Socket, libvirt, restic, qemu-img, rclone) und meldet fehlende Teile.
Erkennung der Sicherungsquellen¶
Für jeden Container wählt BombVault automatisch, welche Bind-Mounts und benannten Volumes gesichert werden. Ein Pfad wird aufgegriffen, wenn eines der Folgenden zutrifft (das Ergebnis kannst du jederzeit in der Karte Gesicherte Ordner auf dem Tab Einstellungen des Containers überschreiben):
- Treffer auf ein Datenwurzel-Segment: Die Host-Quelle des Binds enthält eines der
DATA_ROOT_SEGMENTS-Segmente als vollständige Pfadkomponente (Vorgabe nurappdata). - Benannte Docker-Volumes sind immer enthalten, da es für sie kein Wegwerf-Äquivalent gibt und nichts zu filtern ist, aber nur, wenn der echte Host-Speicherpfad des Volumes selbst über den Host-Data-Mount erreichbar ist, genau wie jeder andere Host-Pfad, den BombVault sichert. Der lokale Standard-Volume-Treiber von Docker legt ein Volume unter der eigenen Datenwurzel des Daemons ab (
/var/lib/docker/volumes/<name>/_data, sofern du das nicht angepasst hast. Prüfe es mitdocker info -f '{{.DockerRootDir}}'), die nicht vom schmalen Ein-Verzeichnis-Host-Data-Mount abgedeckt wird, den die generischedocker-compose.ymlstandardmäßig nutzt. Ein nicht erreichbares Volume wird stillschweigend übersprungen, kein Fehler. Um benannte Volumes auf einem generischen Host tatsächlich zu sichern, richte Host Data (undHOST_SOURCE_ROOT) auf einen gemeinsamen Vorfahren, der auch die Docker-Datenwurzel abdeckt. Der Host-Data-Kommentar der Compose-Datei erklärt den Kompromiss (Unraid umgeht das, indem es aus demselben Grund ganz/mntmountet, seine eigene universelle Konvention der obersten Ebene). - Docker-Compose-Projektverzeichnis: Trägt der Container das Standard-Label
com.docker.compose.project.working_dir(vondocker compose upautomatisch gesetzt), wird auch dieses Verzeichnis hinzugefügt, unabhängig davon, ob ein Bind auf ein Datenwurzel-Segment passte. - Überschreiben per Label
bombvault.data: Setze das Labelbombvault.data=truean einem Container, um alle seine Bind-Mounts einzuschließen, für ein Layout, das keine der beiden obigen Konventionen erfasst (zum Beispiel ein einzelner/srv/plex/config-Bind ohne Compose-Projekt). Jeder nicht leere Wert außerfalsezählt als wahr. Ein fehlendes Label oderbombvault.data=falseändert nichts. - Label
bombvault.dbdump: Setzebombvault.dbdump=falsean einem Container, um seinen automatischen Datenbank-Dump auszuschalten (0,noundofftun dasselbe), oder nenne die Engine (postgres,mysql,mariadb), um einen Container zu dumpen, den BombVault nicht von selbst erkennt. Das Label geht dem Schalter in der Karte Datenbank auf dem Tab Einstellungen des Containers vor, der auf Unraid der Weg dafür ist.
Sicherheitsmodell¶
Root-gleiche Kontrolle über den Host
Über den Docker-Socket kann BombVault Container anhalten, entfernen und neu anlegen und Appdata lesen und schreiben, und für die VM-Sicherung meldet es sich per SSH am Host an (qemu+ssh://, standardmäßig root), um virsh auszuführen. Wer seine Web-UI erreicht, hat damit praktisch Root auf dem Host.
Login¶
- Optionaler Passwortschutz (Karte Passwort unter Einstellungen, Sicherheit): Setze ein Passwort, um einen Login zu verlangen, lösche es, um ihn auszuschalten. Standardmäßig aus für die Nutzung in einem vertrauenswürdigen LAN. Das Passwort wird mit Argon2id über einen mit
APP_KEYverschlüsselten Pepper gespeichert, sodass ein kopiertes/configohne den Schlüssel wertlos und mit ihm langsam anzugreifen ist. Ein neues Passwort braucht mindestens 12 Zeichen. Ein bestehendes kürzeres funktioniert weiter, bis es geändert wird. Sitzungen sind signiert (HMAC, ausAPP_KEYabgeleitet), und das Ändern des Passworts macht sie ungültig. Logins sind auf fünf Fehlversuche pro Minute und Client begrenzt. Das Ändern oder Löschen des Passworts verlangt das Aktuelle Passwort und, bei eingeschalteter Zwei-Faktor-Authentifizierung, den Code. - Manches braucht ein Passwort. Das Herunterladen des Recovery-Kits, des Fehlerberichts und des ZIPs einer Flash-Sicherung, das Exportieren einer Flash-Sicherung oder einer Selbstsicherung, das Hinterlegen des Schlüssels bei einem Schlüsselhüter, das Freigeben einer Hinterlegung zur Herausgabe, das Erstellen eines neuen Wiederherstellungscodes, das Exportieren von Einstellungen mit Zugangsdaten, die Zwei-Faktor-Authentifizierung, Passkeys, das Hinzufügen eines Knotens, das erneute Zeigen seiner Compose-Datei und das Öffnen seiner Einträge werden abgelehnt, bis ein Login-Passwort gesetzt ist, und sie brauchen eine Anmeldung an der Instanz selbst. Sicherungen löschen geht auch ohne Passwort. Ist eines gesetzt, braucht auch das diese Anmeldung.
- Ein Speicherort zeigt kein Passwort. Ein Speicherort kann Zugangsdaten enthalten, wie in
rest:https://user:password@host/repo, und jede Seite und jede API-Antwort zeigt ihn alsrest:https://[redacted]@host/repo, mit oder ohne Login-Passwort. Änderst du den Pfad dahinter, bleibt das gespeicherte Passwort erhalten. Soll der Speicherort auf einen anderen Server zeigen, gib den ganzen Speicherort mit seinem Passwort ein, denn ein verborgenes Passwort bleibt bei seinem Server. - Zwei-Faktor-Authentifizierung (Einstellungen, Sicherheit): ein Zeitcode aus einer Authenticator-App zusätzlich zum Passwort, dazu acht Einmal-Wiederherstellungscodes, die beim Einschalten einmal ausgegeben werden. Das gemeinsame Geheimnis wird mit
APP_KEYverschlüsselt gespeichert, und das Abschalten des Faktors verlangt einen aktuellen Code. - Passkeys (WebAuthn) haben eine eigene Karte, sobald ein Passwort gesetzt ist, neben dem Passwort und nie an seiner Stelle, sodass das Entfernen aller Passkeys niemanden aussperrt. Sie brauchen einen echten Domainnamen und ein Zertifikat, dem der Browser vertraut. Die Vorgabe
https://<ip>:3443ist genau das, was WebAuthn ablehnt, und die Karte sagt das, statt einen Knopf anzubieten, der scheitert. Bei eingeschalteter Zwei-Faktor-Authentifizierung muss ein Passkey deine PIN, deinen Fingerabdruck oder dein Gesicht prüfen, sonst verlangt die Anmeldung zusätzlich den Code. - Eine Konfigurationswiederherstellung (Einstellungen zurückholen im Notfall-Assistenten) beendet jede Sitzung, entfernt jeden Passkey und entzieht jedes API-Token und jeden MCP-Schlüssel, weil die wiederhergestellten Einstellungen welche zurückbringen könnten, die nach dem Speichern entfernt wurden. Melde dich mit dem Passwort an und richte deine Passkeys unter Einstellungen, Sicherheit neu ein.
- Ein vergessenes Passwort wird auf der Login-Seite zurückgesetzt. Passwort vergessen? lässt BombVault einen Code mit 12 Zeichen, in drei Vierergruppen, in das Container-Protokoll schreiben (auf Unraid: Docker-Tab, BombVault-Symbol, Logs). Dieser Code und ein neues Passwort melden dich an. Das Zurücksetzen schaltet außerdem die Zwei-Faktor-Authentifizierung aus, entfernt jeden Passkey, entzieht jedes API-Token, jeden MCP-Schlüssel und jede OAuth-Anmeldung, beendet jede andere Sitzung, meldet jedes gekoppelte Handy ab und schaltet die Handy-Kopplung aus. Die Seite listet danach auf, was weg ist. Ein Code gilt 10 Minuten, und falsche Versuche verbrauchen ihn nicht. Widget- und Metrik-Tokens bleiben, da sie nur lesen.
- Wer das Container-Protokoll lesen kann, kann das Passwort zurücksetzen. Das ist Root auf dem Host, aber auch ein Log-Betrachter wie Dozzle, jeder Container mit Docker-Socket (schreibgeschützt reicht) und ein Log-Shipper, der Container-Ausgaben weiterleitet. Gib das nur Leuten, denen du auch das Passwort anvertrauen würdest. Wer nur die Weboberfläche erreicht, sieht den Code nie.
Handys und Gruppenmitglieder¶
- Gekoppelte Handys erreichen eine Positivliste. Ein Handy, das die zwölf Wörter der Gruppe kennt, meldet sich ohne das Passwort an, solange Handys können sich mit den zwölf Wörtern der Gruppe koppeln in der Karte Android-App unter Einstellungen, Sicherheit an ist. Seine Sitzung erreicht nur, was die App zeigt: die Übersicht, die Läufe, die Sicherungen zum Ansehen, Starten und Wiederherstellen, die Anomalien zum Lesen und die Seite Instanzen zum Ansehen. Speicherorte und Befehle erreichen es ohne ihre Adressen und Geheimnisse, und eine Wiederherstellung, die das Original ersetzt, sichert vorher den heutigen Zustand. Eine Wiederherstellung in einen Ordner nimmt nur einen neuen oder leeren Ordner innerhalb des Ordners für Wiederherstellungen, und ein Handy kann in keinen anderen Ordner hineinsehen. Alles andere antwortet, dass es eine Anmeldung an der Instanz selbst braucht: Schlüssel, das Recovery-Kit, Schlüsselhinterlegungen, Einstellungen, das Löschen von Sicherungen. Ein Passwort-Reset schaltet die Handy-Kopplung aus, bis du sie wieder einschaltest. Ein Handy, das von der Seite Instanzen entfernt wurde oder bei dem Diese Instanz abfragen in den Details ausgeschaltet ist, verliert seine Sitzung sofort, und ein entferntes Handy, das seine App wieder öffnet, kommt ausgeschaltet zurück.
- Unterwegs öffnet ein Handy Seiten über das Relay. Jede Anfrage der Seite wird mit dem Schlüssel der Gruppe versiegelt, den das Relay weder lesen noch ändern kann, und mit einem eigenen Schlüssel des Handys signiert, den der Server beim ersten Aufruf des Handys festhält und zulässt, sobald jemand das Handy auf der Kopplungsseite freigibt. Der Server führt eine Anfrage nur einmal und nur aus, solange sie frisch ist. Er antwortet nur einem Handy, das auf der Seite Instanzen steht, solange die Handy-Kopplung an ist, und nur mit einer Sitzung, die er diesem Handy gegeben hat, sodass auch das Überall-Abmelden und ein Passwort-Reset diese Seiten beenden. Der Server signiert jede Antwort, und die App prüft die Signatur gegen den Schlüssel, den sie für diesen Server festgehalten hat, und warnt, wenn sich der Schlüssel ändert. Eine solche Seite erreicht dieselbe Positivliste wie ein gekoppeltes Handy, mit oder ohne Login-Passwort, plus den Anmeldestatus, den die Seite zuerst liest. Anmelden und Abmelden, das Zurücksetzen des Passworts und Downloads bleiben an der eigenen Adresse des Servers, und eine Antwort ist auf 16 MB begrenzt.
- Mitglieder signieren, was sie anfragen. Rollenanfragen und ihre Antworten, Speicherangebote, die Herausgabe eines restic-Passworts an einen Empfänger oder Abholer, Empfänger-Logins und Schlüsselhinterlegungen werden mit einem Schlüssel jedes Mitglieds signiert, den eine Instanz festhält, wenn sie dieses Mitglied zum ersten Mal sieht. Ein mit einem anderen Schlüssel signierter Aufruf wird abgelehnt. Schlüssel vergessen in den Details einer Instanz verwirft den festgehaltenen Schlüssel, für den Fall, dass der hier bekannte nicht der eigene des Mitglieds ist. Das Mitglied wird bei seinem nächsten signierten Aufruf erneut nach seinem Schlüssel gefragt. Mitglieder mit BombVault 9.x signieren nicht und können von jedem imitiert werden, der die Wörter hat, wie in 9.9. Eine Rollenanfrage oder ein Speicherangebot von einem Mitglied mit 10.4 oder älter wird abgelehnt, bis dieses Mitglied aktualisiert ist.
- Die zwölf Wörter sind ein Passwort. Wer sie hat, tritt der Gruppe bei, sieht den Schutzstatus der Mitglieder und kann Rollen anfragen, die ein Mensch auf der anderen Instanz noch erlauben muss. Ohne Login-Passwort kann sie jeder lesen, der die Weboberfläche öffnen kann, und die Kopplungskarte sagt das, bis ein Passwort gesetzt ist.
Schlüssel¶
- APP_KEY tut zwei Dinge. Er versiegelt, was diese Installation speichert (Passwörter, Zugangsdaten, Tokens), und er ist der Schlüssel der Sicherungen: Das restic-Passwort wird aus ihm abgeleitet, und Container- und VM-Definitionen werden mit ihm versiegelt.
- Ein übernommener Schlüssel wird getrennt gehalten. Übernimmt der Notfall-Assistent die Sicherungen eines anderen Servers, versiegelt diese Installation weiter mit ihrem eigenen APP_KEY und speichert den Schlüssel des anderen Servers als ihren Sicherungsschlüssel, versiegelt wie jedes andere Geheimnis. Das Recovery-Kit druckt dann beide. Wird APP_KEY danach geändert, lässt sich der Sicherungsschlüssel nicht mehr öffnen: BombVault hört auf zu sichern und sagt das unter Braucht dich, statt mit dem falschen Schlüssel zu schreiben. Lade das Recovery-Kit unter Wiederherstellung, Notfall erneut hoch oder setze APP_KEY zurück. Siehe Notfall-Assistent.
- Verschlüsselung ist standardmäßig an (Sicherungen verschlüsseln in der Karte Verschlüsselung unter Einstellungen, Sicherheit). Sicherungen werden von restic mit dem aus dem Sicherungsschlüssel abgeleiteten Passwort verschlüsselt.
- Schlüsselhinterlegungen. Ein Schlüsselhüter in deiner Gruppe hält eine versiegelte Kopie des Recovery-Kits dieses Servers, die er selbst nicht öffnen kann. Nur der Wiederherstellungscode mit 20 Zeichen öffnet sie, und der Hüter gibt sie erst heraus, nachdem dort jemand Erlauben gedrückt hat. Siehe Schlüsselhüter.
Knoten¶
Ein Knoten ist ein BombVault ohne Weboberfläche, das seine Aufträge von einer Heiminstanz bekommt.
- Die Heiminstanz hat den Knoten in der Hand. Ein Knoten bindet den Docker-Socket seines Servers ein, also Root dort, und die Heiminstanz steuert den Knoten. Wird die Heiminstanz übernommen, steuert der Angreifer auch alle ihre Knoten. Gib der Heiminstanz ein Login-Passwort und halte ihre Weboberfläche vom Internet fern.
- Ein Knoten hat wenig in der Hand. Wird ein Knoten übernommen, bekommt der Angreifer keine Koppelgruppe, keine Festung, keinen anderen Knoten und kein anderes Repository. Der Knoten hat nur eine Verbindung zu seiner Heiminstanz, ein eigenes Login auf dem Empfangsserver und einen eigenen Ordner an einem Speicherort. Auf dem Empfangsserver kann er keine bisherigen Sicherungen löschen, weil der Server append-only ist. Er kann aber die Platte des Servers füllen, weil rest-server keine Quote setzt. Gib dem Empfangsserver also genug Platz oder einen eigenen Share. An einem Speicherort können seine Zugangsdaten meist löschen, was dort liegt. Sicherungen, die auf dem Knoten bleiben, sind in der Hand des Angreifers, darum holt die Heiminstanz eine Kopie davon.
- Die Verbindung ist privat und signiert. Heiminstanz und Knoten sprechen über das Relay über eine eigene Verbindung, versiegelt mit einem Geheimnis, das aus dem
APP_KEYdes Knotens abgeleitet ist. Jede Seite kennt den Schlüssel der anderen schon vor dem ersten Aufruf, deshalb gibt es keinen Schritt zum Bestätigen. Die Heiminstanz signiert jeden Aufruf mit ihrem eigenen Schlüssel und einem Zähler, und der Knoten lehnt jeden Aufruf ab, den nicht die Heiminstanz signiert hat oder den er schon einmal angenommen hat. Bei der Heiminstanz ruft der Knoten nichts auf außer seinem Hallo. - Die Heiminstanz erreicht eine feste Liste. Anfragen, die die Heiminstanz an einen Knoten weitergibt, laufen nur auf einer festen Liste von Routen des Knotens, aufgeführt unter
GET /api/nodes/routes, und der Knoten beantwortet sie nur mit JSON. Nichts auf der Liste löscht etwas oder erreicht die Einstellungen, den Speicher, die Schlüssel, die Gruppe oder die Tokens. Auf der Heiminstanz brauchen sie eine Anmeldung mit dem Passwort: Gekoppelte Handys, API-Tokens und MCP-Schlüssel erreichen keinen Knoten. Sicherungen und Wiederherstellungen, die so gestartet wurden, stehen als von der Heiminstanz gestartet da. - Schlüsselhinterlegungen enthalten Knotenschlüssel. Die Heiminstanz behält den
APP_KEYjedes Knotens, und das Recovery-Kit druckt ihn in seinem Kapitel Nodes. Also enthält ihn auch eine Schlüsselhinterlegung. Ein Schlüsselhüter, der die Hinterlegung und den Wiederherstellungscode bekommt, kann die Repositories deiner Knoten öffnen, aber keinen Knoten steuern, weil das die Signatur der Heiminstanz braucht. - Freigeben ist endgültig. Ein freigegebener Knoten nimmt mit demselben
APP_KEYkeine Heiminstanz mehr an. Ein Knoten, der beim Freigeben nicht da ist, erfährt es von der Heiminstanz, sobald er zurück ist.
Netzwerk¶
- Änderungen brauchen JSON. Eine Anfrage, die etwas ändert, muss
Content-Type: application/jsonsenden und darf vom Browser nicht als Cross-Site markiert sein, sodass eine Seite auf einer anderen Website deinen Browser nicht dazu bringen kann, Einstellungen an einer LAN-Adresse zu ändern. Ein Skript, das die API ansteuert, sendet diesen Header. Alles andere wird mit415abgelehnt. - Weil das Tor optional ist, sind ungesetzt die ganze Oberfläche und API (einschließlich der Speicherorte, der Routen für den Manipulationstest und der Wiederherstellungsrouten) für jeden erreichbar, der den Port erreicht. Setze ein Login-Passwort, sobald Off-site-, Append-only-Sicherungen oder Verschlüsselung im Einsatz sind.
- Betreibe BombVault nur in einem vertrauenswürdigen, nicht offenen Netzwerk. Für den Fernzugriff setze es hinter einen Reverse-Proxy, der Authentifizierung und TLS ergänzt. Antworten tragen grundlegende Sicherheits-Header (CSP,
nosniff,X-Frame-Options,Referrer-Policy). - Hinter einem Reverse-Proxy trägt jede Anfrage die Adresse des Proxys, daher zählt die Login-Bremse ohne
TRUSTED_PROXYjeden Client in einem Topf, und die Fehlversuche eines Angreifers sperren auch dich aus. Nenne den Proxy inTRUSTED_PROXY, um die Zählung pro Client zurückzubekommen. - Ein Reverse-Proxy vor BombVault muss den Header
AuthorizationoderX-API-Keyan/mcpdurchreichen und darf seine Antworten nicht puffern, sonst können sich Assistenten nicht verbinden. Siehe MCP-Server. - Der MCP-Endpunkt
/mcpantwortet mit404, bis ein Schlüssel existiert oder die Anmeldung über OAuth eingeschaltet ist, und er verlangt von jedem Client seinen Schlüssel oder sein Token, auch bei ausgeschaltetem Login-Passwort. Keine Adresse ist ausgenommen, nicht einmallocalhost. Er hat keine Tools zum Wiederherstellen oder Löschen, und das Wiederherstellen einer Konfigurationssicherung entzieht jeden Schlüssel. Siehe MCP-Server. - Mit
HTTP_ONLY=trueverliert das Sitzungs-Cookie seinSecure-Flag (es muss, um über einfaches HTTP zu funktionieren), schalte das Passwort also nur hinter einem Proxy ein, der TLS beendet, wenn Vertraulichkeit zählt. - Die SSH-Verbindung der VM-Sicherung vertraut dem Host-Schlüssel beim ersten Verbinden (TOFU) und hält ihn danach fest. Prüfe den Schlüssel des Hosts über einen anderen Weg, wenn der Weg vom Container zum Host nicht vertrauenswürdig ist.
- Links führen nicht aus dem Mount heraus. Eine Sicherung oder eine Wiederherstellung an Ort und Stelle stoppt mit einer Meldung, wenn ein Link oberhalb ihres Pfads aus dem Host-Mount herausführt, denn ein Container, der in seinen eigenen Share schreibt, könnte so einen Link anlegen. Ein Speicherort, dessen Host oder rclone-Remote mit einem Bindestrich beginnt, wird genauso abgelehnt, beim Speichern und beim nächsten Lauf, denn
sshoderrclonewürden ihn als Option lesen.
MCP-Server¶
Der MCP-Server braucht keine Umgebungsvariable. Du schaltest ihn ein, indem du unter Einstellungen, Anbindungen, MCP-Server einen Schlüssel anlegst, und er antwortet unter /mcp auf demselben Port wie die Weboberfläche (zum Beispiel https://192.168.1.10:3443/mcp). Ohne aktiven Schlüssel antwortet dieser Pfad mit 404. Clients, Zertifikate und Limits beschreibt MCP-Server.
VM-Sicherung über SSH¶
BombVault sichert KVM/libvirt-VMs ohne einen libvirt-Pfad zu mounten. Es führt virsh über SSH (qemu+ssh://) auf dem Host aus und kann daher nie den VM Manager deines Hosts beeinträchtigen.
Den libvirt-Socket des Hosts in einen Container zu mounten ist auf Unraid heikel: Der VM Manager besitzt diese Pfade, und das Umschalten von „Enable VMs“ kann libvirt am Starten hindern. Der SSH-Schlüssel gewährt Root auf dem Host, dieselbe Vertrauensstufe wie der Docker-Socket, den BombVault ohnehin nutzt.
Schnelle Einrichtung:
- Einstellungen, Anbindungen, Host-SSH: Kopiere den angezeigten öffentlichen Schlüssel.
- Hänge ihn an
/root/.ssh/authorized_keysvon Unraid an (auch auf dem Flash gesichert, damit er Neustarts übersteht). - Klicke auf Verbindung testen.
Das Template fügt --add-host=host.docker.internal:host-gateway hinzu, damit der Container den Host erreicht. Setze LIBVIRT_HOST auf die LAN-IP deines Unraid, wenn dieser Name sich nicht auflöst (zum Beispiel wenn der Container in einem eigenen Netz br0.x läuft). Hast du den SSH-Port von Unraid geändert, setze LIBVIRT_SSH_PORT passend. Live-Snapshots brauchen außerdem den qemu-Gast-Agenten in der VM und die Disk auf /mnt/cache (nicht /mnt/user).
Vollständige VM-Einrichtung und Netzwerkanleitung
Die vollständige Schritt-für-Schritt-Anleitung (SSH aktivieren, dauerhafte Schlüsselfreigabe, Routing für eigene Netze und VLANs, Methode pro VM und Fehlersuche auf dem Host) ist die Anleitung zur VM-Sicherung.
Off-site-Einrichtung¶
Off-site-Kopien gehen an Speicherorte. Öffne Speicherorte über seine Einstellungskachel (oder hefte es an die Seitenleiste) und wähle Speicherort hinzufügen. Siehe Off-site und Wiederherstellung für den ganzen Ablauf (Löschschutz, Manipulationstest und DR-Tests). Kurz gefasst:
- Backends: SMB/CIFS und WebDAV über rclone ohne Host-Mount, NFS (mounte den Export auf dem Host und nutze ihn als lokalen Ordner), native restic-Backends ohne rclone (
s3:...,rest:http://host:8000/repo,sftp:user@host:/repo) oder jedes rclone-Remote (rclone:<remote>:<bucket>/path). Backblaze B2 hat hier kein natives Backend: Erreiche es über seinen S3-Endpunkt (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>) mit der Schlüssel-ID und dem Application Key als S3-Zugangsdaten. - Zugangsdaten werden verschlüsselt gespeichert, als eine Liste gespeicherter Zugangsdaten in der Karte Zugangsdaten unter Einstellungen, Speicherorte. Ein Stern markiert die Vorgabe, die überall genutzt wird, wo keine gewählt ist. Die eigene Seite eines Speicherorts wählt in ihrer Karte Zugangsdaten, welche er nutzt. Siehe Zugangsdaten.
- SSH-Ziele brauchen auf der Gegenseite nichts Installiertes.
sftp:braucht nur einen SSH-Server. Füge den öffentlichen Schlüssel aus Einstellungen, Anbindungen, Host-SSH (auch unter/config/ssh/id_ed25519.pub) der~/.ssh/authorized_keysdes Zielbenutzers hinzu, oder lass Schlüssel hinterlegen in Speicherort hinzufügen ihn mit dem Passwort des Kontos dort ablegen. - rest-server mit selbstsigniertem Zertifikat: Lege sein Zertifikat oder das der Stelle, die es signiert hat, als PEM-Datei in den Ordner
certsim Datenordner von BombVault (/config/certsim Container,appdata/bombvault/certsauf Unraid). Sicherungen, Kopien und der Löschschutztest vertrauen ihm ohne Neustart. - Off-site-Kopie: BombVault kopiert neue Snapshots nach bestem Bemühen mit
restic copy, zusätzlich zu einem (meist lokalen) primären Repository. Die Karte Kopieren eines Speicherorts legt fest, ob er Nach jeder Sicherung oder nach einem eigenen Plan kopiert, und Einstellungen, Zeitplan, Off-site-Kopien pro Bereich gibt einem Bereich seinen eigenen Kopierplan. Jetzt replizieren steht in der Zeile des Bereichs in der Karte Off-site-Kopien unter Einstellungen, Speicherorte. - Mehrere Speicherorte pro Bereich: Die Karte Speicherorte je Bereich auf der Seite Speicherorte schaltet jede Linie von einem Bereich zu einem Ort mit einem Klick an oder aus, Lokal eingeschlossen. Ein Bereich mit nur Off-site-Orten sichert direkt dorthin, und einer mit jeder Linie aus wird nicht gesichert. Die Regeln je Bereich eines Speicherorts geben einem Bereich dort sein eigenes Repository, seine eigene Aufbewahrung oder Kompression.
- Zuordnung pro Eintrag: Jeder Container, jede VM und jedes Ordner-Set zeigt in der Karte Zeitplan und Speicherort auf seinem Tab Einstellungen Lokal und die Orte, die seine Sicherungen bekommen. Einträge ohne eigene Wahl folgen ihrem Bereich. Siehe Zuordnung pro Eintrag.
- Aufbewahrung: Jeder Speicherort hält Sicherungen nach seiner Karte Wie lange aufheben, und ein Bereich kann dort unter Regeln je Bereich eigene Werte behalten. Das schließt die Kopie im Off-site-Feld eines Bereichs ein. Lauter Nullen kürzen die Snapshots eines Speicherorts nie.
- Bandbreitenlimits: Begrenze die Upload-/Download-Rate von restic in der Karte Off-site-Bandbreite unter Einstellungen, Speicherorte oder pro Ort in dessen Karte Kopieren. Du gibst KiB/s ein, und das Feld zeigt dieselbe Rate in MB/s und Mbit/s.
- Streaming zuerst: Wähle in der Karte Streaming auf der Seite Speicherorte die Mediaserver (Plex, Jellyfin und Emby sind nach Image-Namen vorgewählt), die Senderate, ab der einer als streamend gilt, das Upload-Limit, während er streamt, und wie lange nach einem Stream das normale Limit zurückkommt.
- Cold- und Archiv-Speicherklasse (S3): Wähle bei einem S3-Speicherort auf seiner Seite eine zum Wiederherstellen lesbare Stufe (Standard, Standard-IA, One Zone-IA, Intelligent-Tiering, Glacier Instant Retrieval). rclone-Remotes legen ihre Klasse in der rclone-Konfiguration fest.
- Eigener Ordner in einem Speicherort statt lokal: Der eigene Ordner eines Bereichs kann in einem der obigen Speicherorte liegen, ohne lokale Kopie und ohne Kopierschritt. Siehe Der eigene Ordner eines Bereichs.
Anomalien¶
Die Anomalie-Erkennung braucht keine Umgebungsvariable. Sie wird in der Karte Anomalien unter Einstellungen, Prüfung eingerichtet, beschrieben unter Anomalien.
Portable Einstellungen (Export und Import)¶
Die Karte Einstellungen exportieren / importieren unter Einstellungen, System schreibt deine ganze BombVault-Konfiguration (Bereichseinstellungen, Speicherorte, Zeitpläne, Aufbewahrung, Benachrichtigungen) in eine portable JSON-Datei, die du auf einer anderen Instanz importieren kannst, sodass der Umzug auf eine neue Box oder das Klonen einer Einrichtung nicht heißt, alles von Hand neu einzugeben. Der Import zeigt eine Vorschau und fragt nach Bestätigung, und er berührt nie deine Sicherungsdaten oder den Verlauf. Links in der Datei auf Speicherorte oder Repositories, die es nicht mehr gibt, werden weggelassen, und die Vorschau nennt sie. Solange eine ZFS-Replik läuft, wird ein Import abgelehnt, bevor etwas geschrieben wird.
Der Export kann Zugangsdaten enthalten
Du wählst, ob die Zugangsdaten für Off-site, Benachrichtigungen und den MQTT-Broker in die Datei kommen. Mit eingeschlossenen Zugangsdaten ist der Export so sensibel wie dein Recovery-Kit, bewahre ihn also sicher auf. Ohne sie enthält die Datei nur Einstellungen ohne Geheimnisse.
Der APP_KEY reist nicht mit der Datei
Die Repositories sind mit einem Passwort verschlossen, das aus dem APP_KEY abgeleitet ist, und die Datei enthält ihn nicht. Für einen geplanten Umzug gibst du der neuen Box den alten APP_KEY in ihr Template, oder du übernimmst den Schlüssel mit dem Recovery-Kit unter Notfall. Unter einem anderen Schlüssel antworten die Repositories mit einem falschen Passwort. Es geht nichts verloren, und mit dem richtigen Schlüssel öffnen sie sich wieder.