E-posta kurulumu

Bu kılavuz, güvenli e-posta doğrulama/şifre sıfırlama işlemlerinin nasıl yapılandırılacağını açıklar. Gmail, Mailgun ve özel posta sunucuları dahil olmak üzere çeşitli e-posta servisleriyle çalışacak şekilde yapılandırabilirsiniz.

Hızlı bir genel bakış için burada sağlanan kullanıcı kılavuzuna başvurun: Parola Sıfırlama

Genel kurulum

LibreChat birden fazla e-posta sağlayıcısını destekler:

Mailgun API - SMTP portlarını engelleyen sunucular için önerilir
SMTP Hizmetleri - Gmail, Outlook veya özel posta sunucuları aracılığıyla geleneksel e-posta gönderimi

Yaygın Yapılandırma

Bu değişkenler hem Mailgun hem de SMTP tarafından kullanılır:

Key	Type	Description	Example
EMAIL_FROM	string	Gönderen e-posta adresi. Zorunlu.	[email protected]
EMAIL_FROM_NAME	string	Gönderen adı (ayarlanmazsa varsayılan olarak APP_TITLE kullanılır).	EMAIL_FROM_NAME=LibreChat

Mailgun Yapılandırması (Önerilen)

Mailgun, spam'i önlemek için SMTP portlarını engelleyen sunuculardaki dağıtımlar için özellikle kullanışlıdır. Hem MAILGUN_API_KEY hem de MAILGUN_DOMAIN ayarlandığında, LibreChat SMTP yerine Mailgun'ı kullanacaktır.

Key	Type	Description	Example
MAILGUN_API_KEY	string	Mailgun API anahtarınız (Mailgun için gereklidir).	MAILGUN_API_KEY=
MAILGUN_DOMAIN	string	Mailgun alan adınız, örneğin mg.yourdomain.com (Mailgun için gereklidir).	MAILGUN_DOMAIN=
MAILGUN_HOST	string	Özel Mailgun API ana bilgisayarı (isteğe bağlı). AB bölgesi için https://api.eu.mailgun.net kullanın.	MAILGUN_HOST=https://api.mailgun.net

SMTP Yapılandırması

Temel Yapılandırma

Önceden tanımlanmış servislerden birini kullanmak istiyorsanız, yalnızca bu değişkenleri yapılandırın: Desteklenen e-posta servisleri hakkında daha fazla bilgi için: https://nodemailer.com/smtp/well-known-services

Key	Type	Description	Example
EMAIL_SERVICE	string	E-posta hizmeti (ör. Gmail, Outlook).	EMAIL_SERVICE=
EMAIL_USERNAME	string	Kimlik doğrulama için kullanıcı adı.	EMAIL_USERNAME=
EMAIL_PASSWORD	string	Kimlik doğrulama için parola.	EMAIL_PASSWORD=

Gelişmiş Yapılandırma

Genel bir SMTP hizmeti kullanmak istiyorsanız veya önceden tanımlanmış sağlayıcılardan biri için gelişmiş yapılandırmaya ihtiyaç duyuyorsanız, bu değişkenleri de yapılandırın:

Key	Type	Description	Example
EMAIL_HOST	string	Posta sunucusu ana makinesi.	EMAIL_HOST=
EMAIL_PORT	number	Posta sunucusu portu.	EMAIL_PORT=25
EMAIL_ENCRYPTION	string	Şifreleme yöntemi (starttls, tls, vb.).	EMAIL_ENCRYPTION=
EMAIL_ENCRYPTION_HOSTNAME	string	Şifreleme için ana bilgisayar adı (hostname).	EMAIL_ENCRYPTION_HOSTNAME=
EMAIL_ALLOW_SELFSIGNED	boolean	Kendinden imzalı sertifikalara izin ver.	EMAIL_ALLOW_SELFSIGNED=

Uyarı

Mailgun veya SMTP'yi düzgün bir şekilde yapılandırmamak, LibreChat'in güvenli olmayan parola sıfırlama yöntemini kullanmasına neden olacaktır! Bu durum, herhangi birinin sunucunuzdaki herhangi bir parolayı, hiçbir e-posta gönderilmesine gerek kalmadan anında sıfırlamasına olanak tanır!

Mailgun ile Kurulum

Mailgun'ı kurmak için şu adımları izleyin:

mailgun.com adresinden bir Mailgun hesabı için kaydolun
Mailgun panelinde alan adınızı ekleyin ve doğrulayın
API Keys bölümüne gidin ve Private API anahtarınızı kopyalayın
.env dosyasında, değişkenleri aşağıdaki gibi değiştirin:

Key	Type	Description	Example
MAILGUN_API_KEY	string	Mailgun özel API anahtarınız	MAILGUN_API_KEY=your-mailgun-api-key
MAILGUN_DOMAIN	string	Doğrulanmış Mailgun alan adınız	MAILGUN_DOMAIN=mg.yourdomain.com
EMAIL_FROM	string	Gönderen e-posta adresi	[email protected]
EMAIL_FROM_NAME	string	Gönderen adı	EMAIL_FROM_NAME=LibreChat
MAILGUN_HOST	string	(İsteğe bağlı) AB bölgesi için	MAILGUN_HOST=https://api.eu.mailgun.net

Not

Mailgun hesabınız AB bölgesindeyse, MAILGUN_HOST=https://api.eu.mailgun.net şeklinde ayarladığınızdan emin olun.

Gmail ile Kurulum

Gmail'i kurmak için şu adımları izleyin:

Bir Google Hesabı oluşturun ve 2 adımlı doğrulamayı etkinleştirin.
Google Hesap ayarları kısmında, "Güvenlik" sekmesine tıklayın ve "2 adımlı doğrulama" seçeneğini açın.
Aşağı kaydırın ve "App passwords" kısmını açın. Uygulama için "Mail"i, cihaz için ise "Other"ı seçin, ardından rastgele bir isim verin.
Bir parola oluşturmak için "Generate" düğmesine tıklayın ve oluşturulan parolayı kopyalayın.
.env dosyasında, değişkenleri aşağıdaki gibi değiştirin:

Key	Type	Description	Example
EMAIL_SERVICE	string	gmail	EMAIL_SERVICE=gmail
EMAIL_USERNAME	string	e-posta-adresiniz	EMAIL_USERNAME=your-email
EMAIL_PASSWORD	string	e-posta-parolanız	EMAIL_PASSWORD=your-email-password
EMAIL_FROM	string	gönderen alanı için e-posta adresi, örn. [email protected]	[email protected]
EMAIL_FROM_NAME	string	LibreChat Sunucum	EMAIL_FROM_NAME=LibreChat

Özel posta sunucusu ile kurulum

Özel bir posta sunucusu kurmak için şu adımları izleyin:

SMTP giriş bilgilerinizi sağlayıcınızdan alın. Adımlar her sağlayıcı için farklılık gösterir, ancak genellikle tüm değişkenler için değerleri listeleyeceklerdir.
.env dosyasında, bazı mantıklı örnek değerleri varsayarak değişkenleri aşağıdaki gibi değiştirin:

Key	Type	Description	Example
EMAIL_HOST	string	Bağlanılacak ana makine adı	EMAIL_HOST=mail.example.com
EMAIL_PORT	integer	Bağlanılacak port	EMAIL_PORT=25
EMAIL_ENCRYPTION	string	Şifreleme türü	EMAIL_ENCRYPTION=starttls
EMAIL_USERNAME	string	E-posta kullanıcı adınız	[email protected]
EMAIL_PASSWORD	string	Uygulama şifreniz	EMAIL_PASSWORD=password
EMAIL_FROM	string	Gönderen alanı için e-posta adresi	[email protected]
EMAIL_FROM_NAME	string	"Kimden" alanında görünecek isim	EMAIL_FROM_NAME=LibreChat

Tam Yapılandırma Örnekleri

Örnek 1: Mailgun Yapılandırması

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

Örnek 2: Gmail SMTP Yapılandırması

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

Örnek 3: Özel SMTP Sunucusu Yapılandırması

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

Sorun Giderme

Mailgun Sorunları

Kimlik Doğrulama Başarısız: Mailgun API anahtarınızın doğru olduğundan ve gönderim izinlerine sahip olduğundan emin olun
Domain Not Found: Mailgun alan adınızın Mailgun hesabınızda doğru şekilde yapılandırıldığını doğrulayın
AB Bölgesi Sorunları: Mailgun hesabınız AB bölgesindeyse, MAILGUN_HOST=https://api.eu.mailgun.net olarak ayarladığınızdan emin olun.
SMTP'ye geri dönüş: Eğer MAILGUN_API_KEY veya MAILGUN_DOMAIN değerlerinden yalnızca biri ayarlanmışsa, sistem SMTP yapılandırmasına geri dönecektir.

SMTP Sorunları

Connection Refused: Sunucunuzun belirtilen port üzerinden giden SMTP bağlantılarına izin verip vermediğini kontrol edin
Kimlik Doğrulama Başarısız: Kullanıcı adınızın ve şifrenizin doğru olduğunu doğrulayın
Gmail Uygulama Şifresi: Gmail için normal şifrenizi değil, uygulamaya özel bir şifre kullanmanız gerekir.
Self-signed Certificates: E-posta sunucunuz self-signed sertifikalar kullanıyorsa, EMAIL_ALLOW_SELFSIGNED=true olarak ayarlayın.

Genel Sorunlar

E-posta Gönderilmedi: Hata mesajları için LibreChat günlüklerini kontrol edin
Güvensiz Parola Sıfırlama: Bu durum, ne Mailgun ne de SMTP düzgün bir şekilde yapılandırılmadığında ortaya çıkar
Gönderen Adresi Sorunları: EMAIL_FROM adresinin geçerli olduğundan ve posta servisinizden gönderim yapmak için yetkilendirildiğinden emin olun

E-posta kurulumu

Bu sayfada