メールの設定

招待メールと通知メールを送るための設定。SMTP・Cloudflare Email Service・同じサーバーのメールサーバーを使う方法。

Vectana は、招待メールと通知メールを送ります。送信方法は MAIL_BACKEND で選びます。

`MAIL_BACKEND`	送信方法
`smtp`	SMTP サーバー経由（初期値）
`cloudflare`	Cloudflare Email Service の API
`none`	送信しない（ログに記録するだけ）

SMTP

メールサービス（SendGrid・Resend・Amazon SES・Google Workspace など）や、自社のメールサーバーの SMTP を使います。

MAIL_BACKEND=smtp
MAIL_FROM=Vectana <no-reply@example.com>
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USERNAME=（ユーザー名）
SMTP_PASSWORD=（パスワード）
SMTP_START_TLS=true
SMTP_USE_TLS=false

465 番ポート（SMTPS）を使う場合は、SMTP_PORT=465、SMTP_USE_TLS=true、SMTP_START_TLS=false にします。

Cloudflare Email Service

Cloudflare でドメインを管理している場合は、Cloudflare Email Service で送信できます。

MAIL_BACKEND=cloudflare
MAIL_FROM=no-reply@example.com
CLOUDFLARE_ACCOUNT_ID=（アカウント ID）
CLOUDFLARE_API_TOKEN=（メール送信の権限を付けた API トークン）

同じサーバーのメールサーバーを使う

docker-mailserver などを同じサーバーの Docker で動かしている場合は、Vectana をそのネットワークにつなぐと、認証なしで送信できます（メールサーバー側で Docker のネットワークからの送信を許可している場合）。

compose.yaml と同じディレクトリに compose.override.yaml を作ります。mail-network は、メールサーバーが参加しているネットワーク名に置き換えてください。

services:
  app:
    networks: [default, mail-network]
  worker:
    networks: [default, mail-network]

networks:
  mail-network:
    external: true

MAIL_BACKEND=smtp
MAIL_FROM=Vectana <no-reply@example.com>
SMTP_HOST=mailserver   # メールサーバーのコンテナ名
SMTP_PORT=25
SMTP_START_TLS=false

届かないときは

docker compose logs app worker で、送信のエラーが出ていないか確認します
送信元ドメインの SPF・DKIM・DMARC を設定してください。設定がないと、迷惑メールとして扱われたり、受け取りを拒否されたりします
送信に失敗した通知は、次回の定期チェックで再送されます（見つかってから 7 日間）