Windows オフラインデプロイメント

この記事では、オフラインまたはエアギャップ環境の自分のWindowsサーバーにBitwardenをインストールしてデプロイする手順を説明します。Bitwarden ソフトウェアリリースサポートのドキュメンテーションをご確認ください。

インストールを進める前に、以下の要件が満たされていることを確認してください:

• あなたのサーバーにDocker EngineとDocker Composeがインストールされ、使用準備が整っています。この設定中には、チェックを外す必要がありますHyper-Vの代わりにWSL2を使用する（推奨）オプション。

• インターネットアクセスが可能なマシンを使用して、Bitwardenサーバーリポジトリのリリースページから最新の docker-stub.zip ファイルをダウンロードし、このファイルをあなたのサーバーに転送しました。

• あなたの環境では、オフラインのSMTPサーバーが設定され、アクティブになっています。

• （オプション）OpenSSL Windowsバイナリがサーバーにインストールされ、使用準備が整いました。あなたの希望により、OpenSSLの代わりに自己署名証明書を使用することも可能です。

Windows Server上でBitwardenを実行するには、ネストされた仮想化を使用する必要があります。あなたのハイパーバイザーのドキュメンテーションを確認して、ネストされた仮想化がサポートされているかどうか、そしてそれをどのように有効にするかを調べてください。

デフォルトでは、Bitwardenはホストマシンのポート80（ http ）および443（ https ）を通じて提供されます。これらのポートを開放して、ネットワーク内外からBitwardenにアクセスできるようにしてください。インストール中に異なるポートを選択することもできます。

インターネット経由でBitwardenを提供している場合、特に、ホストマシンを指すDNSレコードを持つドメイン名（例： bitwarden.example.com ）を設定することをお勧めします。

PowerShellを開き、次のコマンドを実行してBitwardenローカルユーザーを作成します:

Bashコピー
PS C:\> $Password = Read-Host -AsSecureString

上記のコマンドを実行した後、テキスト入力ダイアログに希望のパスワードを入力してください。パスワードを指定した後、次のコマンドを実行してください：

Bashコピー
New-LocalUser "Bitwarden" -Password $Password -Description "Bitwarden Local Admin"

新しく作成されたユーザーとして、 C:\ の下にBitwardenフォルダーを作成してください。

Bashコピー
PS C:\> mkdir Bitwarden

Docker Desktopをインストールしたら、設定 → リソース → ファイル共有に移動し、作成したディレクトリ（ C:\Bitwarden ）をリソースリストに追加します。適用して再起動を選択して変更を適用してください。

このドキュメントのすべての後続の手順を完了する前に、新しく作成したユーザーとしてログインすることをお勧めします。

あなたのBitwardenサーバーに必要なアセットを機器に設定するには：

1. C:\Bitwarden に新しいディレクトリを作成し、その名前を bwdata とし、そこに docker-stub.zip を解凍してください。
   
   一度解凍すると、 bwdata ディレクトリは、 docker-compose.yml ファイルのボリュームマッピングが期待するものと一致します。あなたの希望により、これらのマッピングの位置をホストマシン上で変更することができます。

2. bwdata\env\global.override.env で、以下の環境変数を編集してください：

   • globalSettings__baseServiceUri__vault=: あなたのBitwardenインスタンスのドメインを入力してください。

   • globalSettings__sqlServer__ConnectionString=: 後のステップで使用するために、 RANDOM_DATABASE_PASSWORD を安全なパスワードに置き換えてください。

   • globalSettings__identityServer__certificatePassword=: 後のステップで使用するための安全な証明書のパスワードを設定します。

   • globalSettings__internalIdentityKey=: RANDOM_IDENTITY_KEY をランダムなキー文字列に置き換えてください。

   • globalSettings__oidcIdentityClientKey=: RANDOM_IDENTITY_KEY をランダムなキー文字列に置き換えてください。

   • globalSettings__duo__aKey=: RANDOM_DUO_AKEY をランダムなキー文字列に置き換えてください。

   • globalSettings__installation__id=: https://bitwarden.com/hostから取得したインストールIDを入力してください。

   • globalSettings__installation__key=: https://bitwarden.com/hostから取得したインストールキーを入力してください。

   • globalSettings__pushRelayBaseUri=: この変数は空白であるべきです。詳細については、プッシュリレーの設定を参照してください。

     

     tip

     この時点で、すべての globalSettings__mail__smtp__ 変数と adminSettings__admins の値も設定することを検討してください。これにより、新しい組織メンバーへの招待をSendするためのSMTPメールサーバーが設定され、システム管理者ポータルへのアクセスが提供されます。

     環境変数についてもっと学ぶ。

3. IDコンテナーのための ID.pfx 証明書を生成します。OpenSSLを使用するか、任意のツールを使用して自己署名証明書を生成することができます。あなたがOpenSSLを使用している場合、次のコマンドを実行してください：

   Bashコピー
   openssl req -x509 -newkey rsa:4096 -sha256 -nodes -keyout identity.key -out identity.crt -subj "/CN=Bitwarden IdentityServer" -days 10950

   そして

   Bashコピー
   openssl pkcs12 -export -out ./identity/identity.pfx -inkey identity.key -in identity.crt -passout pass:IDENTITY_CERT_PASSWORD

   上記のコマンドで、 IDENTITY_CERT_PASSWORD をステップ2で作成し使用した証明書のパスワードに置き換えてください。

4. ID.pfx をマップされたボリュームディレクトリ（デフォルトでは、 .\bwdata\ID ）に移動します。

5. identity.pfx を .\bwdata\ssl ディレクトリにコピーしてください。

6. あなたのドメインの名前で .\bwdata\ssl にサブディレクトリを作成してください。

7. 信頼できるSSL証明書と秘密鍵を新しく作成された .\bwdata\ssl\bitwarden.example.com サブディレクトリに提供してください。

   

   note

   このディレクトリは、 \etc\ssl のNGINXコンテナにマップされています。信頼できるSSL証明書を提供できない場合は、HTTPSエンドポイントをBitwardenクライアントアプリケーションに提供するプロキシでインストールをフロントにしてください。

8. .\bwdata\nginx\default.conf で：

   1. すべての bitwarden.example.com のインスタンスをあなたのドメインに置き換えてください、 Content-Security-Policy ヘッダー内も含めて。

   2. ssl_certificate と ssl_certificate_key の変数を、ステップ6で提供された証明書と秘密鍵のパスに設定します。

   3. あなたの証明書の設定に応じて、以下のアクションのいずれかを実行してください:

      • 信頼できるSSL証明書を使用している場合、 ssl_trusted_certificate 変数を証明書のパスに設定します。

      • 自己署名証明書を使用する場合は、 ssl_trusted_certificate 変数をコメントアウトしてください。

9. .\bwdata\env\mssql.override.env で、 RANDOM_DATABASE_PASSWORD をステップ2で作成したパスワードに置き換えてください。

10. .\bwdata\web\app-id.json で、 bitwarden.example.com をあなたのドメインに置き換えてください。

あなたのオフラインマシンで使用するためのDockerイメージを取得するには：

1. インターネットに接続されたマシンから、 bitwarden/xxx:latest のすべてのdockerイメージをダウンロードしてください。これらは docker-compose.yml ファイルにリストされており、 docker-stub.zip にあります。

2. 各画像を .img ファイルに保存します。例えば：

   Bashコピー
   docker image save -o mssql.img ghcr.io/bitwarden/mssql:latest

3. すべての .img ファイルをオフラインマシンに転送してください。

4. あなたのオフラインマシンで、各 .img ファイルをロードしてローカルのDockerイメージを作成します。例えば：

   Bashコピー
   docker image load -i mssql.img

次のコマンドであなたのBitwardenサーバーを起動してください:

Bashコピー
docker compose -f ./docker/docker-compose.yml up -d

すべてのコンテナが正しく動作していることを確認してください。

Bashコピー
docker ps

おめでとうございます！Bitwardenは現在、 https://your.domain.com で稼働しています。それが機能していることを確認するために、ブラウザでウェブ保管庫を訪れてください。

あなたは今、新しいアカウントを登録してログインすることができます。新しいアカウントのメールアドレスを確認するためには、SMTP環境変数を設定する必要があります（環境変数を参照してください）。

• Bitwardenの組織を自己ホスト型で運用する予定がある場合は、組織を自己ホスト型で開始するを参照してください。

• 詳細情報は、自己ホスト型FAQをご覧ください。

自己ホスト型のサーバーを手動でインストールし、デプロイした場合の更新は、標準的な更新手順とは異なります。手動でインストールしたサーバーを更新するには：

1. 最新の docker-stub.zip アーカイブをGitHubのリリースページからダウンロードしてください。

2. 新しい docker-stub.zip アーカイブを解凍し、その内容を現在の bwdata ディレクトリの内容と比較し、新しいものを bwdata の既存のファイルにコピーしてください。
   しないでください、既存の bwdata ディレクトリを新しい docker-stub.zip アーカイブの内容で上書きしないでください。これは、あなたが行ったカスタム設定作業を上書きすることになります。

3. 最新のコンテナイメージをダウンロードし、オフラインマシンに転送してください上記の文書に記載されている通り。

4. 次のコマンドを実行して、更新された設定と最新のコンテナを使用してサーバーを再起動します:

   Bashコピー
   docker compose -f ./docker/docker-compose.yml down && docker compose -f ./docker/docker-compose.yml up -d