コンテンツにスキップ

BombVault

Drop a backup. Detonate a restore.

Backup and full disaster recovery for Unraid and other Docker hosts. Containers, VMs, folders, ZFS datasets and the flash drive, restored the way they were.

BombVault

Unraid のデータを、金庫に封印。バックアップを投げ込み、復元を起爆する。

概要画面:ステータス欄、対応が必要なこと、各セクションの保護状況、保存先、履歴。 概要画面:ステータス欄、対応が必要なこと、各セクションの保護状況、保存先、履歴。

BombVault は、Unraid をはじめ、TrueNAS SCALE、ZimaOS、通常の Linux マシンなどの Docker ホストで使える、セルフホスト型の Web アプリです。バックアップと完全な災害復旧を担当し、Docker コンテナ、KVM/libvirt VM、フォルダー、ZFS データセット、Unraid のフラッシュドライブをバックアップします。単一のマルチアーキテクチャ Docker コンテナとして動作し、ダーク、ライト、システム設定のテーマを選べる Web 画面を備え、バックアップ、スケジュール設定、検証、復元というライフサイクル全体を扱います。

復元は自動です。Unraid ではコンテナが Docker タブに以前とまったく同じ状態で再び現れ、VM はディスクと UEFI NVRAM を再アタッチした状態で VM Manager に再定義されます。手動での再インストールも、再設定も、面倒もありません。TrueNAS では、元のコンテナの隣に復元したコンテナは通常の Docker コンテナとして動き、Apps 画面には表示されません。

restic を基盤としているため、すべてのバックアップは重複排除され、増分方式で、標準で暗号化されています。

APP_KEY は安全に保管してください

BombVault は、APP_KEY という名前の 32 バイトのシークレットから restic リポジトリのパスワードを導出します。これをリカバリーキットとともに失うと、暗号化されたバックアップは復元不能になります。openssl rand -hex 32 で生成し、安全な場所に保管してください。設定を参照してください。

BombVault が保護するもの

コンテナ、VM、フォルダーセット、フラッシュ、すべての ZFS データセット、BombVault 自身の設定は、それぞれ専用のページを持つ項目です。同じ種類の項目をまとめたものがセクションで、設定、一般でオンにします。

セクション 保存される内容
コンテナ Appdata ディレクトリに加え、コンテナ定義(イメージ、環境変数、ポート、ラベル、ボリューム)。
VM VM ディスクイメージ、XML 定義、UEFI NVRAM を、SSH 経由でバックアップ(libvirt のマウントなし)。
フラッシュ USB フラッシュ全体(/boot):OS、ライセンス、アレイ設定、共有、ネットワークおよびプラグイン設定。
セルフバックアップ BombVault 自身の /config:設定データベース、保存先の認証情報、libvirt の SSH 鍵ペア、ZFS サーバーの鍵と固定したホスト鍵、証明書。
フォルダー サーバー上の任意のフォルダーをフォルダーセットとして保存します。それぞれに除外パターンを任意で設定できます。
ZFS データセット データセットとその下のすべてのデータセットを 1 つの ZFS スナップショットから読み取り、フォルダーと同じように保存します。ZFS データセットを参照してください。

復元こそが主役

restic スナップショットからデータを書き戻したあと、BombVault は保存されたコンテナ定義を Docker API に対して再生します。そのため、コンテナは最初からそこにあったかのように Unraid の Docker タブに再び現れます(同じイメージ、同じ設定、同じポートマッピング)。VM は XML が SSH 経由で再定義され、ディスクと UEFI NVRAM が再アタッチされます。VM を削除したあとでも同じです。

1 つの画面で、あらゆる種類を復元できます。標準では元の隣にが選ばれていて、バックアップをコピーとして戻し、元のものはそのまま残します。元を置き換えるは先に現在の状態をバックアップするので、復元を取り消せます。そのほかの復元先として、フォルダーや新しい ZFS データセットがあります。

バックアップで依存するコンテナを止めた場合は、正しい順序で戻ります。BombVault は Compose の depends_on の順に再起動し、それぞれが正常と報告するのを待ってから、それに依存するコンテナを起動します。まだ立ち上がっていないデータベースやゲートウェイを追い越して起動することはありません。復元とコマンドとほかのコンテナを参照してください。

仕組み

Browser --HTTPS--> BombVault container
                   |- Go binary: JSON API + embedded React UI
                   |- Background worker (per-section scheduler + job executor)
                   |
                   |- /var/run/docker.sock  -> Docker API (container stop/inspect/recreate)
                   |- qemu+ssh://host       -> libvirt / KVM on the HOST over SSH (no mount)
                   |- /mnt/ -> /host/user   -> appdata, VM disks + restic repos (read/write)
                   |- /boot/ -> /host/boot  -> Unraid flash backup (whole USB)
                   |- /config               -> BombVault's own settings + sign-ins (self-backup)
                   '- <repo path>           -> restic repository (local or remote: rclone/s3/rest/sftp)

BombVault は Docker ソケットを使って、バックアップ前にコンテナを停止し、復元後にコンテナを再作成します。VM については、SSH(qemu+ssh://)経由でホスト上の virsh を実行し、ドメインを正常にシャットダウンするか、ライブスナップショットを取ります。libvirt のパスをバインドマウントすることは一切ないため、ホストの VM Manager の邪魔になることはありません。

BombVault はオーケストレーションと UI のレイヤーであり、ストレージエンジンではありません。実際のデータ移動はすべて restic を通じて行われます。

クイックスタート

はじめてですか? はじめに で BombVault をインストールして最初のバックアップを実行し、続けて オフサイトと復旧 を設定してください。実践例 では、よくある作業を最初から最後まで順に説明しています。設定 のページにはすべてのタイルが載っていて、機能 は BombVault ができることの短い一覧です。

各セクションは複数の保存先に同時にコピーでき、ペアリングした BombVault は削除を受け付けないサーバーにオフサイトのコピーを置けます。緊急ウィザードは、グループ経由または入力した鍵を使って、失ったサーバーをリカバリーキットから元に戻します。設定を新しいマシンに移すには、設定のエクスポート / インポートカードを使います。オフサイトと復旧および設定を参照してください。

Android アプリ を使えば、グループ内のすべてのサーバーをスマートフォンで扱え、全サーバーのアクティビティログを 1 つの画面で見られます。

ドキュメントは 26 言語、画面は 42 言語に対応しています。まだ翻訳のないページは英語で表示されます。

この文書で使う言葉

BombVault とこの文書では、いくつかの言葉が決まった意味で使われます。

言葉 意味
項目 BombVault がバックアップする 1 つの対象。コンテナ、VM、フォルダーセット、フラッシュドライブ、その下のデータセットを含む ZFS データセット、または BombVault 自身の設定です。それぞれに専用のページがあります。
セクション コンテナなど、同じ種類の項目すべて。セクションは 設定、一般 でオンにします。
保存先 バックアップの行き先。このサーバー上のフォルダー、共有、自分のサーバー、クラウドサービスなどです。保存先を参照してください。
ローカル このサーバー上にある、各セクションのフォルダーを置く保存先。
専用フォルダー セクションが最初にバックアップを書き込むリポジトリ。標準ではこのサーバー上にあり、保存先の中に置くこともできます。セクションの専用フォルダーを参照してください。
コピー 専用フォルダーから別の保存先へ restic copy でコピーしたバックアップ。
ダイレクトリポジトリ ローカルのコピーを挟まず、項目が直接バックアップするオフサイトのリポジトリ。ダイレクトリポジトリを参照してください。
認証情報 S3 サービスや rest-server 用に保存したキーまたはパスワード。そのうち 1 つが標準になります。認証情報を参照してください。
配置 項目のバックアップをどの保存先に置くか。項目ごと、またはセクションの標準として設定します。項目ごとの配置を参照してください。
レプリカ zfs send で作る、2 台目の ZFS サーバー上の ZFS 項目のブロック単位の完全なコピー。バックアップの隣に並ぶもので、バックアップの代わりにはなりません。レプリカを参照してください。
ロール グループ内のあるインスタンスがほかのインスタンスのために担う役目:レシーバー、取得側、ZFS サーバー、鍵の保管側。インスタンスとロールを参照してください。
ノード Web 画面のない BombVault。たとえば VPS で動き、別のインスタンスであるホームインスタンスが、何を、いつ、どこへバックアップするかを指示します。ノードを参照してください。
ホームインスタンス ノードを追加し、そのノードを動かすインスタンス。ノードの鍵を持ち、何を、いつ、どこへバックアップするかをノードに指示します。ノードを参照してください。

クレジット

  • VolumeVault(Apache-2.0、作者は @Darkdragon14)が、BombVault の出発点となるアイデアをくれました。Docker コンテナのワンクリックバックアップと自動再インストールです。BombVault は Go と restic による別個の実装で、そのアイデアを VM やフラッシュなどへ広げています。
  • restic は、BombVault が動かす、高速で安全な重複排除バックアップエンジンです。
  • rclone はクラウドバックエンドを提供します。
  • ボタンのグリフの大半は、Streamline の無料の Core Solid セット(CC BY 4.0、ソース)のものです。残りは Font Awesome Free、Material Design Icons、Simple Icons、Tabler Icons のもの、またはこのプロジェクトのために描いたものです。

ライセンス

Copyright (C) 2026 Junker der Provinz. BombVault は GNU Affero General Public License v3.0(LICENSE)のもとで提供されるフリーソフトウェアです。実行、研究、共有、改変を行うことができます。配布する場合、または改変したバージョンをネットワークサービスとして運用する場合は、同じライセンスのもとでソースコードを公開し、既存の著作権表示と帰属表示を保持しなければなりません。

名前とブランドはライセンスの対象外です。AGPL が対象とするのはソースコードだけです。「BombVault」、そのロゴ、そのブランドは権利が留保されたままであり、フォークは独自の名前とブランドを使わなければならず、BombVault を名乗ってはなりません。

ホストに対する root 相当の制御

Docker ソケットを通じて、BombVault はコンテナの停止、削除、再作成を行い、appdata の読み書きができます。また VM バックアップのためにホストに SSH でログインして virsh を実行します。その Web UI に到達できる者は、実質的にホストの root 権限を持つことになります。BombVault は信頼できる、外部に公開されていないネットワークでのみ実行し、設定、セキュリティ でログインパスワードを設定してください。リカバリーキット、鍵の預け入れ、フラッシュ ZIP、フラッシュバックアップやセルフバックアップのエクスポートにはパスワードが必要です。完全なセキュリティモデルについては設定を参照してください。