Linux標準デプロイメント

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

この記事におけるインストール手順の概要は次のとおりです。このセクションのリンクは、詳細なインストール手順セクションにジャンプします。

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

2. マシンにDocker と Docker Compose をインストールします。

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

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

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

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

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

   tip

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

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

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

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

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

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

Bitwardenは、一連のDockerコンテナを使用して、あなたのマシンにデプロイされ、実行されます。Bitwardenは、どのDockerエディションやプランでも実行できます。あなたのインストールに最適な版を評価してください。

コンテナのデプロイメントは、Docker Composeを使用してオーケストレーションされます。一部のDockerインストール、macOS用Dockerを含む、はすでにDocker Composeがインストールされています。

インストールを進める前に、あなたのマシンにDockerとDocker Composeをインストールしてください。次のDockerのドキュメントを参照してヘルプを得てください:

• Dockerエンジンをインストールします

• Docker Composeをインストールします

私たちは、Bitwardenをインストールして実行するための専用のBitwardenサービスアカウントを持つLinuxサーバーを設定することをお勧めします。これにより、サーバー上で実行されている他のアプリケーションからBitwardenインスタンスが隔離されます。

これらのステップはBitwardenが推奨するベストプラクティスですが、必須ではありません。詳細については、DockerのLinux用のインストール後の手順のドキュメンテーションをご覧ください。

1. Bitwardenユーザーを作成する：

   BashCopy
   sudo adduser bitwarden

2. Bitwardenユーザーのパスワードを設定します（強力なパスワード）：

   BashCopy
   sudo passwd bitwarden

3. Dockerグループを作成します（まだ存在しない場合）：

   BashCopy
   sudo groupadd docker

4. Bitwardenユーザーをdockerグループに追加します:

   BashCopy
   sudo usermod -aG docker bitwarden

5. Bitwardenディレクトリを作成します：

   BashCopy
   sudo mkdir /opt/bitwarden

6. /opt/bitwardenディレクトリの権限を設定します：

   BashCopy
   sudo chmod -R 700 /opt/bitwarden

7. /opt/bitwardenディレクトリの所有者としてBitwardenユーザーを設定します:

   BashCopy
   sudo chown -R bitwarden:bitwarden /opt/bitwarden

Bitwardenは、LinuxとWindows（PowerShell）への簡単なインストールのためのシェルスクリプトを提供しています。次の手順を完了して、シェルスクリプトを使用してBitwardenをインストールします：

1. Bitwardenのインストールスクリプト（bitwarden.sh）をあなたのマシンにダウンロードしてください：

   BashCopy
   curl -Lso bitwarden.sh "https://func.bitwarden.com/api/dl/?app=self-host&platform=linux" && chmod 700 bitwarden.sh

2. インストーラースクリプトを実行してください。./bwdataディレクトリは、bitwarden.shの位置に対して相対的に作成されます。

   BashCopy
   ./bitwarden.sh install

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

   • あなたの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を指定し、必要なファイルを./bwdata/ssl/your.domainディレクトリに配置してください。それが信頼できるSSL証明書であるかどうか尋ねられます（はい/いいえ）。詳細については、証明書のオプションをご覧ください。

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

   • 自己署名SSL証明書を生成しますか？ (はい/いいえ):

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

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

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

環境変数（必須）

Bitwardenの一部の機能はbitwarden.shスクリプトによって設定されていません。これらの設定を、./bwdata/env/global.override.envに位置する環境ファイルを編集することで設定します。少なくとも、以下の値を置き換えるべきです:

BashCopy
...
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、以下のコマンドを実行して変更を適用します:

BashCopy
./bitwarden.sh restart

インストールファイル

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

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

BashCopy
./bitwarden.sh rebuild

すべての前のステップが完了したら、Bitwardenインスタンスを開始します：

BashCopy
./bitwarden.sh start

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

BashCopy
docker ps

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

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

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

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

Bitwardenのインストールスクリプト（bitwarden.shまたはbitwarden.ps1）には、以下のコマンドが利用可能です：