LibreChatE-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
.envdosyası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.
.envdosyası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.
.envdosyası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=trueSorun 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.netolarak ayarladığınızdan emin olun. - SMTP'ye geri dönüş: Eğer
MAILGUN_API_KEYveyaMAILGUN_DOMAINdeğ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=trueolarak 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_FROMadresinin geçerli olduğundan ve posta servisinizden gönderim yapmak için yetkilendirildiğinden emin olun
Bu rehber nasıl?
Kimlik Doğrulama Sistemi
Bu kılavuz, güvenli ve kolay e-posta ve sosyal giriş seçenekleri sunan LibreChat kullanıcı kimlik doğrulama sisteminin nasıl kullanılacağını açıklar. Kayıt olma, giriş yapma, şifre sıfırlama ve daha fazlasını nasıl ayarlayacağınızı öğreneceksiniz.
Passkeys
Let users sign in without a password using a device screen lock or a security key (WebAuthn). Covers enabling passkeys, the relying party settings, enrollment limits, and how passkeys interact with two-factor authentication.