Listmonk e-mail továbbítással a biztonságos hírlevélküldéshez

Ez az útmutató lépésről lépésre bemutatja a fejlesztőknek a beállítást. Listmonk, egy hatékony, nyílt forráskódú hírlevél- és levelezőlista-kezelő, amelyet használni lehet Továbbító e-mail mint SMTP-szolgáltatóját. Ez a kombináció lehetővé teszi kampányai hatékony kezelését, miközben biztosítja a biztonságos, privát és megbízható e-mail-kézbesítést.

  • Listmonk: Kezeli az előfizetők kezelését, a listák szervezését, a kampányok létrehozását és a teljesítménykövetést.
  • Továbbító e-mailBiztonságos SMTP-kiszolgálóként működik, és beépített biztonsági funkciókkal, például SPF, DKIM, DMARC és TLS titkosítással kezeli az e-mailek tényleges küldését.

E kettő integrálásával teljes mértékben kézben tarthatod az adataid és az infrastruktúrád, miközben kihasználod a Forward Email robusztus kézbesítési rendszerét.

  • Nyílt forráskódMind a Listmonk, mind a Forward Email mögött álló alapelvek hangsúlyozzák az átláthatóságot és az ellenőrzést. Ön a Listmonk tárhelyszolgáltatója, az adatainak tulajdonosa.
  • Adatvédelem-központúA Forward Email az adatvédelemre összpontosít, minimalizálja az adatmegőrzést és a biztonságos átvitelre összpontosít.
  • KöltséghatékonyA Listmonk ingyenes, a Forward Email pedig nagylelkű ingyenes szinteket és megfizethető fizetős csomagokat kínál, így ez egy költségvetésbarát megoldás.
  • MéretezhetőségA Listmonk nagy teljesítményű, a Forward Email infrastruktúrája pedig a nagy léptékű, megbízható kézbesítésre lett tervezve.
  • FejlesztőbarátA Listmonk robusztus API-t kínál, a Forward Email pedig egyszerű SMTP-integrációt és webhookokat biztosít.

Mielőtt elkezdené, győződjön meg arról, hogy a következőkkel rendelkezik:

  • Egy virtuális magánszerver (VPS), amelyen egy újabb Linux disztribúció fut (Ubuntu 20.04+ ajánlott), legalább 1 CPU-val és 1 GB RAM-mal (2 GB ajánlott).
  • Egy Ön által felügyelt domain név (DNS hozzáférés szükséges).
  • Egy aktív fiók a következővel: Továbbító e-mail.
  • Gyökér vagy sudo hozzáférés a VPS-hez.
  • Alapfokú jártasság a Linux parancssori műveletekben.

Ezek a lépések végigvezetnek a Listmonk Docker és Docker Compose használatával történő telepítésén a VPS-eden.

1. Frissítse a szerverét

Győződjön meg róla, hogy a rendszer csomaglistája és a telepített csomagok naprakészek.

sudo apt update && sudo apt upgrade -y

2. Függőségek telepítése

Telepítse a Dockert, a Docker Compose-t és az UFW-t (Uncomplicated Firewall).

sudo apt install -y docker.io docker-compose ufw

3. Töltse le a Listmonk konfigurációját

Hozz létre egy könyvtárat a Listmonk számára, és töltsd le a hivatalos docker-compose.yml fájl.

mkdir listmonk && cd listmonk
curl -Lo docker-compose.yml https://raw.githubusercontent.com/knadh/listmonk/master/docker-compose.yml

Ez a fájl definiálja a Listmonk alkalmazáskonténert és a hozzá szükséges PostgreSQL adatbáziskonténert.

4. Tűzfal (UFW) konfigurálása

Engedélyezd a létfontosságú forgalmat (SSH, HTTP, HTTPS) a tűzfalon keresztül. Ha az SSH-d nem szabványos porton fut, ennek megfelelően módosítsd a beállítást.

sudo ufw allow ssh
sudo ufw allow http
sudo ufw allow https
sudo ufw enable

Amikor a rendszer kéri, erősítse meg a tűzfal engedélyezését.

5. HTTPS hozzáférés konfigurálása

A Listmonk HTTPS-en keresztüli futtatása kulcsfontosságú a biztonság szempontjából. Két fő lehetőséged van:

Ha a domain DNS-ét a Cloudflare kezeli, kihasználhatja a proxy funkciójukat az egyszerű HTTPS-hez.

  1. Pont DNS: Hozz létre egy A rekord a Cloudflare-ben a Listmonk aldomainhez (pl. listmonk.yourdomain.com) a VPS IP-címére mutat. Győződjön meg arról, hogy a Proxy állapota erre van beállítva Meghatalmazott (narancssárga felhő).
  2. Docker Composite módosítása: Szerkeszd a docker-compose.yml letöltött fájl: 
    sed -i 's/9000:9000/80:9000/' docker-compose.yml
    Ezáltal a Listmonk belsőleg elérhető a 80-as porton, amelyet a Cloudflare ezután HTTPS-sel tud proxyzni és biztonságossá tenni.

B. lehetőség: Fordított proxy használata (Nginx, Caddy stb.)

Alternatív megoldásként beállíthat egy fordított proxyt, például az Nginx-et vagy a Caddy-t a VPS-én, hogy kezelje a HTTPS megszakítását és a Listmonk felé irányuló proxy kéréseket (alapértelmezés szerint a 9000-es porton fut).

  • Tartsa meg az alapértelmezett értéket ports: - "127.0.0.1:9000:9000" ban docker-compose.yml hogy a Listmonk csak helyben legyen elérhető.
  • Konfigurálja a kiválasztott fordított proxyt úgy, hogy a 80-as és 443-as portokon figyeljen, kezelje az SSL-tanúsítványok beszerzését (pl. a Let's Encrypt segítségével), és továbbítsa a forgalmat ide: http://127.0.0.1:9000.
  • A részletes fordított proxy beállítás meghaladja ennek az útmutatónak a kereteit, de számos oktatóanyag elérhető online.

6. Indítsa el a Listmonkot

Navigáljon vissza a listmonk könyvtárba (ha még nem vagy ott), és indítsd el a konténereket leválasztott módban.

cd ~/listmonk # Or the directory where you saved docker-compose.yml
docker compose up -d

A Docker letölti a szükséges képeket, és elindítja a Listmonk alkalmazást és az adatbázis-tárolókat. Ez elsőre eltarthat egy-két percig.

✅ Hozzáférés a ListmonkhozMost már hozzáférhetsz a Listmonk webes felületéhez a beállított domainen keresztül (pl. https://listmonk.yourdomain.com).

7. Konfigurálja az e-mail továbbításának SMTP-jét a Listmonkban

Ezután konfigurálja a Listmonkot, hogy e-maileket küldjön a Forward Email fiókjával.

  1. Engedélyezze az SMTP-t az E-mail továbbításbanGyőződjön meg róla, hogy SMTP hitelesítő adatokat generált az E-mail továbbítása fiók irányítópultján. Kövesse a következőt: E-mail továbbítási útmutató egyéni domainnel történő e-mail küldéséhez SMTP-n keresztül ha még nem tetted meg.
  2. Listmonk konfigurálásaJelentkezz be a Listmonk adminisztrációs felületére.

    • Navigálás ide: Beállítások -> SMTP.

    • A Listmonk beépített támogatással rendelkezik az e-mailek továbbításához. Válassza ki. E-mail továbbítása a szolgáltatói listából, vagy adja meg manuálisan a következő adatokat:

      BeállításÉrték
      Házigazdasmtp.forwardemail.net
      Kikötő465
      Auth protokollLOGIN
      FelhasználónévTovábbított e-mail címed SMTP felhasználónév
      JelszóTovábbított e-mail címed SMTP jelszó
      TLSSSL/TLS
      E-mailbőlA kívánt From cím (pl. newsletter@yourdomain.com). Győződjön meg arról, hogy ez a domain konfigurálva van az E-mail továbbítása részben.

    • FontosMindig a portot használja 465 val vel SSL/TLS Biztonságos kapcsolatokhoz az e-mail továbbításával. Ne használja a STARTTLS-t (587-es port).

    • Kattintson Megment.

  3. Teszt e-mail küldése: Használja a „Teszt e-mail küldése” gombot az SMTP beállítások oldalán. Adjon meg egy olyan címzett címét, amelyhez hozzáfér, majd kattintson a gombra. ElküldEllenőrizze, hogy az e-mail megérkezett-e a címzett postaládájába.

8. A visszapattanás-feldolgozás konfigurálása

A visszapattanó levelek feldolgozása lehetővé teszi a Listmonk számára, hogy automatikusan kezelje a kézbesíthetetlen e-maileket (pl. érvénytelen címek miatt). A Forward Email egy webhookot biztosít, amely értesíti a Listmonkot a visszapattanásokról.

E-mail továbbításának beállítása

  1. Jelentkezzen be a E-mail továbbítási irányítópult.
  2. Navigálás ide: Domainek, válassza ki a küldéshez használt domaint, és lépjen a hozzá tartozó Beállítások oldalon.
  3. Görgessen le a Visszapattanó Webhook URL szakasz.
  4. Írja be a következő URL-címet, a következő helyett: <your_listmonk_domain> a Listmonk példányod elérhetőségével rendelkező tényleges domainnel vagy aldomainnel: 
    https://<your_listmonk_domain>/webhooks/service/forwardemail
    Példa: https://listmonk.yourdomain.com/webhooks/service/forwardemail
  5. Görgess lejjebb a Webhook Signature Payload Verification Key szakasz.
  6. Másolat a generált ellenőrző kulcs. Erre szükséged lesz a Listmonkban.
  7. Mentse el a módosításokat az E-mail továbbítása domainbeállításaiban.

Listmonk beállítása

  1. A Listmonk adminisztrációs felületén lépjen a következőhöz: Beállítások -> Visszapattanások.
  2. Engedélyezés Visszapattanási feldolgozás engedélyezése.
  3. Engedélyezés Visszapattanó webhook engedélyezése.
  4. Görgessen le a Webhook-szolgáltatók szakasz.
  5. Engedélyezés Továbbító e-mail.
  6. Illessze be a Webhook Signature Payload Verification Key az E-mail továbbítása irányítópultról bemásoltad a E-mail továbbítási kulcs mező.
  7. Kattintson Megment az oldal alján.
  8. A visszapattanás feldolgozása mostantól konfigurálva van! Amikor a Forward Email funkció visszapattanást észlel a Listmonk által küldött e-mailben, értesíti a Listmonk példányt a webhookon keresztül, és a Listmonk ennek megfelelően megjelöli a feliratkozót.
  9. Végezze el az alábbi lépéseket a Tesztelés hogy minden működjön.

Íme egy gyors áttekintés a Listmonk alapvető függvényeiről:

Hozzon létre egy levelezőlistát

  • Menj Listák az oldalsávban.
  • Kattintson Új lista.
  • Töltse ki az adatokat (Név, Típus: Nyilvános/Privát, Leírás, Címkék) és Megment.

Előfizetők hozzáadása

  • Navigáljon a következőhöz: Előfizetők szakasz.
  • Feliratkozókat adhatsz hozzá:
    • ManuálisanKattintás Új előfizető.
    • ImportálásKattintás Előfizetők importálása CSV fájl feltöltéséhez.
    • API: Használja a Listmonk API-t programozott kiegészítésekhez.
  • Rendeljen feliratkozókat egy vagy több listához létrehozás vagy importálás során.
  • Legjobb gyakorlat: Használjon dupla jóváhagyási folyamatot. Konfigurálja ezt a következő alatt: Beállítások -> Feliratkozás és előfizetések.

Kampány létrehozása és elküldése

  • Menj Kampányok -> Új kampány.
  • Add meg a kampány részleteit (Név, Tárgy, Feladó e-mail címe, Címzett lista(k).
  • Válaszd ki a tartalom típusát (Rich Text/HTML, Plain Text, Raw HTML).
  • Írd meg az e-mail tartalmát. Használhatsz sablonváltozókat, például {{ .Subscriber.Email }} vagy {{ .Subscriber.FirstName }}.
  • Mindig küldj először egy teszt e-mailt! A „Teszt küldése” opcióval megtekintheti az e-mail előnézetét a beérkező levelek mappájában.
  • Ha elégedett vagy, kattints Kampány indítása azonnali küldéshez vagy későbbre ütemezéshez.

  • SMTP kézbesítésRendszeresen küldjön teszt e-maileket a Listmonk SMTP beállítási oldalán keresztül, és teszteljen kampányokat az e-mailek megfelelő kézbesítésének biztosítása érdekében.
  • Pattanáskezelés: Küldjön egy tesztkampányt egy ismert érvénytelen e-mail címre (pl. bounce-test@yourdomain.com ha nincs kéznél igazi, bár az eredmények eltérőek lehetnek). Kis idő múlva ellenőrizd a Listmonk kampánystatisztikáit, hogy regisztrálva van-e a visszapattanás.
  • E-mail fejlécekHasználjon olyan eszközöket, mint a Mail Tester vagy manuálisan ellenőrizze az e-mail fejléceket, hogy az SPF, DKIM és DMARC átmenjen-e, jelezve a megfelelő beállításokat az e-mail továbbítása során.
  • E-mail továbbítási naplók: Ellenőrizze az E-mail továbbítása irányítópultjának naplóit, ha az SMTP-kiszolgálótól eredő kézbesítési problémákra gyanakszik.

  • SablonozásA Listmonk a Go sablonkészítő motorját használja. A haladó személyre szabáshoz tekintse meg a dokumentációját: {{ .Subscriber.Attribs.your_custom_field }}.
  • APIA Listmonk átfogó REST API-t biztosít listák, feliratkozók, kampányok, sablonok és egyebek kezeléséhez. Az API dokumentációs linkjét a Listmonk példányod láblécében találod.
  • Egyéni mezők: Egyéni feliratkozói mezők meghatározása a következő alatt: Beállítások -> Előfizetői mezők további adatok tárolására.
  • WebhookokA visszapattanásokon kívül a Listmonk más eseményekhez (pl. feliratkozásokhoz) is képes webhookokat küldeni, lehetővé téve az integrációt más rendszerekkel.

A Listmonk saját tárhelyen futó erejének és a Forward Email biztonságos, adatvédelmet tiszteletben tartó kézbesítésének integrálásával egy robusztus és etikus e-mail marketing platformot hozhat létre. A közönségadatok feletti teljes tulajdonjogot fenntartja, miközben a magas kézbesítési hatékonyság és az automatizált biztonsági funkciók előnyeit élvezi.

Ez a beállítás egy skálázható, költséghatékony és fejlesztőbarát alternatívát kínál a zárt e-mail szolgáltatásokkal szemben, tökéletesen illeszkedve a nyílt forráskódú szoftverek és a felhasználói adatvédelem szellemiségéhez.

Jó küldést! 🚀