Ubuntu向けメール転送セルフホスティングインストールガイド
概要
このガイドでは、Forward Emailのセルフホスト型ソリューションをUbuntuシステムにインストールするための手順を段階的に説明します。このガイドは、Ubuntu 20.04、22.04、および24.04 LTSバージョン向けに特別にカスタマイズされています。
前提条件
インストールを開始する前に、次のものを用意してください。
- Ubuntuサーバー: 20.04、22.04、または24.04 LTS
- ルートアクセス: コマンドをルートとして実行できる必要があります (sudo アクセス)
- ドメイン名: DNS管理アクセスで制御するドメイン
- クリーンサーバー: Ubuntuの新規インストールを推奨
- インターネット接続: パッケージとDockerイメージのダウンロードに必要
システム要件
- RAM: 最低2GB（本番環境では4GBを推奨）
- ストレージ: 最低20GBの空き容量（本番環境では50GB以上を推奨）
- CPU: 最低 1 vCPU (本番環境では 2 vCPU 以上を推奨)
- ネットワーク: 次のポートにアクセスできるパブリック IP アドレス:
- 22 (SSH)
- 25 (SMTP)
- 80 (HTTP)
- 443 (HTTPS)
- 465 (SMTPS)
- 993 (IMAPS)
- 995 (POP3S)
ステップバイステップのインストール
ステップ1: 初期システムセットアップ
まず、システムが最新であることを確認し、ルート ユーザーに切り替えます。
# Update system packages
sudo apt update && sudo apt upgrade -y
Switch to root user (required for the installation)
sudo su -
ステップ2: DNSリゾルバーを構成する
信頼性の高い証明書生成のために、Cloudflare の DNS サーバーを使用するようにシステムを設定します。
# Stop and disable systemd-resolved if running
if systemctl is-active --quiet systemd-resolved; then
rm /etc/resolv.conf
systemctl stop systemd-resolved
systemctl disable systemd-resolved
systemctl mask systemd-resolved
fi
Configure Cloudflare DNS resolvers
tee /etc/resolv.conf > /dev/null <<EOF
nameserver 1.1.1.1
nameserver 2606:4700:4700::1111
nameserver 1.0.0.1
nameserver 2606:4700:4700::1001
nameserver 8.8.8.8
nameserver 2001:4860:4860::8888
nameserver 8.8.4.4
nameserver 2001:4860:4860::8844
EOF
ステップ3: システム依存関係をインストールする
メール転送に必要なパッケージをインストールします。
# Update package list
apt-get update -y
Install basic dependencies
apt-get install -y
ca-certificates
curl
gnupg
git
openssl
docker-compose
snapd
ステップ4: Snapパッケージをインストールする
スナップ経由で AWS CLI と Certbot をインストールします。
# Install AWS CLI
snap install aws-cli --classic
Install Certbot and DNS plugin
snap install certbot --classic
snap set certbot trust-plugin-with-root=ok
snap install certbot-dns-cloudflare
ステップ5: Dockerをインストールする
Docker CE と Docker Compose をインストールします。
# Add Docker's official GPG key
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | tee /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
Add Docker repository
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list
Update package index and install Docker
apt-get update -y
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Verify Docker installation
docker --version
docker compose version
ステップ6: Dockerサービスを構成する
Docker が自動的に起動し、実行されていることを確認します。
# Enable and start Docker service
systemctl unmask docker
systemctl enable docker
systemctl start docker
Verify Docker is running
docker info
Docker の起動に失敗した場合は、手動で起動してみてください。
# Alternative startup method if systemctl fails
nohup dockerd >/dev/null 2>/dev/null &
sleep 5
docker info
ステップ7: ファイアウォールを構成する
サーバーを保護するために UFW ファイアウォールを設定します。
# Set default policies
ufw default deny incoming
ufw default allow outgoing
Allow SSH (important - don't lock yourself out!)
ufw allow 22/tcp
Allow email-related ports
ufw allow 25/tcp # SMTP
ufw allow 80/tcp # HTTP (for Let's Encrypt)
ufw allow 443/tcp # HTTPS
ufw allow 465/tcp # SMTPS
ufw allow 993/tcp # IMAPS
ufw allow 995/tcp # POP3S
ufw allow 2993/tcp # IMAP (alternative port)
ufw allow 2995/tcp # POP3 (alternative port)
ufw allow 3456/tcp # Custom service port
ufw allow 4000/tcp # Custom service port
ufw allow 5000/tcp # Custom service port
Allow local database connections
ufw allow from 127.0.0.1 to any port 27017 # MongoDB
ufw allow from 127.0.0.1 to any port 6379 # Redis
Enable firewall
echo "y" | ufw enable
Check firewall status
ufw status numbered
ステップ8: 転送メールリポジトリのクローンを作成する
転送メールのソースコードをダウンロードしてください:
# Set up variables
REPO_FOLDER_NAME="forwardemail.net"
REPO_URL="https://github.com/forwardemail/forwardemail.net.git"
ROOT_DIR="/root/$REPO_FOLDER_NAME"
Clone the repository
git clone "$REPO_URL" "$ROOT_DIR"
cd "$ROOT_DIR"
Verify the clone was successful
ls -la
ステップ9: 環境設定のセットアップ
環境設定を準備します。
# Set up directory variables
SELF_HOST_DIR="$ROOT_DIR/self-hosting"
ENV_FILE_DEFAULTS=".env.defaults"
ENV_FILE=".env"
Copy default environment file
cp "$ROOT_DIR/$ENV_FILE_DEFAULTS" "$SELF_HOST_DIR/$ENV_FILE"
Create SSL directory
mkdir -p "$SELF_HOST_DIR/ssl"
Create database directories
mkdir -p "$SELF_HOST_DIR/sqlite-data"
mkdir -p "$SELF_HOST_DIR/mongo-backups"
mkdir -p "$SELF_HOST_DIR/redis-backups"
ステップ10: ドメインを設定する
ドメイン名を設定し、環境変数を更新します。
# Replace 'yourdomain.com' with your actual domain
DOMAIN="yourdomain.com"
Function to update environment file
update_env_file() {
local key="$1"
local value="$2"
if grep -qE "^${key}=" "$SELF_HOST_DIR/$ENV_FILE"; then
sed -i -E "s|^${key}=.*|${key}=${value}|" "$SELF_HOST_DIR/$ENV_FILE"
else
echo "${key}=${value}" >> "$SELF_HOST_DIR/$ENV_FILE"
fi
}
Update domain-related environment variables
update_env_file "DOMAIN" "$DOMAIN"
update_env_file "NODE_ENV" "production"
update_env_file "HTTP_PROTOCOL" "https"
update_env_file "WEB_HOST" "$DOMAIN"
update_env_file "WEB_PORT" "443"
update_env_file "CALDAV_HOST" "caldav.$DOMAIN"
update_env_file "CARDDAV_HOST" "carddav.$DOMAIN"
update_env_file "API_HOST" "api.$DOMAIN"
update_env_file "APP_NAME" "$DOMAIN"
update_env_file "SMTP_HOST" "smtp.$DOMAIN"
update_env_file "SMTP_PORT" "465"
update_env_file "IMAP_HOST" "imap.$DOMAIN"
update_env_file "IMAP_PORT" "993"
update_env_file "POP3_HOST" "pop3.$DOMAIN"
update_env_file "POP3_PORT" "995"
update_env_file "MX_HOST" "mx.$DOMAIN"
update_env_file "SMTP_EXCHANGE_DOMAINS" "mx.$DOMAIN"
update_env_file "SELF_HOSTED" "true"
update_env_file "WEBSITE_URL" "$DOMAIN"
update_env_file "AUTH_BASIC_ENABLED" "true"
ステップ11: SSL証明書を生成する
オプションA: 手動DNSチャレンジ（ほとんどのユーザーに推奨）
# Generate certificates using manual DNS challenge
certbot certonly \
--manual \
--agree-tos \
--preferred-challenges dns \
-d "*.$DOMAIN" \
-d "$DOMAIN"
重要: プロンプトが表示されたら、DNSにTXTレコードを作成する必要があります。同じドメインに対して複数のチャレンジが表示される場合があります。 すべてを作成する2 番目の TXT レコードを追加するときに、最初の TXT レコードを削除しないでください。
オプションB: Cloudflare DNS (Cloudflare を使用している場合)
ドメインが DNS に Cloudflare を使用している場合は、証明書の生成を自動化できます。
# Create Cloudflare credentials file
cat > /root/.cloudflare.ini <<EOF
dns_cloudflare_email = "your-email@example.com"
dns_cloudflare_api_key = "your-cloudflare-global-api-key"
EOF
Set proper permissions
chmod 600 /root/.cloudflare.ini
Generate certificates automatically
certbot certonly
--dns-cloudflare
--dns-cloudflare-credentials /root/.cloudflare.ini
-d "$DOMAIN"
-d "*.$DOMAIN"
--non-interactive
--agree-tos
--email "your-email@example.com"
証明書のコピー
証明書が生成されたら、それをアプリケーション ディレクトリにコピーします。
# Copy certificates to application SSL directory
cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/"
Verify certificates were copied
ls -la "$SELF_HOST_DIR/ssl/"
ステップ12: 暗号化キーを生成する
安全な操作に必要なさまざまな暗号化キーを作成します。
# Generate helper encryption key
helper_encryption_key=$(openssl rand -base64 32 | tr -d /=+ | cut -c -32)
update_env_file "HELPER_ENCRYPTION_KEY" "$helper_encryption_key"
Generate SRS secret for email forwarding
srs_secret=$(openssl rand -base64 32 | tr -d /=+ | cut -c -32)
update_env_file "SRS_SECRET" "$srs_secret"
Generate TXT encryption key
txt_encryption_key=$(openssl rand -hex 16)
update_env_file "TXT_ENCRYPTION_KEY" "$txt_encryption_key"
Generate DKIM private key for email signing
openssl genrsa -f4 -out "$SELF_HOST_DIR/ssl/dkim.key" 2048
update_env_file "DKIM_PRIVATE_KEY_PATH" "/app/ssl/dkim.key"
Generate webhook signature key
webhook_signature_key=$(openssl rand -hex 16)
update_env_file "WEBHOOK_SIGNATURE_KEY" "$webhook_signature_key"
Set SMTP transport password
update_env_file "SMTP_TRANSPORT_PASS" "$(openssl rand -base64 32)"
echo "✅ All encryption keys generated successfully"
ステップ13: 構成内のSSLパスを更新する
環境ファイルで SSL 証明書のパスを設定します。
# Update SSL paths to point to the correct certificate files
sed -i -E \
-e 's|^(.*_)?SSL_KEY_PATH=.*|\1SSL_KEY_PATH=/app/ssl/privkey.pem|' \
-e 's|^(.*_)?SSL_CERT_PATH=.*|\1SSL_CERT_PATH=/app/ssl/fullchain.pem|' \
-e 's|^(.*_)?SSL_CA_PATH=.*|\1SSL_CA_PATH=/app/ssl/chain.pem|' \
"$SELF_HOST_DIR/$ENV_FILE"
ステップ14: 基本認証を設定する
一時的な基本認証資格情報を作成します。
# Generate a secure random password
PASSWORD=$(openssl rand -base64 16)
Update environment file with basic auth credentials
update_env_file "AUTH_BASIC_USERNAME" "admin"
update_env_file "AUTH_BASIC_PASSWORD" "$PASSWORD"
Display credentials (save these!)
echo ""
echo "🔐 IMPORTANT: Save these login credentials!"
echo "=================================="
echo "Username: admin"
echo "Password: $PASSWORD"
echo "=================================="
echo ""
echo "You'll need these to access the web interface after installation."
echo ""
ステップ15: Docker Composeでデプロイする
すべてのメール転送サービスを開始します。
# Set Docker Compose file path
DOCKER_COMPOSE_FILE="$SELF_HOST_DIR/docker-compose-self-hosted.yml"
Stop any existing containers
docker compose -f "$DOCKER_COMPOSE_FILE" down
Pull the latest images
docker compose -f "$DOCKER_COMPOSE_FILE" pull
Start all services in detached mode
docker compose -f "$DOCKER_COMPOSE_FILE" up -d
Wait a moment for services to start
sleep 10
Check service status
docker compose -f "$DOCKER_COMPOSE_FILE" ps
ステップ16: インストールの確認
すべてのサービスが正しく実行されていることを確認します。
# Check Docker containers
docker ps
Check service logs for any errors
docker compose -f "$DOCKER_COMPOSE_FILE" logs --tail=50
Test web interface connectivity
curl -I https://$DOMAIN
Check if ports are listening
netstat -tlnp | grep -E ':(25|80|443|465|587|993|995)'
インストール後の設定
DNSレコードの設定
ドメインに対して次の DNS レコードを構成する必要があります。
MXレコード
@ MX 10 mx.yourdomain.com
Aレコード
@ A YOUR_SERVER_IP
mx A YOUR_SERVER_IP
smtp A YOUR_SERVER_IP
imap A YOUR_SERVER_IP
pop3 A YOUR_SERVER_IP
api A YOUR_SERVER_IP
caldav A YOUR_SERVER_IP
carddav A YOUR_SERVER_IP
SPFレコード
@ TXT "v=spf1 mx ~all"
DKIMレコード
DKIM公開鍵を取得します:
# Extract DKIM public key
openssl rsa -in "$SELF_HOST_DIR/ssl/dkim.key" -pubout -outform DER | openssl base64 -A
DKIM DNSレコードを作成します:
default._domainkey TXT "v=DKIM1; k=rsa; p=YOUR_DKIM_PUBLIC_KEY"
DMARCレコード
_dmarc TXT "v=DMARC1; p=quarantine; rua=mailto:dmarc@yourdomain.com"
初回ログイン
- ウェブブラウザを開いて、
https://yourdomain.com - 先ほど保存した基本認証情報を入力します
- 初期セットアップウィザードを完了する
- 最初のメールアカウントを作成する
バックアップ構成
S3互換バックアップの設定
S3 互換ストレージへの自動バックアップを構成します。
# Create AWS credentials directory
mkdir -p ~/.aws
Configure AWS credentials
cat > ~/.aws/credentials <<EOF
[default]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
EOF
Configure AWS settings
cat > ~/.aws/config <<EOF
[default]
region = auto
output = json
EOF
For non-AWS S3 (like Cloudflare R2), add endpoint URL
echo "endpoint_url = YOUR_S3_ENDPOINT_URL" >> ~/.aws/config
バックアップ Cron ジョブの設定
# Make backup scripts executable
chmod +x "$ROOT_DIR/self-hosting/scripts/backup-mongo.sh"
chmod +x "$ROOT_DIR/self-hosting/scripts/backup-redis.sh"
Add MongoDB backup cron job (runs daily at midnight)
(crontab -l 2>/dev/null; echo "0 0 * * * $ROOT_DIR/self-hosting/scripts/backup-mongo.sh >> /var/log/mongo-backup.log 2>&1") | crontab -
Add Redis backup cron job (runs daily at midnight)
(crontab -l 2>/dev/null; echo "0 0 * * * $ROOT_DIR/self-hosting/scripts/backup-redis.sh >> /var/log/redis-backup.log 2>&1") | crontab -
Verify cron jobs were added
crontab -l
自動更新設定
Forward Email インストールの自動更新を設定します。
# Create auto-update command
DOCKER_UPDATE_CMD="docker compose -f $DOCKER_COMPOSE_FILE pull && docker compose -f $DOCKER_COMPOSE_FILE up -d"
Add auto-update cron job (runs daily at 1 AM)
(crontab -l 2>/dev/null; echo "0 1 * * * $DOCKER_UPDATE_CMD >> /var/log/autoupdate.log 2>&1") | crontab -
Verify the cron job was added
crontab -l
メンテナンスと監視
ログの場所
- Docker Compose ログ:
docker compose -f $DOCKER_COMPOSE_FILE logs - システムログ:
/var/log/syslog - バックアップログ:
/var/log/mongo-backup.log,/var/log/redis-backup.log - 自動更新ログ:
/var/log/autoupdate.log
定期的なメンテナンスタスク
- ディスク容量を監視する:
df -h - サービスステータスを確認する:
docker compose -f $DOCKER_COMPOSE_FILE ps - ログを確認する:
docker compose -f $DOCKER_COMPOSE_FILE logs --tail=100 - システムパッケージを更新する:
apt update && apt upgrade - 証明書の更新: 証明書は自動更新されますが、有効期限を監視します
証明書の更新
証明書は自動更新されますが、必要に応じて手動で更新することもできます。
# Manual certificate renewal
certbot renew
Copy renewed certificates
cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/"
Restart services to use new certificates
docker compose -f "$DOCKER_COMPOSE_FILE" restart
トラブルシューティング
よくある問題
1. Dockerサービスが起動しない
# Check Docker status
systemctl status docker
Try alternative startup
nohup dockerd >/dev/null 2>/dev/null &
2. 証明書生成に失敗する
- ポート80と443がアクセス可能であることを確認する
- DNSレコードがサーバーを指していることを確認する
- ファイアウォールの設定を確認する
3. メール配信の問題
- MXレコードが正しいことを確認する
- SPF、DKIM、DMARCレコードを確認する
- ホスティングプロバイダーによってポート25がブロックされていないことを確認してください
4. Webインターフェースにアクセスできない
- ファイアウォールの設定を確認します。
ufw status - SSL 証明書を確認します。
openssl x509 -in $SELF_HOST_DIR/ssl/fullchain.pem -text -noout - 基本認証の資格情報を確認する
ヘルプの取得
- ドキュメント: https://forwardemail.net/self-hosted
- GitHub の問題: https://github.com/forwardemail/forwardemail.net/issues
- コミュニティサポート: プロジェクトのGitHubディスカッションを確認する
セキュリティのベストプラクティス
- システムを最新の状態に保つ: Ubuntuとパッケージを定期的に更新する
- ログを監視する: ログ監視とアラートを設定する
- 定期的にバックアップする: バックアップと復元の手順をテストする
- 強力なパスワードを使用する: すべてのアカウントに強力なパスワードを生成する
- フェイル2バンを有効にする: セキュリティ強化のため、fail2banのインストールを検討してください
- 定期的なセキュリティ監査: 定期的に設定を確認してください
結論
Forward Emailのセルフホストインストールが完了し、Ubuntuで実行されるはずです。以下の点にご注意ください。
- DNSレコードを適切に設定する
- メールの送受信をテストする
- 定期的なバックアップを設定する
- システムを定期的に監視する
- インストールを最新の状態に保つ
追加の設定オプションと高度な機能については、次の公式メール転送ドキュメントを参照してください。 https://forwardemail.net/self-hosted#configuration.