快速上手¶
本页带您从一台全新的 Unraid 机器走到您的第一份备份。
要求¶
| 要求 | 说明 |
|---|---|
| Unraid 6.12+ | 更早的版本未经测试。 |
| restic 仓库位置 | 本地路径（推荐：您的阵列或缓存）、SMB、NFS，或任意 rclone 后端。 |
| Docker 套接字 | 由模板自动挂载（/var/run/docker.sock）。 |
Unraid 闪存（/boot） |
由模板自动整体挂载（/boot 到 /host/boot）。它驱动闪存备份，并让已还原的容器以正常、可编辑的 Unraid 应用形式重新出现。 |
| KVM 虚拟机（可选启用） | 虚拟机备份通过 SSH 与 libvirt 通信，无需挂载 libvirt。在设置中进行配置（参见配置）。 |
在 Unraid 上安装¶
最简单的途径是 Community Applications。
- 打开 Unraid 中的 Apps 标签页。
- 搜索 BombVault。
- 点击 Install，设置必需的变量（见下文），然后应用。
手动安装模板
如果您更愿意手动添加模板：
- 前往 Docker，Add Container，Template repositories 并添加：
- 在 Templates 中搜索 BombVault。
- 设置必需的变量并点击 Apply。
唯一必需的设置¶
您唯一必须设置的变量是 APP_KEY，一个 32 字节的十六进制密钥（64 个十六进制字符），用于派生 restic 仓库密码。
在任意机器上生成一个：
将结果粘贴到模板的 APP_KEY 字段。
切勿丢失您的 APP_KEY
丢失 APP_KEY 将使您的加密备份无法恢复。请将它存放在安全且与服务器分离的地方。BombVault 运行后，使用其一键式的加密密钥恢复工具包（参见异地与恢复）保存完整的恢复捆绑包。
模板还会为您挂载 Docker 套接字、闪存（/boot）和 Host Data 根目录（/mnt）。备份的来源和目标都位于 Host Data 之下。完整的变量参考和异地设置参见配置。
首次运行¶
- 在
https://<your-unraid-ip>:3443打开 Web 界面（开箱即用自签名证书）。 - 在设置中，启用您想要的备份域（容器、虚拟机、闪存、配置、文件）并选择一个强调色。
- 在容器标签页，选择一个容器并点击备份以创建您的第一个还原点。仓库路径默认为
/mnt/user/bombvault/{container,vms,flash,config,files}，并在首次备份时创建。 - 在设置，计划中设置计划任务。容器和虚拟机都有一键式的全部加入计划。
可选：设定备份顺序
如果某些容器应始终先于其他容器备份（例如数据库先于使用它的应用），请打开容器页面上的备份顺序面板，将它们拖入您想要的顺序。计划任务和多选运行随后会遵循它；任何未排序的项目会像以前一样按最逾期优先备份。
主机集成检查
容器启动后在 Web 界面打开 /spike。它会探测每个挂载和 CLI（Docker 套接字、libvirt、restic、qemu-img、rclone）并报告任何缺失的部分，因此您可以在依赖它之前确认容器已正确接线。
简单模式与高级模式¶
默认情况下界面只显示基本功能（备份、还原、计划）。使用侧边栏中的简单 / 高级开关来显示专家控制项：保留、异地复制、备份前/后钩子、文件级还原、通知、Prometheus 指标以及完整性/维护工具。这是每个浏览器各自的偏好，默认关闭，因此新手得到干净的界面，而高级用户拥有一切。