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=: この変数は空白であるべきです。詳細については、プッシュリレーの設定を参照してください。

     チップ

     この時点で、すべての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サブディレクトリに提供してください。

   備考

   このディレクトリは、\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 bitwarden/mssql:version

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