Güvenli Haber Bülteni Teslimatı için E-postayı İletme Özelliğine Sahip Listmonk
Genel Bakış
Bu kılavuz, geliştiricilere, güçlü bir açık kaynaklı bülten ve e-posta listesi yöneticisi olan Liste rahibi'ı SMTP sağlayıcısı olarak kullanmak üzere nasıl kuracaklarına dair adım adım talimatlar sunar. Bu kombinasyon, güvenli, gizli ve güvenilir e-posta teslimatı sağlarken kampanyalarınızı etkili bir şekilde yönetmenizi sağlar.
- Listmonk: Abone yönetimi, liste organizasyonu, kampanya oluşturma ve performans takibini yönetir.
- E-posta İletme: SPF, DKIM, DMARC ve TLS şifrelemesi gibi yerleşik güvenlik özellikleriyle e-postaların gerçek gönderimini yöneten güvenli SMTP sunucusu görevi görür.
Bu ikisini entegre ederek, Forward Email'in güçlü dağıtım sisteminden yararlanırken verileriniz ve altyapınız üzerinde tam kontrole sahip olursunuz.
Listmonk ve E-posta Yönlendirme Nedenleri
- Açık Kaynak: Hem Listmonk hem de Forward Email'in arkasındaki ilkeler şeffaflık ve kontrolü vurgular. Listmonk'u kendiniz barındırır ve verilerinizin sahibi olursunuz.
- Gizlilik Odaklı: Forward Email, özünde gizlilik ilkesini temel alarak, veri saklamayı en aza indirerek ve güvenli iletime odaklanarak oluşturulmuştur.
- Maliyet Etkin: Listmonk ücretsizdir ve Forward Email, cömert ücretsiz katmanlar ve uygun fiyatlı ücretli planlar sunarak bütçe dostu bir çözümdür.
- Ölçeklenebilirlik: Listmonk yüksek performanslıdır ve Forward Email'in altyapısı, ölçeklenebilir ve güvenilir teslimat için tasarlanmıştır.
- Geliştirici Dostu: Listmonk güçlü bir API sunarken, Forward Email basit SMTP entegrasyonu ve webhook'lar sağlar.
Önkoşullar
Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:
- En az 1 CPU ve 1 GB RAM'e (2 GB önerilir) sahip, güncel bir Linux dağıtımı (Ubuntu 20.04+ önerilir) çalıştıran bir Sanal Özel Sunucu (VPS).
- Bir sağlayıcıya mı ihtiyacınız var? önerilen VPS listesi'ı inceleyin.
- Kontrol ettiğiniz bir alan adı (DNS erişimi gereklidir).
- E-postayı İlet ile etkin bir hesap.
- VPS'nize kök veya
sudo
erişimi. - Linux komut satırı işlemlerine temel düzeyde aşinalık.
Kurulumu
Bu adımlar, Docker ve Docker Compose kullanarak VPS'inizde Listmonk'u kurmanıza yardımcı olacaktır.
1. Sunucunuzu Güncelleyin
Sisteminizdeki paket listesinin ve yüklü paketlerin güncel olduğundan emin olun.
sudo apt update && sudo apt upgrade -y
2. Bağımlılıkları Yükle
Docker, Docker Compose ve UFW'yi (Karmaşık Olmayan Güvenlik Duvarı) yükleyin.
sudo apt install -y docker.io docker-compose ufw
3. Listmonk Yapılandırmasını İndirin
Listmonk için bir dizin oluşturun ve resmi docker-compose.yml
dosyasını indirin.
mkdir listmonk && cd listmonk
curl -Lo docker-compose.yml https://raw.githubusercontent.com/knadh/listmonk/master/docker-compose.yml
Bu dosya Listmonk uygulama kabını ve onun gerekli PostgreSQL veritabanı kabını tanımlar.
4. Güvenlik Duvarını (UFW) Yapılandırın
Güvenlik duvarı üzerinden temel trafiğe (SSH, HTTP, HTTPS) izin verin. SSH'niz standart olmayan bir portta çalışıyorsa, buna göre ayarlayın.
sudo ufw allow ssh
sudo ufw allow http
sudo ufw allow https
sudo ufw enable
İstendiğinde güvenlik duvarını etkinleştirmeyi onaylayın.
5. HTTPS Erişimini Yapılandırın
Listmonk'u HTTPS üzerinden çalıştırmak güvenlik açısından çok önemlidir. İki temel seçeneğiniz var:
Seçenek A: Cloudflare Proxy'yi Kullanma (Basitlik İçin Önerilir)
Eğer alan adınızın DNS'i Cloudflare tarafından yönetiliyorsa, kolay HTTPS için proxy özelliğinden yararlanabilirsiniz.
- DNS Noktasını Belirle: Listmonk alt alan adınız (örneğin,
listmonk.yourdomain.com
) için Cloudflare'de VPS IP adresinize işaret eden birA
kaydı oluşturun. Proxy durumunun Proxy'lendi (turuncu bulut) olarak ayarlandığından emin olun. - Docker Compose'u Değiştir: İndirdiğiniz
docker-compose.yml
dosyasını düzenleyin:
sed -i 's/9000:9000/80:9000/' docker-compose.yml
Bu, Listmonk'u 80 numaralı bağlantı noktasından dahili olarak erişilebilir hale getirir ve Cloudflare bu bağlantı noktasını proxy olarak kullanabilir ve HTTPS ile güvenli hale getirebilir.
Seçenek B: Ters Proxy Kullanma (Nginx, Caddy, vb.)
Alternatif olarak, HTTPS sonlandırmayı ve Listmonk'a (varsayılan olarak 9000 portunda çalışır) gelen proxy isteklerini yönetmek için VPS'inizde Nginx veya Caddy gibi ters bir proxy kurabilirsiniz.
- Listmonk'un yalnızca yerel olarak erişilebilir olmasını sağlamak için
docker-compose.yml
'deki varsayılanports: - "127.0.0.1:9000:9000"
değerini koruyun. - Seçtiğiniz ters proxy'yi 80 ve 443 portlarını dinleyecek, SSL sertifika alımını yönetecek (örneğin, Let's Encrypt aracılığıyla) ve trafiği
http://127.0.0.1:9000
'ye yönlendirecek şekilde yapılandırın. - Ayrıntılı ters proxy kurulumu bu kılavuzun kapsamı dışındadır, ancak çevrimiçi olarak birçok eğitim mevcuttur.
6. Listmonk'u Başlat
listmonk
dizininize geri dönün (eğer orada değilseniz) ve kapsayıcıları ayrı modda başlatın.
cd ~/listmonk # Or the directory where you saved docker-compose.yml
docker compose up -d
Docker gerekli imajları indirecek ve Listmonk uygulamasını ve veritabanı kapsayıcılarını başlatacaktır. İlk seferde bir veya iki dakika sürebilir.
✅ Listmonk'a Erişim: Artık yapılandırdığınız etki alanı (örneğin https://listmonk.yourdomain.com
) üzerinden Listmonk web arayüzüne erişebilmeniz gerekir.
7. Listmonk'ta E-posta SMTP'sini İletmeyi Yapılandırın
Daha sonra Listmonk'u, E-postaları İletme hesabınızı kullanarak gönderecek şekilde yapılandırın.
- İletilen E-postada SMTP'yi Etkinleştirin: İletilen E-posta hesap panonuzda SMTP kimlik bilgilerinizi oluşturduğunuzdan emin olun. Henüz yapmadıysanız SMTP aracılığıyla özel bir alan adıyla e-posta gönderme kılavuzu'ı takip edin.
- Listmonk'u Yapılandırın: Listmonk yönetici panelinize giriş yapın.
-
Ayarlar -> SMTP'ye gidin.
-
Listmonk, E-postayı İlet desteğine sahiptir. Sağlayıcı listesinden E-postayı İlet'i seçin veya aşağıdaki bilgileri manuel olarak girin:
Ayar | Değer |
---|---|
Ev sahibi | smtp.forwardemail.net |
Liman | 465 |
Yetkilendirme protokolü | LOGIN |
Kullanıcı Adı | Yönlendirilen E-postanız SMTP kullanıcı adı |
Şifre | İletilecek E-postanız SMTP şifresi |
TLS | SSL/TLS |
E-postadan | İstediğiniz From adresi (örneğin, newsletter@yourdomain.com ). Bu etki alanının E-postayı İlet'te yapılandırıldığından emin olun. |
-
Önemli: E-postayı İlet ile güvenli bağlantılar için
SSL/TLS
ile birlikte daima465
Portunu kullanın. STARTTLS (port 587) kullanmayın. -
Kaydet'e tıklayın.
- Test E-postası Gönder: SMTP ayarları sayfasındaki "Test E-postası Gönder" düğmesini kullanın. Erişebileceğiniz bir alıcı adresi girin ve Gönder'e tıklayın. E-postanın alıcının gelen kutusuna ulaştığını doğrulayın.
8. Geri Dönüş İşlemeyi Yapılandırın
Geri dönme işleme, Listmonk'un teslim edilemeyen e-postaları (örneğin geçersiz adresler nedeniyle) otomatik olarak işlemesini sağlar. E-postayı İlet, Listmonk'u geri dönmeler hakkında bilgilendirmek için bir web kancası sağlar.
E-posta Yönlendirme Kurulumu
- E-posta İletme Panosu hesabınıza giriş yapın.
- Etki Alanları bölümüne gidin, gönderim için kullandığınız etki alanını seçin ve Ayarlar sayfasına gidin.
- Geri Dönen Web Kancası URL'si bölümüne gidin.
- Aşağıdaki URL'yi girin ve
<your_listmonk_domain>
adresini Listmonk örneğinizin erişilebilir olduğu gerçek etki alanı veya alt etki alanıyla değiştirin:
https://<your_listmonk_domain>/webhooks/service/forwardemail
Örnek: https://listmonk.yourdomain.com/webhooks/service/forwardemail
5. Web Kancası İmza Yükü Doğrulama Anahtarı bölümüne doğru daha da aşağı kaydırın.
6. Oluşturulan doğrulama anahtarını kopyalayın. Buna Listmonk'ta ihtiyacınız olacak.
7. Yönlendirme E-postası etki alanı ayarlarınızdaki değişiklikleri kaydedin.
Listmonk Kurulumu
- Listmonk yönetici panelinizde Ayarlar -> Geri Dönenler bölümüne gidin.
- Geri Dönme İşlemeyi Etkinleştir'i etkinleştirin.
- Geri Dönme Web Kancalarını Etkinleştir'i etkinleştirin.
- Web Kancası Sağlayıcıları bölümüne gidin.
- E-postayı İlet'i etkinleştirin.
- E-posta İlet panosundan kopyaladığınız Web Kancası İmza Yükü Doğrulama Anahtarını E-posta İlet Anahtarı alanına yapıştırın.
- Sayfanın altındaki Kaydet'e tıklayın.
- Geri Dönme İşleme artık yapılandırıldı! E-posta İlet, Listmonk tarafından gönderilen bir e-posta için geri dönme tespit ettiğinde, web kancası aracılığıyla Listmonk örneğinize bildirimde bulunur ve Listmonk aboneyi buna göre işaretler.
- Her şeyin çalıştığından emin olmak için Test'daki aşağıdaki adımları tamamlayın.
{#testing} test ediliyor
İşte Listmonk'un temel işlevlerine dair kısa bir genel bakış:
Bir Posta Listesi Oluşturun
- Kenar çubuğundaki Listeler'e gidin.
- Yeni Liste'ye tıklayın.
- Ayrıntıları (Ad, Tür: Genel/Özel, Açıklama, Etiketler) doldurun ve Kaydet'e tıklayın.
Abone Ekle
- Aboneler bölümüne gidin.
- Aboneleri şu şekilde ekleyebilirsiniz:
- Manuel: Yeni Abone'ye tıklayın.
- İçe Aktar: Bir CSV dosyası yüklemek için Aboneleri İçe Aktar'a tıklayın.
- API: Programatik eklemeler için Listmonk API'sini kullanın.
- Oluşturma veya içe aktarma sırasında aboneleri bir veya daha fazla listeye atayın.
- En İyi Uygulama: Çift katılım süreci kullanın. Bunu Ayarlar -> Katılım ve Abonelikler bölümünden yapılandırın.
Bir Kampanya Oluşturun ve Gönderin
- Kampanyalar -> Yeni Kampanya'ya gidin.
- Kampanya ayrıntılarını girin (Ad, Konu, Kimden E-postası, Gönderilecek Liste(ler)).
- İçerik türünüzü seçin (Zengin Metin/HTML, Düz Metin, Ham HTML).
- E-posta içeriğinizi oluşturun.
{{ .Subscriber.Email }}
veya{{ .Subscriber.FirstName }}
gibi şablon değişkenlerini kullanabilirsiniz. - Önce mutlaka bir test e-postası gönderin! E-postayı gelen kutunuzda önizlemek için "Test Gönder" seçeneğini kullanın.
- Memnun kaldığınızda, hemen göndermek veya daha sonra göndermek için Kampanyayı Başlat'a tıklayın.
Doğrulama
- SMTP Teslimatı: Listmonk'un SMTP ayarları sayfası üzerinden düzenli olarak test e-postaları gönderin ve e-postaların doğru şekilde teslim edildiğinden emin olmak için kampanyaları test edin.
- Geri Dönen İleti Yönetimi: Bilinen geçersiz bir e-posta adresine (örneğin, elinizde gerçek bir e-posta adresi yoksa
bounce-test@yourdomain.com
adresine, ancak sonuçlar değişiklik gösterebilir) bir test kampanyası gönderin. Geri dönmenin kaydedilip kaydedilmediğini görmek için kısa bir süre sonra Listmonk'taki kampanya istatistiklerini kontrol edin. - E-posta Başlıkları: SPF, DKIM ve DMARC'nin geçtiğini ve E-posta İletme aracılığıyla doğru kurulumu gösterdiğini doğrulamak için Posta Test Cihazı gibi araçları kullanın veya e-posta başlıklarını manuel olarak inceleyin.
- İletilen E-posta Günlükleri: SMTP sunucusundan kaynaklanan teslimat sorunlarından şüpheleniyorsanız, E-posta İletme panosu günlüklerinizi kontrol edin.
Geliştirici Notları
- Şablonlama: Listmonk, Go'nun şablonlama motorunu kullanır. Gelişmiş kişiselleştirme için belgelerini inceleyin:
{{ .Subscriber.Attribs.your_custom_field }}
. - API: Listmonk, listeleri, aboneleri, kampanyaları, şablonları ve daha fazlasını yönetmek için kapsamlı bir REST API sağlar. API belgeleri bağlantısını Listmonk örneğinizin altbilgisinde bulabilirsiniz.
- Özel Alanlar: Ek verileri depolamak için Ayarlar -> Abone Alanları altında özel abone alanları tanımlayın.
- Web Kancaları: Listmonk, geri dönen iletilerin yanı sıra diğer olaylar (örneğin abonelikler) için de web kancaları göndererek diğer sistemlerle entegrasyona olanak tanır.
Sonuç
Listmonk'un kendi kendine barındırılan gücünü, Forward Email'in güvenli ve gizliliğe saygılı teslimatıyla birleştirerek, güçlü ve etik bir e-posta pazarlama platformu oluşturursunuz. Hedef kitlenizin verilerinin tam mülkiyetini korurken, yüksek teslimat oranı ve otomatik güvenlik özelliklerinden yararlanırsınız.
Bu kurulum, açık kaynaklı yazılım ve kullanıcı gizliliği ilkeleriyle mükemmel bir şekilde uyumlu, tescilli e-posta hizmetlerine ölçeklenebilir, uygun maliyetli ve geliştirici dostu bir alternatif sunar.
Mutlu Gönderiler! 🚀