ウィンドウズ標準デプロイメント

この記事では、自分のWindowsサーバーにBitwardenをインストールしてデプロイする手順を説明します。BitwardenはLinuxとmacOSのマシンにもインストールしてデプロイすることができます。Bitwarden ソフトウェアリリースサポートのドキュメンテーションをご確認ください。

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

以下は、この記事のインストール手順の要約です。このセクションのリンクは詳細なインストール手順セクションにジャンプします：

1. ドメインを構成します。あなたのマシンを指すドメイン名のDNSレコードを設定し、マシン上の80番と443番のポートを開きます。

2. インストールを完了するためのBitwarden ユーザーとディレクトリを作成します。

3. あなたのマシンにDocker Desktopをインストールして設定してください。

4. インストールに使用するために、https://bitwarden.com/hostからインストールIDとキーを取得してください。

   詳細については、インストールIDとインストールキーは何に使われますか？をご覧ください。

5. マシンにBitwarden をインストールします。

6. \bwdata\env\global.override.envの設定を調整して環境を構成します。

   チップ

   少なくとも、globalSettings__mail__smtp...変数を設定して、ユーザーを招待し確認するためのメールアドレスサーバーを設定してください。

7. インスタンスを開始します。

8. 設定したドメインをウェブブラウザで開いて、インストールをテストしてください。

9. デプロイ後は、定期的にサーバーのバックアップを取り、システムの更新を確認することをお勧めします。

デフォルトでは、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は、Dockerコンテナの配列を使用して、あなたのマシンにデプロイされ、実行されます。Windows用のDocker Desktopには、Docker EngineとDocker Composeの両方が含まれています。

1. Docker Desktop for Windowsをダウンロードしてインストールし、インストール中にHyper-Vの代わりにWSL2を使用する（推奨）設定オプションのチェックを外してください。

Bitwardenは、Windowsマシンへの簡単なインストールのためにPowershell Cmdletファイル（.ps1）を提供しています。次の手順を完了して、Cmdletを使用してBitwardenをインストールします：

1. 作成されたディレクトリに移動します。

   Bash
   cd C:\Bitwarden

2. 次のコマンドを実行して、Bitwardenのインストールスクリプト（bitwarden.ps1）をダウンロードしてください：

   Bash
   Invoke-RestMethod -OutFile bitwarden.ps1 -Uri "https://func.bitwarden.com/api/dl/?app=self-host&platform=windows"

3. 次のコマンドを使用してインストーラースクリプトを実行します:

   Bash
   .\bitwarden.ps1 -install

4. インストーラーのプロンプトを完了させてください:

   • あなたのBitwardenインスタンスのドメイン名を入力してください：

     通常、この値は設定されたDNSレコードであるべきです。

   • Let's Encryptを使用して無料のSSL証明書を生成しますか？ (はい/いいえ):

     yを指定して、Let's Encryptを使用して信頼性のあるSSL証明書を生成します。Let's Encryptからの有効期限のリマインダーのために、メールアドレスを入力するように求められます。詳細については、証明書のオプションをご覧ください。

     あるいは、nを指定し、SSL証明書を使用するためのオプションを使用しますか？

   • あなたのインストールIDを入力してください：

     有効なメールアドレスを使用して、https://bitwarden.com/hostでインストールIDを取得してください。詳細については、インストールIDとインストールキーは何に使われますか？をご覧ください。

   • あなたのインストールキーを入力してください：

     有効なメールアドレスを使用して、https://bitwarden.com/hostでインストールキーを取得してください。詳細については、インストールIDとインストールキーは何に使われますか？をご覧ください。

   • SSL証明書をお持ちですか？ (はい/いいえ)

     すでに自分自身のSSL証明書をお持ちの場合は、yを指定し、必要なファイルをC:\Bitwarden\bwdata\ssl\ディレクトリに配置してください。それが信頼できるSSL証明書であるかどうか尋ねられます（はい/いいえ）。詳細については、証明書のオプションをご覧ください。

     あるいは、nを指定し、テスト目的のみに推奨される自己署名SSL証明書?オプションを使用しますか？

   • 自己署名SSL証明書を生成しますか? (y/n) :

     Bitwardenが自己署名証明書を生成するようにyを指定してください。このオプションはテスト用にのみ推奨されます。詳細については、証明書のオプションをご覧ください。

     あなたがnを指定すると、あなたのインスタンスはSSL証明書を使用せず、HTTPSプロキシをインストールの前に設定するか、それ以外の場合はBitwardenアプリケーションは正常に機能しません。

あなたの環境を設定するには、2つのファイルに変更を加えることが含まれます。それらは環境変数ファイルとインストールファイルです。

環境変数（必須）

Bitwardenの一部の機能は、bitwarden.ps1 Cmdletによって設定されていません。この設定を編集して、環境ファイルを設定します。その場所は\bwdata\env\global.override.envです。少なくとも、以下の値を置き換えるべきです:

Bash
...
globalSettings__mail__smtp__host=<placeholder>
globalSettings__mail__smtp__port=<placeholder>
globalSettings__mail__smtp__ssl=<placeholder>
globalSettings__mail__smtp__username=<placeholder>
globalSettings__mail__smtp__password=<placeholder>
...
adminSettings__admins=
...

globalSettings__mail__smtp...=プレースホルダーを置き換えて、新規ユーザーへの確認メールや組甀への招待をSendするために使用されるSMTPメールサーバーに接続します。adminSettings__admins=にメールアドレスを追加すると、システム管理者ポータルへのアクセスが設定されます。

編集後にglobal.override.env、以下のコマンドを実行して変更を適用してください：

Bash
.\bitwarden.ps1 -restart

インストールファイル

Bitwardenのインストールスクリプトは、.\bwdata\config.ymlの設定を使用して、インストールに必要なアセットを生成します。一部のインストールシナリオ（代替ポートを使用したプロキシ経由のインストールなど）では、標準インストール時に提供されなかったconfig.ymlへの調整が必要になる場合があります。

必要に応じてconfig.ymlを編集し、変更を適用するために次のコマンドを実行してください:

Bash
.\bitwarden.ps1 -rebuild

すべての前のステップが完了したら、次のコマンドを実行してBitwardenインスタンスを開始します:

Bash
.\bitwarden.ps1 -start

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

Bash
docker ps

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

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

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

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

Docker Desktopは、RDPセッションにログインしている場合にのみ、ブート時に自動的に起動します。ユーザーがログインしているかどうかに関係なく、起動時にDocker Desktopを起動するには：

1. タスクスケジューラを開き、アクションメニューからタスクの作成...を選択します。

2. 次のセキュリティオプションでタスクを設定します：

   • 作成されたBitwardenユーザーアカウントを使用するようにタスクを設定します。

   • タスクをユーザーがログインしているかどうかに関係なく実行するように設定してください。

3. トリガータブを選択し、次のトリガーを作成します：

   • タスクを開始のドロップダウンから、起動時を選択してください。

   • 詳細設定セクションで、タスクの遅延:チェックボックスを確認し、ドロップダウンから1分を選択してください。

4. アクションタブを選択し、次のアクションを作成します：

   • プログラム/スクリプト入力で、"C:\Program Files\Docker\Docker\frontend\Docker Desktop.exe"を指定してください。

5. スケジュールされたタスクの作成を完了するには、OKを選択してください。

Bitwardenインストールスクリプト（bitwarden.ps1）には、以下のコマンドが利用可能です。すべてのコマンドはスイッチ（-）で始まる必要があります。例えば、.\bitwarden.ps1 -startのようにします。