ServBay Mailpit Servis Yapılandırma Rehberi

ServBay, geliştiricilerin uygulama e-posta gönderim işlevini test ve debug etmek için kullanabileceği, Mailpit adlı yazılım paketini entegre bir şekilde sunar. Bu yazıda, ServBay üzerinde Mailpit paketinin nasıl kurulacağı, etkinleştirileceği ve yapılandırılacağı; Common, SMTP, POP3 ve Relay olmak üzere dört ana yapılandırma sekmesiyle ilgili ayrıntılı bilgiler bulacaksınız.

Mailpit Yazılım Paketi Genel Bakış

Mailpit, açık kaynaklı, kullanımı kolay yerel bir SMTP/POP3 sunucusu ve sezgisel bir web arayüzü sunan bir araçtır. Uygulamanızın gönderdiği tüm e-postaları merkezi bir şekilde yakalar; böylece e-posta içeriklerine, başlıklara, ek dosyalara ve daha fazlasına gerçek alıcıya göndermeden kolayca erişebilir, inceleme yapabilirsiniz. Özellikle kullanıcı kaydı, şifre sıfırlama ve çeşitli bildirimlerde e-posta gönderimi gerektiren işlevlerin geliştirilmesi ve test edilmesi sırasında, bu süreçleri önemli ölçüde basitleştirir.

ServBay'in güçlü PKI sistemi sayesinde Mailpit çekirdek yazılım paketi olarak entegre edilmiştir ve kolayca kurulup yönetilebilir. Ayrıca PKI sistemiyle SSL/TLS sertifikaları otomatik olarak yapılandırılır, böylece güvenli bir test ortamı sağlanır.

Mailpit Yazılım Paketini Kurma ve Etkinleştirme

Mailpit'i yerel e-posta sunucunuz olarak kullanmadan önce, ServBay'den kurup etkinleştirmeniz gerekir.

1. ServBay uygulamasını açın.
2. Sol menüden Yazılım Paketleri bölümüne girin.
3. Paketler listesinden Genel Hizmetler kategorisini seçin.
4. Mailpit paketini bulun.
5. Mailpit kurulu değilse, sağdaki yeşil kurulum butonuna tıklayarak yükleyin.
6. Kurulum tamamlandıktan sonra, yandaki anahtar (switch) butonuna tıklayarak Mailpit paketini etkinleştirin.

ServBay'in güçlü PKI altyapısı sayesinde, Mailpit'in web yönetim arayüzü ile SMTP ve POP3 servisleri için ihtiyaç duyulan SSL sertifikaları otomatik olarak oluşturulup yapılandırılır. Böylece, STARTTLS veya SSL/TLS şifrelemesini elle sertifika oluşturma zahmeti olmadan doğrudan aktif edebilirsiniz.

Web E-posta Yönetim Arayüzü

Mailpit, yakalanan e-postaları görüntülemek ve yönetmek için güçlü bir web arayüzü sağlar. ServBay’de yapılandırma otomatik gerçekleştirildiği için, Mailpit paketi etkinleştirildiğinde arayüze doğrudan tarayıcıdan erişebilirsiniz:

Erişim adresi: https://mail.servbay.host

Bu arayüz üzerinden; alınan e-postaların listesini inceleyebilir, tekil postaların ayrıntılarını (HTML, düz metin, ham kaynak), e-posta araması yapabilir veya e-postaları silebilirsiniz.

Mailpit Yazılım Paketini Yapılandırma

ServBay, Mailpit parametrelerinin kolayca yönetilmesi için görsel bir arayüz sunar. Sol menüden Mail seçeneğine girip, ardından Mailpit Service Config’i tıklayarak yapılandırma ekranına erişebilirsiniz. Burada Common, SMTP, POP3 ve Relay adlı dört ana ayar sekmesi bulunur.

1. Common (Genel Ayarlar) Sekmesi

Common sekmesi, Mailpit’in genel davranış ve ayarlarını yönetmek içindir:

• Max Messages (Maksimum Mesaj Sayısı): Mailpit sunucusunun saklayacağı en fazla e-posta adedini belirler. Sınır aşıldığında en eski e-postalar otomatik olarak silinir.
• Max Age (Maksimum Saklama Süresi): E-postaların Mailpit üzerinde tutulabileceği maksimum gün sayısını ayarlar. Bu süreyi aşan iletiler kendiliğinden silinir.
• SpamAssassin: Spam filtreleme işlevini etkinleştirir veya kapatır. Aktif edildiğinde, Mailpit gelen iletileri spam olarak işaretlemeye çalışır.
• Webhook URL: Bir webhook URL’si belirleyerek Mailpit’in her yeni e-posta geldiğinde o URL’ye HTTP POST isteği göndermesini sağlayabilirsiniz. Otomasyon testleri veya dış sistem bildirimlerini entegre etmek için faydalıdır.
• Webhook Limit: Webhook üzerinden iletilecek e-posta adedi için üst limit tanımlar.

2. SMTP Sekmesi

TIP

ServBay’in güçlü PKI altyapısı sayesinde, SSL sertifikası otomatik olarak üretilip yapılandırılmıştır. STARTTLS veya SSL/TLS şifreli bağlantıyı doğrudan etkinleştirebilir, ayrı bir SSL sertifikası başvurusuna gerek kalmaz.

SMTP sekmesi, Mailpit’in SMTP sunucusuyla ilgili yapılandırmaları içerir. Uygulamanızın test e-postalarını göndereceği SMTP sunucusu burasıdır:

• SMTP Port (Port Numarası): Mailpit SMTP sunucusunun dinleyeceği portu tanımlar. Uygulamanızın hedef sunucu olarak 127.0.0.1 ya da localhost ve bu portu seçmesi gerekir (varsayılan: 1025).
• STARTTLS: Bağlantı sonrasında şifreli iletişime geçmek için STARTTLS opsiyonunu açıp kapatabilirsiniz.
• SSL/TLS: SSL/TLS şifreleme protokolünü etkinleştirerek bağlantının ilk saniyesinden itibaren güvenliğini sağlayabilirsiniz.
• Username: SMTP sunucusu için (isteğe bağlı) kullanıcı adı atanır. Tanımlarsanız, uygulamanız posta gönderirken kimlik doğrulama için bu kullanıcı adını kullanmalıdır.
• Password: (İsteğe bağlı) parola ayarlanır. Username ile beraber oturum açmak için kullanılır.
• Max Recipients: Her e-posta için izin verilen maksimum alıcı sayısını sınırlar; toplu gönderimleri yönetmek için kullanılır.
• Allowed Recipients: E-postaların kabul edileceği açık adres ya da alan adlarının listesidir (isteğe bağlı). Boş bırakılırsa, Mailpit tüm adreslerden posta kabul eder. Tanımlıysa, sadece listelenen adreslere gidenler alınır.

3. POP3 Sekmesi

TIP

ServBay’in güçlü PKI Altyapısı ile SSL sertifikası otomatik hazırlanır. SSL/TLS şifreli bağlantıyı ek bir sertifika başvurusu olmadan doğrudan etkinleştirebilirsiniz.

POP3 sekmesi, uygulamanızın e-posta alma fonksiyonlarını test etmek için Mailpit'in POP3 sunucusu ayarlarını yapılandırmanıza yardımcı olur:

• Enable POP3 Server (POP3 Sunucusunu Aktif Et): Mailpit POP3 sunucusunu açıp kapatabilirsiniz.
• POP3 Server Port (Port Numarası): POP3 sunucusunun dinleyeceği portu ayarlar (varsayılan: 1110).
• Username: (İsteğe bağlı) kullanıcı adı belirlenir. Tanımlarsanız, istemci kimlik doğrulaması için bu veriyi sağlamalıdır.
• Password: (İsteğe bağlı) parola ayarlanır ve Username ile beraber kimlik doğrulama yapmak için kullanılır.
• SSL/TLS: SSL/TLS şifreli bağlantıyı etkinleştirme seçeneği.

4. Relay (İletme) Sekmesi

Relay sekmesi, Mailpit'in aldığı bazı veya tüm e-postaları gerçek bir harici SMTP sunucusuna yönlendirmek için kullanılır:

• Enable SMTP Relay (SMTP Relayi Etkinleştir): Relay işlevini açmak veya kapatmak için kullanılır.
• Host: Harici SMTP sunucusunun adresi (ör: smtp.gmail.com, smtp.sendgrid.net).
• Port: Dış SMTP sunucusu için port numarası. Varsayılanlar: 25 (STMP), 465 (SMTPS) veya 587 (Submission).
• STARTTLS: Harici sunucu ile STARTTLS şifreli bağlantıyı etkinleştirir.
• Allow Insecure: Güvenilmeyen sertifikalı sunuculara bağlantıyı mümkün kılar (üretimde önerilmez).
• Auth: Kimlik doğrulama yöntemi: Login (kullanıcı adı/parola), Plain (Login'e benzer), CRAM-MD5 (challenge/response tabanlı).
• Username: Dış SMTP sunucusuna bağlanmak için kullanıcı adı.
• Password: Dış SMTP sunucusuna bağlanmak için parola.
• Return Path: Relay edilen e-posta için geri dönüş yolu (Return-Path başlığı olarak kullanılır).
• Allowed Recipients: Relay edilebilecek adres veya alan adları listesi (isteğe bağlı).
• Blocked Recipients: Relay edilmesi engellenmiş alıcı veya alan adları listesi (isteğe bağlı).
• Relay All: Seçildiğinde, Mailpit alınan tüm iletileri relay etmeye çalışır (Allowed/Blocked Recipients kurallarına tabidir).
• Relay Matching: Sadece Allowed Recipients veya Blocked Recipients kuralına uyan mesajları relay eder.

Yapılandırmayı Kaydetme

Mailpit’in ayarlarında bir değişiklik yaptıktan sonra, ekranın altındaki Kaydet düğmesine tıklamayı unutmayın.

Sıfırla (Reset) butonuna tıkladığınızda, yapılandırmaları Mailpit’in varsayılan ayarlarına döndürebilirsiniz.

Sıkça Sorulan Sorular (SSS)

• S: Uygulamamdan gönderdiğim postalar, neden Mailpit’te görünmüyor?
  • C: Uygulamanızın e-posta gönderim (genellikle SMTP host ve port) ayarlarını kontrol edin. Mailpit’in çalıştığı ServBay adresi (genellikle 127.0.0.1 veya localhost) ile SMTP portunun (varsayılan 1025) doğru seçildiğinden emin olun. Ayrıca, ServBay üzerinde Mailpit'in gerçekten çalışır durumda olup olmadığını yazılım paketleri listesinden kontrol edin.
• S: Mailpit için ayrıca SSL sertifikası yapılandırmam gerekir mi?
  • C: Hayır, gerekmez. ServBay’in güçlü PKI altyapısı sayesinde, Mailpit’in web arayüzü ile SMTP ve POP3 servislerinin STARTTLS/SSL/TLS sertifikaları otomatik olarak oluşturulur. Yalnızca isterseniz ilgili sekmelerde şifrelemeyi etkinleştirin.
• S: Mailpit web arayüzüne giriş için varsayılan kullanıcı adı ve parola nedir?
  • C: Varsayılan olarak, https://mail.servbay.host adresinden Mailpit arayüzüne girerken kullanıcı adı ve parola gerekmez. SMTP ve POP3 servislerinde de varsayılan olarak kimlik doğrulama kapalıdır. Eğer SMTP veya POP3 için giriş zorunluluğu eklemek isterseniz, ilgili sekmelerden kullanıcı adı ve parola tanımlayabilirsiniz.

Sonuç

ServBay’in entegre Mailpit paketi ile yerel bir e-posta test ortamı kurmanız oldukça kolaydır. SMTP, POP3 ve Relay ayarlarını özelleştirerek ve kullanıcı dostu web arayüzünü kullanarak, geliştirme sürecinde e-posta işlemlerinizin doğruluğunu ve verimini ciddi şekilde artırabilirsiniz.

Dikkat: Ayarları değiştirdikten sonra, değişikliklerin etkin olması için Mailpit paketini yeniden başlatmanız gerekebilir. Bunu ServBay’in yazılım paketleri yönetim arayüzünden Mailpit’i bulup, “Yeniden Başlat” butonunu tıklayarak yapabilirsiniz.