メール設定

概要については、こちらで提供されているユーザーガイドを参照してください: パスワードリセット

一般的なセットアップ

LibreChatは複数のメールプロバイダーをサポートしています：

• Mailgun API - SMTPポートをブロックするサーバーに推奨
• SMTP サービス - Gmail、Outlook、またはカスタムメールサーバーを使用した従来のメール送信

一般的な設定

これらの変数は、MailgunとSMTPの両方で使用されます。

Mailgun 設定 (推奨)

Mailgunは、スパム防止のためにSMTPポートをブロックしているサーバーへのデプロイにおいて特に有用です。MAILGUN_API_KEY と MAILGUN_DOMAIN の両方が設定されている場合、LibreChatはSMTPの代わりにMailgunを使用します。

SMTP 設定

基本設定

定義済みのサービスを使用したい場合は、以下の変数のみを設定してください。 サポートされているメールサービスの詳細については、こちらを参照してください: https://community.nodemailer.com/2-0-0-beta/setup-smtp/well-known-services/

高度な設定

汎用的なSMTPサービスを使用する場合や、定義済みのプロバイダーに対して高度な設定が必要な場合は、以下の変数も設定してください：

Mailgun を使用したセットアップ

Mailgunをセットアップするには、以下の手順に従ってください：

1. mailgun.com でMailgunアカウントにサインアップしてください。
2. Mailgunダッシュボードでドメインを追加し、検証します
3. API Keysセクションに移動し、Private API keyをコピーしてください。
4. .env ファイル内の変数を以下のように変更します：

Gmailでのセットアップ

Gmailをセットアップするには、以下の手順に従ってください：

1. Googleアカウントを作成し、2段階認証を有効にします。
2. **Google アカウント設定**で、「セキュリティ」タブをクリックし、「2 段階認証プロセス」を開きます。
3. 下にスクロールして「App passwords」を開きます。アプリに「Mail」を選択し、デバイスに「Other」を選択してから、任意の名前を付けます。
4. 「Generate」をクリックしてパスワードを作成し、生成されたパスワードをコピーします。
5. .env ファイル内の変数を以下のように変更します：

カスタムメールサーバーでのセットアップ

カスタムメールサーバーをセットアップするには、以下の手順に従ってください：

1. プロバイダーからSMTPログイン情報を取得してください。手順は各プロバイダーによって異なりますが、通常はすべての変数に必要な値が記載されています。
2. .env ファイル内で、以下のように変数を変更します（妥当な例の値を想定しています）。

完全な設定例

例 1: Mailgun の設定

# ===================================
# Email Configuration - Mailgun
# ===================================
# Mailgun is recommended for servers that block SMTP ports
 
# Required Mailgun settings
MAILGUN_API_KEY=your-mailgun-api-key
MAILGUN_DOMAIN=mg.yourdomain.com
 
# Optional: For EU region
# MAILGUN_HOST=https://api.eu.mailgun.net
 
# Common email settings
EMAIL_FROM=[email protected]
EMAIL_FROM_NAME=LibreChat
 
# Enable password reset functionality
ALLOW_PASSWORD_RESET=true

例 2: Gmail SMTP 設定

# ===================================
# Email Configuration - Gmail SMTP
# ===================================
# Traditional SMTP configuration
 
# Gmail service configuration
EMAIL_SERVICE=gmail
EMAIL_USERNAME=[email protected]
EMAIL_PASSWORD=your-app-password
 
# Common email settings
EMAIL_FROM=[email protected]
EMAIL_FROM_NAME=LibreChat
 
# Enable password reset functionality
ALLOW_PASSWORD_RESET=true

例 3: カスタム SMTP サーバーの設定

# ===================================
# Email Configuration - Custom SMTP
# ===================================
# For custom mail servers
 
# SMTP server details
EMAIL_HOST=smtp.example.com
EMAIL_PORT=587
EMAIL_ENCRYPTION=starttls
EMAIL_USERNAME=[email protected]
EMAIL_PASSWORD=your-password
 
# Optional settings
# EMAIL_ENCRYPTION_HOSTNAME=
# EMAIL_ALLOW_SELFSIGNED=false
 
# Common email settings
EMAIL_FROM=[email protected]
EMAIL_FROM_NAME=LibreChat
 
# Enable password reset functionality
ALLOW_PASSWORD_RESET=true

トラブルシューティング

Mailgun に関する問題

1. 認証失敗: Mailgun APIキーが正しいこと、および送信権限が付与されていることを確認してください
2. ドメインが見つかりません: MailgunアカウントでMailgunドメインが正しく設定されていることを確認してください。
3. EUリージョンの問題: MailgunアカウントがEUリージョンにある場合は、MAILGUN_HOST=https://api.eu.mailgun.net を設定するようにしてください。
4. SMTPへのフォールバック: MAILGUN_API_KEY または MAILGUN_DOMAIN のいずれかのみが設定されている場合、システムはSMTP設定にフォールバックします。

SMTPに関する問題

1. Connection Refused: 指定されたポートでサーバーがアウトバウンドのSMTP接続を許可しているか確認してください。
2. 認証失敗: ユーザー名とパスワードが正しいことを確認してください
3. Gmail アプリパスワード: Gmail の場合、通常のパスワードではなく、アプリ固有のパスワードを使用する必要があります。
4. 自己署名証明書: メールサーバーが自己署名証明書を使用している場合は、EMAIL_ALLOW_SELFSIGNED=true を設定してください。

一般的な問題

1. メールが送信されない場合: LibreChatのログでエラーメッセージを確認してください
2. パスワードリセットの未保護: これは、MailgunまたはSMTPのいずれも適切に設定されていない場合に発生します。
3. From アドレスの問題: EMAIL_FROM アドレスが有効であり、ご利用のメールサービスから送信する権限があることを確認してください。