이메일 설정

빠른 개요를 보려면 여기에 제공된 사용자 가이드를 참조하세요: 비밀번호 재설정

일반 설정

LibreChat은(는) 여러 이메일 제공업체를 지원합니다:

• Mailgun API - SMTP 포트를 차단하는 서버에 권장됨
• SMTP 서비스 - Gmail, Outlook 또는 사용자 지정 메일 서버를 통한 기존 이메일 전송 방식

공통 구성

이 변수들은 Mailgun과 SMTP 모두에서 사용됩니다:

Mailgun 구성 (권장)

Mailgun은 스팸 방지를 위해 SMTP 포트를 차단하는 서버에 배포할 때 특히 유용합니다. MAILGUN_API_KEY와 MAILGUN_DOMAIN이 모두 설정되면, LibreChat은 SMTP 대신 Mailgun을 사용합니다.

SMTP 설정

기본 구성

사전 정의된 서비스 중 하나를 사용하려면 다음 변수만 구성하십시오: 지원되는 이메일 서비스에 대한 자세한 정보: https://nodemailer.com/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. 자체 서명 인증서(Self-signed Certificates): 메일 서버가 자체 서명 인증서를 사용하는 경우, EMAIL_ALLOW_SELFSIGNED=true로 설정하세요.

일반적인 문제

1. 이메일이 발송되지 않음: LibreChat 로그에서 오류 메시지를 확인하세요.
2. 보안되지 않은 비밀번호 재설정: 이는 Mailgun이나 SMTP가 올바르게 구성되지 않았을 때 발생합니다.
3. From 주소 문제: EMAIL_FROM 주소가 유효하며 메일 서비스에서 발송하도록 승인되었는지 확인하세요.