Debian向けメール転送セルフホスティングインストールガイド
概要
このガイドでは、Forward Emailのセルフホスト型ソリューションをDebianシステムにインストールするための手順を段階的に説明します。このガイドは、特にDebian 11 (Bullseye) およびDebian 12 (Bookworm) 向けにカスタマイズされています。
前提条件
インストールを開始する前に、次のものを用意してください。
- Debian サーバー: バージョン 11 (Bullseye) または 12 (Bookworm)
- ルートアクセス: コマンドをルートとして実行できる必要があります (sudo アクセス)
- ドメイン名: DNS管理アクセスで制御するドメイン
- クリーンサーバー: 新規のDebianインストールの使用を推奨
- インターネット接続: パッケージと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: システム依存関係をインストールする
Debian で Forward Email に必要なパッケージをインストールします。
# Update package list
apt-get update -y
Install basic dependencies (Debian-specific package list)
apt-get install -y
ca-certificates
curl
gnupg
git
openssl
lsb-release
apt-transport-https
software-properties-common
ステップ4: Snapdのインストールと設定
Debian にはデフォルトで snapd が含まれていないため、インストールして設定する必要があります。
# Install snapd
apt-get install -y snapd
Enable and start snapd service
systemctl enable snapd
systemctl start snapd
Create symlink for snap to work properly
ln -sf /var/lib/snapd/snap /snap
Wait for snapd to be ready
sleep 10
Verify snapd is working
snap version
ステップ5: 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
Verify installations
aws --version
certbot --version
ステップ6: Dockerをインストールする
Debian に Docker CE と Docker Compose をインストールします。
# Add Docker's official GPG key (Debian-specific)
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | tee /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
Add Docker repository (Debian-specific)
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(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
Install standalone docker-compose as fallback (if plugin doesn't work)
if ! command -v docker-compose &> /dev/null; then
apt-get install -y docker-compose
fi
Verify Docker installation
docker --version
docker compose version || docker-compose --version
ステップ7: 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
ステップ8: UFWファイアウォールのインストールと構成
Debian の最小インストールには UFW が含まれていない可能性があるため、最初にインストールします。
# Install UFW if not present
if ! command -v ufw &> /dev/null; then
apt-get update -y
apt-get install -y ufw
fi
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
ステップ9: 転送メールリポジトリのクローンを作成する
転送メールのソースコードをダウンロードしてください:
# 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
ステップ10: 環境設定のセットアップ
環境設定を準備します。
# 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"
ステップ11: ドメインを設定する
ドメイン名を設定し、環境変数を更新します。
# 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"
ステップ12: 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/"
ステップ13: 暗号化キーを生成する
安全な操作に必要なさまざまな暗号化キーを作成します。
# 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"
ステップ14: 構成内の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"
ステップ15: 基本認証を設定する
一時的な基本認証資格情報を作成します。
# 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 ""
ステップ16: Docker Composeでデプロイする
すべてのメール転送サービスを開始します。
# Set Docker Compose file path
DOCKER_COMPOSE_FILE="$SELF_HOST_DIR/docker-compose-self-hosted.yml"
Stop any existing containers
if command -v docker-compose &> /dev/null; then
docker-compose -f "$DOCKER_COMPOSE_FILE" down
else
docker compose -f "$DOCKER_COMPOSE_FILE" down
fi
Pull the latest images
if command -v docker-compose &> /dev/null; then
docker-compose -f "$DOCKER_COMPOSE_FILE" pull
else
docker compose -f "$DOCKER_COMPOSE_FILE" pull
fi
Start all services in detached mode
if command -v docker-compose &> /dev/null; then
docker-compose -f "$DOCKER_COMPOSE_FILE" up -d
else
docker compose -f "$DOCKER_COMPOSE_FILE" up -d
fi
Wait a moment for services to start
sleep 10
Check service status
if command -v docker-compose &> /dev/null; then
docker-compose -f "$DOCKER_COMPOSE_FILE" ps
else
docker compose -f "$DOCKER_COMPOSE_FILE" ps
fi
ステップ17: インストールの確認
すべてのサービスが正しく実行されていることを確認します。
# Check Docker containers
docker ps
Check service logs for any errors
if command -v docker-compose &> /dev/null; then
docker-compose -f "$DOCKER_COMPOSE_FILE" logs --tail=50
else
docker compose -f "$DOCKER_COMPOSE_FILE" logs --tail=50
fi
Test web interface connectivity
curl -I https://$DOMAIN
Check if ports are listening
ss -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 (use appropriate docker compose command)
if command -v docker-compose &> /dev/null; then
DOCKER_UPDATE_CMD="docker-compose -f $DOCKER_COMPOSE_FILE pull && docker-compose -f $DOCKER_COMPOSE_FILE up -d"
else
DOCKER_UPDATE_CMD="docker compose -f $DOCKER_COMPOSE_FILE pull && docker compose -f $DOCKER_COMPOSE_FILE up -d"
fi
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
Debian固有の考慮事項
パッケージ管理の違い
- スナップ: Debianではデフォルトではインストールされないため、手動でインストールする必要があります
- ドッカー: Debian固有のリポジトリとGPGキーを使用します
- UFW: 最小限の Debian インストールには含まれない可能性があります
- システムド: Ubuntuとは若干動作が異なる場合があります
サービス管理
# Check service status (Debian-specific commands)
systemctl status snapd
systemctl status docker
systemctl status ufw
Restart services if needed
systemctl restart snapd
systemctl restart docker
ネットワーク構成
Debian ではネットワーク インターフェイスの名前や構成が異なる場合があります。
# Check network interfaces
ip addr show
Check routing
ip route show
Check DNS resolution
nslookup google.com
メンテナンスと監視
ログの場所
- Docker Compose ログ: インストールに応じて適切な docker compose コマンドを使用する
- システムログ:
/var/log/syslog - バックアップログ:
/var/log/mongo-backup.log,/var/log/redis-backup.log - 自動更新ログ:
/var/log/autoupdate.log - Snapdログ:
journalctl -u snapd
定期的なメンテナンスタスク
- ディスク容量を監視する:
df -h - サービスステータスを確認する: 適切なdocker composeコマンドを使用する
- ログを確認するアプリケーションログとシステムログの両方を確認する
- システムパッケージを更新する:
apt update && apt upgrade - snapd を監視する:
snap listとsnap refresh
証明書の更新
証明書は自動更新されますが、必要に応じて手動で更新することもできます。
# Manual certificate renewal
certbot renew
Copy renewed certificates
cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/"
Restart services to use new certificates
if command -v docker-compose &> /dev/null; then
docker-compose -f "$DOCKER_COMPOSE_FILE" restart
else
docker compose -f "$DOCKER_COMPOSE_FILE" restart
fi
トラブルシューティング
Debian固有の問題
1. Snapdが動作しない
# Check snapd status
systemctl status snapd
Restart snapd
systemctl restart snapd
Check snap path
echo $PATH | grep snap
Add snap to PATH if missing
echo 'export PATH=$PATH:/snap/bin' >> ~/.bashrc
source ~/.bashrc
2. Docker Composeコマンドが見つかりません
# Check which docker compose command is available
command -v docker-compose
command -v docker
Use the appropriate command in scripts
if command -v docker-compose &> /dev/null; then
echo "Using docker-compose"
else
echo "Using docker compose"
fi
3. パッケージのインストールに関する問題
# Update package cache
apt update
Fix broken packages
apt --fix-broken install
Check for held packages
apt-mark showhold
よくある問題
1. Dockerサービスが起動しない
# Check Docker status
systemctl status docker
Check Docker logs
journalctl -u docker
Try alternative startup
nohup dockerd >/dev/null 2>/dev/null &
2. 証明書生成に失敗する
- ポート80と443がアクセス可能であることを確認する
- DNSレコードがサーバーを指していることを確認する
- ファイアウォールの設定を確認する
ufw status
3. メール配信の問題
- MXレコードが正しいことを確認する
- SPF、DKIM、DMARCレコードを確認する
- ホスティングプロバイダーによってポート25がブロックされていないことを確認してください
ヘルプの取得
- ドキュメント: https://forwardemail.net/self-hosted
- GitHub の問題: https://github.com/forwardemail/forwardemail.net/issues
- Debianドキュメント: https://www.debian.org/doc/
セキュリティのベストプラクティス
- システムを最新の状態に保つ: Debianとパッケージを定期的に更新する
- ログを監視する: ログ監視とアラートを設定する
- 定期的にバックアップする: バックアップと復元の手順をテストする
- 強力なパスワードを使用する: すべてのアカウントに強力なパスワードを生成する
- フェイル2バンを有効にする: セキュリティ強化のため、fail2banのインストールを検討してください
- 定期的なセキュリティ監査: 定期的に設定を確認してください
- Snapdを監視する: スナップパッケージを最新の状態に保つ
snap refresh
結論
Forward Emailのセルフホストインストールが完了し、Debian上で動作するようになりました。以下の点にご注意ください。
- DNSレコードを適切に設定する
- メールの送受信をテストする
- 定期的なバックアップを設定する
- システムを定期的に監視する
- インストールを最新の状態に保つ
- snapd および snap パッケージを監視する
Ubuntuとの主な違いは、snapdのインストールとDockerリポジトリの設定です。これらを適切に設定すれば、Forward Emailアプリケーションはどちらのシステムでも同じように動作します。
追加の設定オプションと高度な機能については、次の公式メール転送ドキュメントを参照してください。 https://forwardemail.net/self-hosted#configuration.