セルフホスト

はじめに

当社のセルフホスト型メールソリューションは、他のすべての製品と同様に、フロントエンドとバックエンドの両方で100%オープンソースです。つまり、

完全な透明性: メールを処理するすべてのコード行が公開されており、誰でも精査できます。
コミュニティへの貢献: 誰でも改善や問題の修正に貢献できます。
オープン性によるセキュリティ: 脆弱性はグローバルコミュニティによって特定・修正されます。
ベンダーロックインなし: お客様は当社の存在に依存する必要はありません。

コードベース全体は、MIT ライセンスに基づいて GitHub の https://github.com/forwardemail/forwardemail.net, で入手できます。

アーキテクチャには次のコンテナが含まれます。

送信メール用のSMTPサーバー
メール取得用のIMAP/POP3サーバー
管理用のWebインターフェース
設定保存用のデータベース
キャッシュとパフォーマンス向上のためのRedis
安全で暗号化されたメールボックス保存用のSQLite

Note

セルフホストブログもぜひご覧ください。

より詳細な手順を知りたい方は、ウブントゥまたはデビアンベースのガイドをご覧ください。

要件

インストールスクリプトを実行する前に、次のものがあることを確認してください。

オペレーティングシステム: Linux ベースのサーバー (現在 Ubuntu 22.04 以降をサポート)。
リソース: vCPU 1 基と RAM 2GB
ルートアクセス: コマンド実行に必要な管理者権限。
ドメイン名: DNS 設定可能なカスタムドメイン。
クリーン IP: ブラックリストをチェックし、スパム評価のないクリーンな IP アドレスをサーバーに割り当ててください。詳細については、ここを参照してください。
ポート 25 をサポートするパブリック IP アドレス
逆PTR を設定可能
IPv4 および IPv6 をサポート

Tip

素晴らしいメールサーバープロバイダーのリストをご覧ください

クラウド初期化 / ユーザーデータ

ほとんどのクラウドベンダーは、仮想プライベートサーバー（VPS）のプロビジョニング時にcloud-init構成をサポートしています。これは、スクリプトの初期セットアップロジックで使用するファイルや環境変数を事前に設定しておくための優れた方法です。これにより、スクリプト実行中に追加情報の入力を求めるプロンプトが表示される必要がなくなります。

オプション

EMAIL - certbot の有効期限リマインダーに使用するメールアドレス
DOMAIN - セルフホスティング設定で使用するカスタムドメイン（例：example.com）
AUTH_BASIC_USERNAME - サイト保護のために初回設定で使用するユーザー名
AUTH_BASIC_PASSWORD - サイト保護のために初回設定で使用するパスワード
/root/.cloudflare.ini - （Cloudflare ユーザーのみ）certbot が DNS 設定に使用する Cloudflare 設定ファイル。dns_cloudflare_api_token で API トークンを設定する必要があります。詳しくはここをご覧ください。

例：

#cloud-config
write_files:
  - path: /root/.cloudflare.ini
    content: |
      dns_cloudflare_api_token = "xxx"
    owner: root:root
    permissions: '0600'
  - path: /etc/profile.d/env.sh
    content: |
      export EMAIL="test@myemail.com"
      export DOMAIN="mydomain.com"

runcmd:
  - chmod +x /etc/profile.d/env.sh

インストール

サーバーで次のコマンドを実行して、インストールスクリプトをダウンロードして実行します。

bash <(curl -fsSL https://raw.githubusercontent.com/forwardemail/forwardemail.net/master/self-hosting/setup.sh)

デバッグインストールスクリプト

詳細出力の場合は、インストールスクリプトの前に DEBUG=true を追加します。

DEBUG=true bash <(curl -fsSL https://raw.githubusercontent.com/forwardemail/forwardemail.net/master/self-hosting/setup.sh)

プロンプト

1. Initial setup
2. Setup Backups
3. Setup Auto Upgrades
4. Renew certificates
5. Restore from Backup
6. Help
7. Exit

初期設定: 最新の転送メールコードをダウンロードし、環境を設定し、カスタムドメインの入力を求め、必要なすべての証明書、キー、シークレットを設定します。
バックアップの設定: 安全なリモートストレージとして、S3 互換ストアを使用して mongoDB と redis をバックアップするための cron を設定します。また、安全で暗号化されたバックアップのために、変更があった場合はログイン時に sqlite もバックアップされます。
アップグレードの設定: インフラストラクチャコンポーネントを安全に再構築して再起動するための夜間更新を確認する cron を設定します。
証明書の更新: SSL 証明書には Certbot / lets encrypt が使用され、キーは 3 か月ごとに期限切れになります。これにより、ドメインの証明書が更新され、関連コンポーネントが使用する適切なフォルダに配置されます。重要なファイルパスを参照してください。
バックアップからの復元: mongoDB と redis をトリガーしてバックアップデータから復元します。

初期セットアップ（オプション1）

開始するにはオプション 1. Initial setup を選択してください。

完了すると、成功メッセージが表示されます。docker ps を実行して、コンポーネントが起動していることを確認することもできます。コンポーネントの詳細については、以下をご覧ください。

サービス

サービス名	デフォルトポート	説明
ウェブ	`443`	すべての管理者とのやり取りのためのWebインターフェース
API	`4000`	データベースを抽象化するAPIレイヤー
ブリー	なし	バックグラウンドジョブとタスクランナー
SMTP	`465/587`	送信メール用のSMTPサーバー
SMTPブリー	なし	SMTPバックグラウンドジョブ
MX	`2525`	受信メールとメール転送のためのメール交換
IMAP	`993/2993`	受信メールとメールボックス管理用の IMAP サーバー
POP3	`995/2995`	受信メールとメールボックス管理用の POP3 サーバー
SQLite	`3456`	SQLite データベースとのやり取りのための SQLite サーバー
SQLite ブリー	なし	SQLite バックグラウンドジョブ
CalDAV	`5000`	カレンダー管理用のCalDAVサーバー
カードDAV	`6000`	カレンダー管理用のCardDAVサーバー
モンゴDB	`27017`	ほとんどのデータ管理にMongoDBデータベースを使用
レディス	`6379`	キャッシュと状態管理のためのRedis
SQLite	なし	暗号化されたメールボックス用の SQLite データベース

重要なファイルパス

注: 以下の ホストパス は /root/forwardemail.net/self-hosting/ を基準としています。

成分	ホストパス	コンテナパス
モンゴDB	`./mongo-backups`	`/backups`
レディス	`./redis-data`	`/data`
スクライト	`./sqlite-data`	`/mnt/{SQLITE_STORAGE_PATH}`
環境変数ファイル	`./.env`	`/app/.env`
SSL証明書/キー	`./ssl`	`/app/ssl/`
秘密鍵	`./ssl/privkey.pem`	`/app/ssl/privkey.pem`
フルチェーン証明書	`./ssl/fullchain.pem`	`/app/ssl/fullchain.pem`
認定CA	`./ssl/cert.pem`	`/app/ssl/cert.pem`
DKIM秘密鍵	`./ssl/dkim.key`	`/app/ssl/dkim.key`

Important

.env ファイルを安全に保存してください。これは障害発生時の復旧に不可欠です。このファイルは /root/forwardemail.net/self-hosting/.env にあります。

構成

初期DNSセットアップ

ご利用のDNSプロバイダーで、適切なDNSレコードを設定してください。括弧内（<>）は動的であるため、変更後の値に更新する必要があります。

タイプ	名前	コンテンツ	TTL
A	「@」、「.」、または空白	<IPアドレス>	自動車
CNAME	API	<ドメイン名>	自動車
CNAME	カルダブ	<ドメイン名>	自動車
CNAME	カードダブ	<ドメイン名>	自動車
CNAME	feバウンス	<ドメイン名>	自動車
CNAME	imap	<ドメイン名>	自動車
CNAME	ミックス	<ドメイン名>	自動車
CNAME	ポップ3	<ドメイン名>	自動車
CNAME	SMTP	<ドメイン名>	自動車
MX	「@」、「.」、または空白	mx.<ドメイン名> (優先度 0)	自動車
TXT	「@」、「.」、または空白	「v=spf1 a -all」	自動車

逆DNS / PTRレコード

逆DNS（rDNS）または逆ポインタレコード（PTRレコード）は、メールサーバーにとって不可欠です。これらは、メールを送信するサーバーの正当性を検証するのに役立ちます。クラウドプロバイダーごとに実装方法が異なるため、「逆DNS」を追加してホストとIPアドレスを対応するホスト名にマッピングする方法を調べる必要があります。おそらくプロバイダーのネットワーク設定セクションに記載されているでしょう。

ポート25がブロックされています

一部のISPやクラウドプロバイダーは、悪意のある攻撃者を防ぐためにポート25をブロックしています。SMTP/送信メール用にポート25を開放するには、サポートチケットを提出する必要がある場合があります。

オンボーディング

ランディングページを開く https://<domain_name> にアクセスします。<domain_name> は、DNS設定で設定したドメインに置き換えてください。メール転送のランディングページが表示されます。
ログインしてドメインを登録する

有効なメールアドレスとパスワードでサインインしてください。
設定するドメイン名を入力してください（DNS設定と一致する必要があります）。
プロンプトに従って、確認に必要なMXレコードとTXTレコードを追加してください。

セットアップを完了する

確認が完了したら、「エイリアス」ページにアクセスして最初のエイリアスを作成してください。
必要に応じて、ドメイン設定 で 送信メール用の SMTP を設定します。これには追加の DNS レコードが必要です。

Note

サーバー外部に情報は送信されません。セルフホストオプションと初期アカウントは、ドメイン、エイリアス、および関連するメール設定を管理するための管理者ログインとWebビューのみを目的としています。

テスト

最初のエイリアスを作成しています

エイリアスページに移動しますエイリアス管理ページを開きます。

https://<domain_name>/en/my-account/domains/<domain_name>/aliases

新しいエイリアスを追加する

エイリアスを追加 (右上) をクリックします。
エイリアス名を入力し、必要に応じてメール設定を調整します。
(オプション) チェックボックスをオンにして、IMAP/POP3/CalDAV/CardDAV サポートを有効にします。
エイリアスを作成 をクリックします。

パスワードを設定する

安全なパスワードを作成するには、[パスワードを生成] をクリックします。
このパスワードは、メールクライアントにログインする際に必要になります。

メールクライアントを設定する

Thunderbird などのメールクライアントを使用します。
エイリアス名と生成されたパスワードを入力します。
IMAP と SMTP の設定を適宜行います。

メールサーバーの設定

ユーザー名: <alias name>

タイプ	ホスト名	ポート	接続セキュリティ	認証
SMTP	smtp.<ドメイン名>	465	SSL / TLS	通常のパスワード
IMAP	imap.<ドメイン名>	993	SSL / TLS	通常のパスワード

最初のメールの送受信

設定が完了すると、新しく作成して自己ホストした電子メールアドレスで電子メールを送受信できるようになります。

トラブルシューティング

UbuntuとDebian以外ではなぜ動作しないのか

現在、macOSのサポートを検討しており、他のOSへの対応も検討しています。他のOSへの対応をご希望の場合は、議論を開設するか、ご寄付をお願いいたします。

certbot acmeチャレンジが失敗する理由

最もよくある落とし穴は、certbot / letsencrypt が 2 回のチャレンジを要求する場合があることです。必ず両方の txt レコードを追加してください。

例: 次のような2つのチャレンジが表示される場合があります: _acme-challenge.example.com -> "randomstring1" _acme-challenge.example.com -> "randomstring2"

DNSの伝播が完了していない可能性もあります。https://toolbox.googleapps.com/apps/dig/#TXT/_acme-challenge.<your_domain>などのツールが利用可能です。これにより、TXTレコードの変更が反映されているかどうかを確認できます。また、ホスト上のローカルDNSキャッシュが古い値を使用しているか、最近の変更が反映されていない可能性もあります。

もう一つの選択肢は、CerbotのDNS自動変更機能を利用することです。VPSの初期セットアップ時に、cloud-init / user-data内の/root/.cloudflare.iniファイルにAPIトークンを設定するか、このファイルを作成してスクリプトを再度実行します。これにより、DNSの変更とチャレンジの更新が自動的に管理されます。

基本認証のユーザー名とパスワードは何ですか？

セルフホスティングの場合、初回ログイン時にブラウザネイティブの認証ポップアップを追加し、ユーザー名（admin）とパスワード（初期設定時にランダムに生成）を入力します。これは、自動化ツールやスクレーパーが何らかの理由でウェブ上での初回登録を先取りした場合の保護対策です。このパスワードは、初期設定後、.env ファイルの AUTH_BASIC_USERNAME と AUTH_BASIC_PASSWORD 配下にあります。

何が実行されているかを知るにはどうすればいいですか？

docker ps を実行すると、docker-compose-self-hosting.yml ファイルから起動されているすべての実行中コンテナを確認できます。また、docker ps -a を実行すると、すべて（実行されていないコンテナも含む）を確認できます。

実行されているはずの何かが実行されていないかどうかを知るにはどうすればいいですか？

docker ps -a を実行すると、すべて（実行されていないコンテナも含む）を確認できます。終了ログまたはメモが表示される場合があります。

ログを見つけるにはどうすればいいですか？

docker logs -f <container_name> からさらにログを取得できます。何かログが残っている場合は、.env ファイルの設定が間違っている可能性があります。

Web UI 内では、送信メールログとエラーログのそれぞれ /admin/emails と /admin/logs を表示できます。

送信メールがタイムアウトするのはなぜですか？

MXサーバーへの接続時に「接続がタイムアウトしました...」のようなメッセージが表示された場合は、ポート25がブロックされていないか確認する必要があるかもしれません。ISPやクラウドプロバイダーはデフォルトでこのポートをブロックしていることが多いため、サポートに問い合わせるか、チケットを発行してポート25を開放してもらう必要があるかもしれません。

メール設定のベストプラクティスとIPレピュテーションをテストするにはどのツールを使用すればよいですか？

よくある質問はこちらをご覧ください。