Thiết lập email

Để có cái nhìn tổng quan nhanh, hãy tham khảo hướng dẫn sử dụng được cung cấp tại đây: Đặt lại mật khẩu

Thiết lập chung

LibreChat hỗ trợ nhiều nhà cung cấp email:

• Mailgun API - Được khuyến nghị cho các máy chủ chặn cổng SMTP
• Dịch vụ SMTP - Gửi email truyền thống thông qua Gmail, Outlook hoặc các máy chủ thư điện tử tùy chỉnh

Cấu hình chung

Các biến này được sử dụng bởi cả Mailgun và SMTP:

Cấu hình Mailgun (Khuyên dùng)

Mailgun đặc biệt hữu ích cho các triển khai trên máy chủ chặn cổng SMTP để ngăn chặn thư rác. Khi cả MAILGUN_API_KEY và MAILGUN_DOMAIN đều được thiết lập, LibreChat sẽ sử dụng Mailgun thay vì SMTP.

Cấu hình SMTP

Cấu hình cơ bản

Nếu bạn muốn sử dụng một trong các dịch vụ được xác định trước, chỉ cần cấu hình các biến sau: Để biết thêm thông tin về các dịch vụ email được hỗ trợ: https://nodemailer.com/smtp/well-known-services

Cấu hình nâng cao

Nếu bạn muốn sử dụng dịch vụ SMTP chung hoặc cần cấu hình nâng cao cho một trong các nhà cung cấp được xác định trước, hãy cấu hình thêm các biến sau:

Thiết lập với Mailgun

Để thiết lập Mailgun, hãy làm theo các bước sau:

1. Đăng ký tài khoản Mailgun tại mailgun.com
2. Thêm và xác minh miền của bạn trong bảng điều khiển Mailgun
3. Điều hướng đến phần API Keys và sao chép Private API key của bạn
4. Trong tệp .env, hãy sửa đổi các biến như sau:

Thiết lập với Gmail

Để thiết lập Gmail, hãy làm theo các bước sau:

1. Tạo một Tài khoản Google và bật xác minh 2 bước.
2. Trong Google Account settings, hãy nhấp vào tab "Security" và mở "2-step verification."
3. Cuộn xuống và mở "App passwords." Chọn "Mail" cho ứng dụng và chọn "Other" cho thiết bị, sau đó đặt một tên bất kỳ cho nó.
4. Nhấp vào "Generate" để tạo mật khẩu và sao chép mật khẩu đã tạo.
5. Trong tệp .env, hãy sửa đổi các biến như sau:

Thiết lập với máy chủ mail tùy chỉnh

Để thiết lập máy chủ thư tùy chỉnh, hãy làm theo các bước sau:

1. Thu thập dữ liệu đăng nhập SMTP từ nhà cung cấp của bạn. Các bước thực hiện sẽ khác nhau tùy theo từng nhà cung cấp, nhưng họ thường sẽ liệt kê các giá trị cho tất cả các biến.
2. Trong tệp .env, hãy sửa đổi các biến như sau, giả định một số giá trị ví dụ hợp lý:

Các ví dụ cấu hình hoàn chỉnh

Ví dụ 1: Cấu hình 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

Ví dụ 2: Cấu hình SMTP Gmail

# ===================================
# 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

Ví dụ 3: Cấu hình máy chủ SMTP tùy chỉnh

# ===================================
# 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

Khắc phục sự cố

Các vấn đề với Mailgun

1. Xác thực thất bại: Đảm bảo rằng khóa API Mailgun của bạn là chính xác và có quyền gửi thư
2. Domain Not Found: Xác minh rằng tên miền Mailgun của bạn đã được cấu hình chính xác trong tài khoản Mailgun của bạn
3. Các vấn đề về khu vực EU: Nếu tài khoản Mailgun của bạn nằm trong khu vực EU, hãy đảm bảo đặt MAILGUN_HOST=https://api.eu.mailgun.net
4. Fallback to SMTP: Nếu chỉ một trong hai biến MAILGUN_API_KEY hoặc MAILGUN_DOMAIN được thiết lập, hệ thống sẽ chuyển sang sử dụng cấu hình SMTP.

Các vấn đề về SMTP

1. Connection Refused: Kiểm tra xem máy chủ của bạn có cho phép kết nối SMTP đi trên cổng đã chỉ định hay không
2. Authentication Failed: Xác minh tên người dùng và mật khẩu của bạn đã chính xác
3. Gmail App Password: Đối với Gmail, bạn phải sử dụng mật khẩu ứng dụng (app-specific password), không phải mật khẩu thông thường của bạn
4. Chứng chỉ tự ký (Self-signed Certificates): Nếu máy chủ thư điện tử của bạn sử dụng chứng chỉ tự ký, hãy đặt EMAIL_ALLOW_SELFSIGNED=true

Các vấn đề chung

1. Không gửi được email: Kiểm tra nhật ký (logs) của LibreChat để xem các thông báo lỗi
2. Đặt lại mật khẩu không bảo mật: Điều này xảy ra khi cả Mailgun và SMTP đều không được cấu hình đúng cách
3. Các vấn đề về địa chỉ gửi (From Address): Đảm bảo địa chỉ EMAIL_FROM hợp lệ và được ủy quyền để gửi từ dịch vụ thư điện tử của bạn.