Güvenli Haber Bülteni Teslimatı için E-postayı İlet özelliğine sahip Listmonk
genel bakış
Bu kılavuz, geliştiricilere kurulum için adım adım talimatlar sağlar Liste rahibi, güçlü bir açık kaynaklı haber bülteni ve e-posta listesi yöneticisi, kullanmak için E-posta Yönlendir SMTP sağlayıcısı olarak. Bu kombinasyon, güvenli, özel ve güvenilir e-posta teslimatını garanti ederken kampanyalarınızı etkili bir şekilde yönetmenizi sağlar.
- Liste rahibi:Abone yönetimi, liste organizasyonu, kampanya oluşturma ve performans takibini gerçekleştirir.
- E-posta Yönlendir: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 olarak görev yapar.
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.
Neden Listmonk ve Forward E-posta
- Açık kaynak: Hem Listmonk hem de Forward Email'in arkasındaki ilkeler şeffaflık ve kontrolü vurgular. Listmonk'u kendiniz barındırırsınız ve verilerinizin sahibi olursunuz.
- Gizlilik Odaklı: Forward Email, gizliliği ön planda tutarak, 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 sunar; bu da onu bütçe dostu bir çözüm haline getirir.
- Ölçeklenebilirlik: Listmonk oldukça yüksek performanslıdır ve Forward Email'in altyapısı büyük ölçekte güvenilir teslimat için tasarlanmıştır.
- Geliştirici Dostu: Listmonk güçlü bir API sunar ve Forward Email basit SMTP entegrasyonu ve webhook'lar sağlar.
Ön koş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? Şuraya göz atın: önerilen VPS listesi.
- Kontrolünüzde olan bir alan adı (DNS erişimi gerekir).
- Aktif bir hesap ile E-posta Yönlendir.
- Kök veya
sudo
VPS'nize erişim. - Linux komut satırı işlemlerine ilişkin temel bilgi.
Kurulum
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ükleyin
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 dosyayı indirin docker-compose.yml
dosya.
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ın etkinleştirilmesini 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)
Alan adınızın DNS'i Cloudflare tarafından yönetiliyorsa, kolay HTTPS için proxy özelliğinden yararlanabilirsiniz.
- Nokta DNS: Bir tane oluştur
A
Listmonk alt alan adınız için Cloudflare'de kayıt oluşturun (örn.listmonk.yourdomain.com
) VPS IP adresinizi işaret ediyor. Vekalet durumu ayarlandı Vekalet edilen (turuncu bulut). - Docker Compose'u Değiştir: Düzenle
docker-compose.yml
İndirdiğiniz dosya:
Bu, Listmonk'u 80 numaralı port üzerinden dahili olarak erişilebilir hale getirir ve Cloudflare daha sonra HTTPS ile proxy yapabilir ve güvenliğini sağlayabilir.sed -i 's/9000:9000/80:9000/' docker-compose.yml
Seçenek B: Ters Proxy Kullanma (Nginx, Caddy, vb.)
Alternatif olarak, HTTPS sonlandırmayı ve Listmonk'a (varsayılan olarak 9000 numaralı portta çalışır) gelen proxy isteklerini yönetmek için VPS'inizde Nginx veya Caddy gibi ters bir proxy ayarlayabilirsiniz.
- Varsayılanı koru
ports: - "127.0.0.1:9000:9000"
içindedocker-compose.yml
Listmonk'a yalnızca yerel olarak erişilebilmesini sağlamak. - Seçtiğiniz ters proxy'yi 80 ve 443 portlarını dinleyecek, SSL sertifikası edinimini yönetecek (örneğin Let's Encrypt aracılığıyla) ve trafiği iletecek şekilde yapılandırın.
http://127.0.0.1:9000
. - 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ın
Geri dön listmonk
dizinine gidin (eğer halihazırda orada değilseniz) ve konteynerleri 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ı üzerinden Listmonk web arayüzüne erişebilmeniz gerekir (örn. https://listmonk.yourdomain.com
).
7. Listmonk'ta E-posta SMTP'sini Yönlendir'i yapılandırın
Daha sonra Listmonk'u, E-postaları İletme hesabınızı kullanarak gönderecek şekilde yapılandırın.
- E-postayı İletmede SMTP'yi Etkinleştir: SMTP kimlik bilgilerinizi Forward Email hesap panonuzda oluşturduğunuzdan emin olun. Aşağıdakileri takip edin SMTP aracılığıyla özel bir alan adıyla e-posta gönderme kılavuzunu iletin Eğer henüz yapmadıysanız.
- Listmonk'u yapılandırın: Listmonk yönetici panelinize giriş yapın.
-
Şuraya git: Ayarlar -> SMTP.
-
Listmonk, E-postayı İlet için yerleşik desteğe sahiptir. Seç İletE-posta sağlayıcı listesinden veya aşağıdaki bilgileri manuel olarak girin:
Ayar Değer Ev sahibi smtp.forwardemail.net
Liman 465
Yetkilendirme protokolü LOGIN
Kullanıcı adı İlettiğiniz E-posta SMTP kullanıcı adı Parola İlettiğiniz E-posta SMTP şifresi TLS SSL/TLS
E-postadan İstediğiniz From
adres (örneğin,newsletter@yourdomain.com
). Bu etki alanının E-postayı İlet'te yapılandırıldığından emin olun. -
Önemli: Her zaman Port'u kullan
465
ile birlikteSSL/TLS
Forward Email ile güvenli bağlantılar için. STARTTLS (port 587) kullanmayın. -
Tıklamak Kayıt etmek.
-
- 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 tıklayın Göndermek. 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 tepme 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 tepmeler hakkında bilgilendirmek için bir web kancası sağlar.
E-posta Yönlendirme Kurulumu
- Giriş yapın E-postayı İlet Panosu.
- Şuraya git: Alanlar, göndermek için kullandığınız alan adını seçin ve adresine gidin Ayarlar sayfa.
- Aşağı kaydırın Geri Dönüş Webhook URL'si bölüm.
- Aşağıdaki URL'yi girin ve değiştirin
<your_listmonk_domain>
Listmonk örneğinizin erişilebilir olduğu gerçek alan adı veya alt alan adı ile:
Örnek:https://<your_listmonk_domain>/webhooks/service/forwardemail
https://listmonk.yourdomain.com/webhooks/service/forwardemail
- Daha aşağıya doğru kaydırın Webhook İmza Yükü Doğrulama Anahtarı bölüm.
- kopya üretilen doğrulama anahtarı. Buna Listmonk'ta ihtiyacınız olacak.
- E-posta İletme alan adı ayarlarınızdaki değişiklikleri kaydedin.
Listmonk Kurulumu
- Listmonk yönetici panelinizde şuraya gidin: Ayarlar -> Geri Dönüşler.
- Olanak vermek Geri dönüş işlemeyi etkinleştir.
- Olanak vermek Geri tepme web kancalarını etkinleştir.
- Aşağı kaydırın Webhook Sağlayıcıları bölüm.
- Olanak vermek E-posta Yönlendir.
- Yapıştır Webhook İmza Yükü Doğrulama Anahtarı E-posta İletme panosundan kopyaladığınız E-postayı İlet Anahtarı alan.
- Tıklamak Kayıt etmek Sayfanın en altında.
- Geri tepme işleme artık yapılandırıldı! Forward Email, Listmonk tarafından gönderilen bir e-posta için geri tepme tespit ettiğinde, webhook aracılığıyla Listmonk örneğinize bildirimde bulunacak ve Listmonk aboneyi buna göre işaretleyecektir.
- Aşağıdaki adımları tamamlayın Test her şeyin çalıştığından emin olmak için.
Test
İşte temel Listmonk fonksiyonlarına dair kısa bir genel bakış:
Bir Posta Listesi Oluşturun
- git Listeler kenar çubuğunda.
- Tıklamak Yeni Liste.
- Ayrıntıları girin (Ad, Tür: Genel/Özel, Açıklama, Etiketler) ve Kayıt etmek.
Abone Ekle
- Şuraya gidin: Aboneler bölüm.
- Abone ekleyebilirsiniz:
- Manuel olarak: Tıklamak Yeni Abone.
- İçe aktarmak: Tıklamak Aboneleri İthalat CSV dosyasını yüklemek için.
- 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ürecini kullanın. Bunu şu şekilde yapılandırın: Ayarlar -> Katılım ve Abonelikler.
Bir Kampanya Oluşturun ve Gönderin
- git Kampanyalar -> Yeni Kampanya.
- 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. Şablon değişkenlerini şu şekilde kullanabilirsiniz:
{{ .Subscriber.Email }}
veya{{ .Subscriber.FirstName }}
. - Her zaman önce 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 tıklayın Kampanyayı Başlat Hemen göndermek veya daha sonra göndermek için planlamak.
Doğrulama
- SMTP Teslimatı: Listmonk'un SMTP ayarları sayfasını kullanarak düzenli olarak test e-postaları gönderin ve e-postaların doğru şekilde iletildiğinden emin olmak için kampanyaları test edin.
- Zıplama Yönetimi: Bilinen geçersiz bir e-posta adresine bir test kampanyası gönderin (örn.
bounce-test@yourdomain.com
(Elinizde gerçek bir tane yoksa, sonuçlar değişebilir). Kısa bir süre sonra Listmonk'ta kampanya istatistiklerini kontrol ederek geri dönüşün kayıtlı olup olmadığını görün. - E-posta Başlıkları: Şu araçları kullanın: Posta Test Cihazı veya SPF, DKIM ve DMARC'ın geçtiğini doğrulamak için e-posta başlıklarını manuel olarak inceleyin ve E-posta İletme aracılığıyla doğru kurulumu gösterin.
- E-posta Günlüklerini İlet: Teslimat sorunlarının SMTP sunucusundan kaynaklandığı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 alt bilgisinde bulabilirsiniz.
- Özel Alanlar: Özel abone alanlarını tanımlayın Ayarlar -> Abone Alanları ek verileri depolamak için.
- Web kancaları: Listmonk, geri dönüşlerin yanı sıra diğer olaylar (örneğin abonelikler) için de webhook gönderebilir ve böylece diğer sistemlerle entegrasyona olanak tanır.
Çözüm
Listmonk'un kendi kendine barındırılan gücünü Forward Email'in güvenli, gizliliğe saygılı teslimatıyla bütünleştirerek sağlam ve etik bir e-posta pazarlama platformu yaratırsınız. Yüksek teslimat ve otomatik güvenlik özelliklerinden faydalanırken hedef kitlenizin verilerinin tam mülkiyetini korursunuz.
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! 🚀