Konfiguracja poczty e-mail

Aby uzyskać szybki przegląd, zapoznaj się z przewodnikiem użytkownika dostępnym tutaj: Resetowanie hasła

Konfiguracja ogólna

LibreChat obsługuje wielu dostawców poczty e-mail:

• Mailgun API - Zalecane dla serwerów, które blokują porty SMTP
• Usługi SMTP - Tradycyjne wysyłanie wiadomości e-mail za pośrednictwem Gmail, Outlook lub własnych serwerów pocztowych

Typowa konfiguracja

Te zmienne są używane zarówno przez Mailgun, jak i SMTP:

Konfiguracja Mailgun (zalecane)

Mailgun jest szczególnie przydatny w przypadku wdrożeń na serwerach, które blokują porty SMTP w celu zapobiegania spamowi. Gdy ustawione są zarówno MAILGUN_API_KEY, jak i MAILGUN_DOMAIN, LibreChat będzie używać Mailgun zamiast SMTP.

Konfiguracja SMTP

Podstawowa konfiguracja

Jeśli chcesz skorzystać z jednej z predefiniowanych usług, skonfiguruj tylko te zmienne: Więcej informacji na temat obsługiwanych usług pocztowych: https://nodemailer.com/smtp/well-known-services

Zaawansowana konfiguracja

Jeśli chcesz skorzystać z ogólnej usługi SMTP lub potrzebujesz zaawansowanej konfiguracji dla jednego z predefiniowanych dostawców, skonfiguruj również te zmienne:

Konfiguracja z Mailgun

Aby skonfigurować Mailgun, wykonaj następujące kroki:

1. Zarejestruj się w serwisie Mailgun na stronie mailgun.com
2. Dodaj i zweryfikuj swoją domenę w panelu Mailgun
3. Przejdź do sekcji API Keys i skopiuj swój prywatny klucz API (Private API key).
4. W pliku .env zmodyfikuj zmienne w następujący sposób:

Konfiguracja z Gmail

Aby skonfigurować Gmail, wykonaj poniższe kroki:

1. Utwórz konto Google i włącz weryfikację dwuetapową.
2. W ustawieniach konta Google kliknij kartę „Bezpieczeństwo” i otwórz „Weryfikację dwuetapową”.
3. Przewiń w dół i otwórz „App passwords”. Wybierz „Mail” dla aplikacji i wybierz „Other” dla urządzenia, a następnie nadaj mu dowolną nazwę.
4. Kliknij „Generate”, aby utworzyć hasło, a następnie skopiuj wygenerowane hasło.
5. W pliku .env zmodyfikuj zmienne w następujący sposób:

Konfiguracja z własnym serwerem pocztowym

Aby skonfigurować własny serwer pocztowy, wykonaj poniższe kroki:

1. Zbierz swoje dane logowania SMTP od swojego dostawcy. Kroki różnią się w zależności od dostawcy, ale zazwyczaj podają oni wartości dla wszystkich zmiennych.
2. W pliku .env zmodyfikuj zmienne w następujący sposób, zakładając przykładowe, rozsądne wartości:

Kompletne przykłady konfiguracji

Przykład 1: Konfiguracja 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

Przykład 2: Konfiguracja SMTP Gmaila

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

Przykład 3: Konfiguracja niestandardowego serwera 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

Rozwiązywanie problemów

Problemy z Mailgun

1. Uwierzytelnianie nie powiodło się: Upewnij się, że Twój klucz API Mailgun jest poprawny i posiada uprawnienia do wysyłania wiadomości
2. Domena nie znaleziona: Sprawdź, czy Twoja domena Mailgun jest poprawnie skonfigurowana na Twoim koncie Mailgun
3. Problemy z regionem UE: Jeśli Twoje konto Mailgun znajduje się w regionie UE, upewnij się, że ustawiono MAILGUN_HOST=https://api.eu.mailgun.net
4. Fallback do SMTP: Jeśli ustawiono tylko jeden z parametrów MAILGUN_API_KEY lub MAILGUN_DOMAIN, system przełączy się na konfigurację SMTP

Problemy z SMTP

1. Connection Refused: Sprawdź, czy Twój serwer zezwala na wychodzące połączenia SMTP na określonym porcie
2. Uwierzytelnianie nie powiodło się: Sprawdź, czy nazwa użytkownika i hasło są poprawne
3. Hasło aplikacji Gmail: W przypadku Gmaila musisz użyć hasła specyficznego dla aplikacji, a nie swojego zwykłego hasła
4. Certyfikaty z podpisem własnym: Jeśli Twój serwer pocztowy używa certyfikatów z podpisem własnym, ustaw EMAIL_ALLOW_SELFSIGNED=true

Problemy ogólne

1. Brak wysłanych wiadomości e-mail: Sprawdź logi LibreChat pod kątem komunikatów o błędach
2. Niezabezpieczony reset hasła: Występuje, gdy ani Mailgun, ani SMTP nie są poprawnie skonfigurowane
3. Problemy z adresem nadawcy: Upewnij się, że adres EMAIL_FROM jest poprawny i autoryzowany do wysyłania wiadomości z Twojej usługi pocztowej