はじめに¶
このページでは、まっさらな Unraid マシンから最初のバックアップまでを案内します。
要件¶
| 要件 | 備考 |
|---|---|
| Unraid 6.12 以上 | それより古いバージョンはテストされていません。 |
| restic リポジトリの場所 | ローカルパス(推奨: アレイまたはキャッシュ)、SMB、NFS、または任意の rclone バックエンド。 |
| Docker ソケット | テンプレートによって自動的にマウントされます(/var/run/docker.sock)。 |
Unraid フラッシュ(/boot) |
テンプレートによって全体が自動的にマウントされます(/boot を /host/boot へ)。フラッシュバックアップを支え、復元されたコンテナが通常の編集可能な Unraid アプリとして再び現れるようにします。 |
| KVM VM(オプトイン) | VM バックアップは SSH 経由で libvirt と通信し、libvirt のマウントは不要です。設定で構成します(設定を参照)。 |
Unraid へのインストール¶
最も簡単な方法は Community Applications です。
- Unraid の Apps タブを開きます。
- BombVault を検索します。
- Install をクリックし、必要な変数(下記)を設定して適用します。
Manual template install
テンプレートを手動で追加したい場合は:
- Docker, Add Container, Template repositories に移動して、以下を追加します:
- Templates で BombVault を検索します。
- 必要な変数を設定して Apply をクリックします。
必須設定はひとつだけ¶
設定が必須の変数は APP_KEY だけです。これは restic リポジトリのパスワードを導出するために使われる 32 バイトの 16 進シークレット(16 進数 64 文字)です。
任意のマシンで生成します:
生成された結果をテンプレートの APP_KEY フィールドに貼り付けます。
Do not lose your APP_KEY
APP_KEY を失うと、暗号化されたバックアップは復元不能になります。サーバーとは別の安全な場所に保管してください。BombVault が起動したら、ワンクリックの暗号化キー・リカバリーキット(オフサイトと復旧を参照)を使って、完全なリカバリーバンドルを保存してください。
テンプレートは Docker ソケット、フラッシュ(/boot)、そして Host Data ルート(/mnt)もマウントしてくれます。バックアップのソースとデスティネーションはどちらも Host Data の配下に存在します。変数の完全なリファレンスとオフサイトのセットアップについては、設定を参照してください。
初回起動¶
- Web UI を
https://<your-unraid-ip>:3443で開きます(デフォルトで自己署名証明書)。 - Settings で、使いたいバックアップドメイン(コンテナ、VM、フラッシュ、Config、ファイル)を有効にし、アクセントカラーを選びます。
- Containers タブでコンテナを選び、Back up をクリックして最初の復元ポイントを作成します。リポジトリパスはデフォルトで
/mnt/user/bombvault/{container,vms,flash,config,files}になり、初回バックアップ時に作成されます。 - Settings, Schedules からスケジュールを設定します。コンテナと VM にはすべてをスケジュールに含めるワンクリック操作があります。
Optional: pick a backup order
一部のコンテナを常に他のコンテナより先にバックアップしたい場合(たとえばデータベースをそれを使うアプリより先に)は、Containers ページのバックアップ順序パネルを開き、希望する順序にドラッグします。以降、スケジュール実行や複数選択実行はその順序に従います。順序を指定しなかったものは、これまでどおり最も期限超過のものから順にバックアップされます。
Host integration check
コンテナが起動したあと、Web UI で /spike を開いてください。これはすべてのマウントと CLI(Docker ソケット、libvirt、restic、qemu-img、rclone)をプローブし、欠けている部分を報告します。これにより、コンテナに頼る前に、正しく配線されていることを確認できます。
シンプル vs 詳細¶
デフォルトでは、インターフェースは基本操作(バックアップ、復元、スケジュール)だけを表示します。サイドバーの Simple / Advanced スイッチを使うと、エキスパート向けの操作が表示されます: 保持、オフサイトコピー、pre/post フック、ファイルレベルの復元、通知、Prometheus メトリクス、そして整合性/メンテナンスツールです。これはブラウザごとの設定で、デフォルトはオフです。そのため、初心者はすっきりした UI を、パワーユーザーはすべての機能を手にできます。
次のステップ¶
- 機能の全体を見てみましょう。
- ひとつ以上のオフサイトと復旧レプリカを追加し(各ドメインは複数のデスティネーションへ同時に送信できます)、リカバリーキットを保存しましょう。
- セットアップを複製したり、新しいマシンに移行したりしますか? 設定のエクスポートとインポートカードで設定一式を持ち運べます。設定を参照してください。
- 問題にぶつかりましたか? トラブルシューティングを参照してください。