节点¶
节点是没有网页界面的 BombVault,例如运行在 VPS 上,或者朋友家里的一台小服务器上。它备份自己服务器上的容器和文件夹,而什么时候备份、备份发往哪里,由你添加它的那个 BombVault 决定,本页把它称为主实例。你在主实例的网页界面里照看节点,就在你自己的条目旁边。

工作原理¶
- 主实例持有节点的密钥。 添加节点时,主实例为它生成
APP_KEY,保留一份封存的副本,并通过节点的 compose 文件把它交给你一次。主实例凭这份副本访问节点并打开它的备份。 - 节点无需开放端口。 主实例和节点通过中继,用一条独立于你的配对组的专用私有连接通信。每次调用都由主实例发起并签名,节点只向主实例发送它的问候。唯一需要开放端口的去向是把备份保留在节点上。
- 备份从不经过中继。 节点把备份直接发往你选择的地方:主实例的接收服务器、主实例的某个存储位置,或者节点自己的 rest-server。
- 节点自己不做任何计划。 它不运行计划,不发送通知,也不加入任何组或堡垒。由主实例启动它的备份、关注备份的进展并发出提醒。
- 节点备份容器和文件夹集。 虚拟机、闪存、ZFS 数据集和自我备份只由完整安装负责。
这条连接在主实例的组有自己的中继时使用它,否则使用项目的中继,即使主实例配对时不用中继也是如此。
开始之前¶
- 主实例上的登录密码。 添加节点、再次显示它的 compose 文件以及打开它的条目,都需要用密码登录,参见登录。
- 节点的服务器上装有带 Compose 的 Docker。
- 一个存放备份的地方,即备份发往哪里下的三种之一。接收服务器最安全,因为节点在那里什么也删不掉。
添加节点¶
- 在主实例上打开实例,选择右下角的添加节点。
-
名称。 输入节点在这里显示的名称,例如服务器的名字,然后选择下一步。

-
备份。 选择备份发往哪里,并填写那个地方需要的信息。每天备份时间是两个分区开始的时间。主实例建议在它自己的容器备份半小时之后,这样两者不会同时去抢同一批磁盘。之后你可以在卡片上为每个分区单独设置计划。选择下一步。

-
启动。 窗口显示节点的 compose 文件,其中已填好
MODE、APP_KEY、NODE_HOME和NODE_NAME。把它复制下来,并把APP_KEY妥善保存。在节点的服务器上执行:mkdir -p /opt/bombvault-node && cd /opt/bombvault-node nano docker-compose.yml # paste the file from the window docker compose up -d启动之前,把 Host Data 卷指向你要备份的数据,并把
HOST_SOURCE_ROOT设为同一路径,如下面的示例所示。 -
窗口会等待节点。节点一应答,主实例就告诉它备份发往哪里,并检查它能否访问到那里,然后窗口显示 vps-helsinki 已上线,并接受此实例的指令。

你可以在节点应答之前关闭窗口。这时它的卡片显示正在等待节点,等节点出现后,主实例再告诉它备份发往哪里。
示例:备份到接收服务器的 VPS¶
主实例是一台叫 tower 的 Unraid 机器,运行着接收服务器。一个反向代理把它发布为 https://backup.tower.example.org。VPS vps-helsinki 运行着 Nextcloud 和 Caddy,数据在 /srv/appdata 下。
- 在
tower上依次选择实例、添加节点,名称填vps-helsinki,然后下一步。 - 选择此实例的接收服务器,在节点使用的地址里输入
https://backup.tower.example.org。主实例的容器在 02:30 备份,所以窗口建议 03:00。保持不变,选择下一步。 -
在 VPS 上保存窗口里的文件,把卷和
HOST_SOURCE_ROOT改成/srv/appdata: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。几秒钟后,tower上的窗口显示节点已上线,以及 备份发往 https://backup.tower.example.org。 - 03:00 主实例启动节点的备份。第二天早上,概览上的节点卡片显示
vps-helsinki的上一次备份,备份页面把它的容器列在单独的一个分区里。
在普通的 Docker 主机上如何找到容器的数据,见备份源检测。
备份发往哪里¶
每个节点的两个分区共用一个去向。节点上线后,可以用它卡片上的更改目标来改。新的地方会有新的仓库,旧地方的备份留在原处。
此实例的接收服务器¶
节点以 append-only 模式写入主实例的接收服务器:它可以添加备份,但删不掉任何备份。它在那里有一个以节点命名的专属登录,并在自己的文件夹里每个分区各有一个仓库。主实例把自己的密钥加到每个仓库里,并亲自整理它们,因为节点做不到。
节点通过节点使用的地址访问服务器,这个地址在第二步或接收服务器窗口里设置。节点通常从互联网发送数据,所以地址必须是下面两种之一:
https://,例如放在反向代理、Pangolin 或隧道后面。如果服务器出示的是自己的证书而不是公共证书机构签发的证书,请把它以 PEM 格式粘贴到证书里。- 带私有 IP 地址的
http://,例如 WireGuard 链路上的10.0.0.5或 Tailscale 上的100.101.102.103。
指向公网地址的普通 http:// 会被拒绝,因为节点会以未加密的方式把备份发过互联网。你更改地址后,主实例会通知使用这个接收服务器的每个节点,不在线的节点会在回来后得知。
存储位置¶
节点写入主实例的某个它自己能访问到的存储位置:通过 https:// 或私有地址访问的 S3 服务或 REST 服务器。它的仓库位于那里的 bombvault-node-<node id>-containers 和 bombvault-node-<node id>-files。
节点用一组为它创建的已保存的凭据登录,这组凭据必须不同于主实例写入该位置所用的凭据。如果窗口说还没有,请先添加一组。与接收服务器不同,凭这组凭据,节点通常可以删除该位置上的内容,窗口也会这样提示。
保留在节点上¶
节点把备份保存在自己的一个 append-only 模式的 rest-server 后面,主实例把每个分区的副本拉取到自己的存储里。这适合主实例无法为它提供存放位置的节点。这是唯一需要开放端口的去向。

- 在节点地址里输入主实例访问节点的地址:节点的公网地址加一个空闲端口,例如
https://203.0.113.7:8443,后面不要加文件夹。和上面一样,只有私有地址才使用http://。 - 节点在那个端口上启动容器
bombvault-node-rest-server,仓库放在 Host Data 下的bombvault-node文件夹里。使用https://时,它会为这个地址生成证书,主实例会固定这张证书。 - 在节点的防火墙里放行这个端口,让主实例能访问到。节点上另一个容器已占用的端口会被拒绝,并提示那个容器的名字。
节点某个分区的备份一结束,主实例就拉取这个分区,另外每小时的 15 分也会拉取一次作为后备,即使拉取关闭也是如此。主实例拉取到的内容像任何拉取的副本一样留在主实例上,即使节点已经没了。节点的 rest-server 不接受删除,所以节点会在主实例要求时自己整理仓库。节点的文件夹集会排除 bombvault-node 文件夹,所以它绝不会备份自己的备份。
节点何时备份¶
每个节点的计划都归主实例管。卡片为每个分区显示一个计划,例如容器 每天 2:00 和文件夹 每周(日)4:00。点击会打开与计划里相同的编辑器,更改会立即保存。

- 曾经不在线的节点一回来就启动它错过的备份。主实例每五分钟检查一次。
- 正忙的节点会在五分钟后被再次询问。
- 主实例整理节点的旧备份期间,节点在整理完成前不会启动任何东西。在接收服务器和节点本身上,这个时间窗口每周日 03:00 开始,最长持续六小时。在存储位置上,它遵循主实例对该位置的异地复制计划。主实例按它自己在保留多久下为该分区设定的规则保留备份,该位置有自己的规则时则按该位置的规则。
- 在节点的运行列表里,主实例启动的备份和还原显示为由主实例启动。
关注你的节点¶
概览上的节点卡片列出每个节点及其状态、上一次备份、错误和未处理的异常。有了节点之后它才会出现。

主实例通过它的通知渠道每次事件只发一条提醒,等这次事件结束后才会发下一条:
- 备份失败,例如 BombVault: vps-helsinki: backup failed,附带条目和原因。这个条目之后有一次备份成功,事件就结束。
- 节点无法访问,例如 BombVault: vps-helsinki is out of reach。主实例会等待节点各仓库上最短的那个失联开关,默认 26 小时,节点还没有去向时为 6 小时。
主实例的接收端监视也会照看节点的每个仓库,带有失联开关和每天 04:00 的 restic check,参见接收端和拉取端。
节点的条目¶
在备份下,容器和文件夹列表在你自己的条目下方为每个节点设有一个分区。节点自己的容器不会列出。条目菜单里的立即备份会在节点上启动它的备份,打开会打开它的页面。
在文件夹列表里节点的分区中,添加文件夹集会在节点上添加一个文件夹集,文件夹集菜单里的编辑会修改它。两者打开的窗口和你自己的文件夹集一样。其中的文件夹选择器浏览节点的文件夹,但不会在那里新建文件夹。

节点条目的页面会显示在 vps-falkenstein 上这样的节点名称,并列出它的备份。在其中一个备份上选择还原,会在节点上还原这个条目,并替换那里现有的内容。和在主实例上一样,容器会为此停止。

通过主实例,你能访问节点自身路由的一份固定列表:它的容器、文件夹集、运行和异常,以及对它们的备份和还原。节点的设置、密钥和存储都访问不到,列表上也没有任何删除操作。参见API 中的节点。
替换和释放¶
替换在你用密码登录后再次显示节点的 compose 文件。用它把节点迁移到另一台服务器或重建它:在新服务器上启动这个文件,并关闭旧服务器。同样的 APP_KEY 和 NODE_HOME 会让它重新成为同一个节点,带着它的备份和历史。主实例为每个节点保存它的文件夹集、容器以及重建容器所需的一切,还有它的运行记录。节点用一个空的 config 文件夹启动时,主实例会重新接管它,告诉它备份发往哪里,并在下一次备份之前把这些全部交还给它,所以节点也能恢复一个已经不在的容器。在新服务器上,自己保存备份的节点会从空仓库开始。它之前的备份留在主实例拉取的副本里。使用同一 APP_KEY 的两台服务器算作同一个节点,所以千万不要同时运行两台。
释放让节点离开。它不再接受主实例的指令,也不再备份任何东西。它的备份留在原处,主实例拉取的每份副本也都留着。它在接收服务器上的登录会被删除,主实例也不再关注它的仓库。释放时不在线的节点,卡片会一直显示正在释放,直到它得知此事。被释放的节点不能再用同一个 APP_KEY 归属任何主实例。要再次使用这台服务器,请把它作为新节点添加,并用新的 compose 文件和一个空的 config 文件夹启动它。
安全¶
如果主实例被攻破,攻击者也能控制它的节点,而节点掌握着它所在服务器上的 Docker,在那里就等于 root。请用密码保护主实例,并且不要把它暴露在互联网上。如果某个节点被攻破,攻击者拿不到配对组、堡垒、其他节点或其他仓库,也删不掉接收服务器上的历史。详情见安全模型中的节点。
恢复工具包里有一个节点章节,列出每个节点的 APP_KEY、restic 密码和仓库,这样你可以找回节点,或用普通的 restic 还原它的备份。