Listmonk s přeposíláním e-mailů pro bezpečné doručování newsletterů

Tato příručka poskytuje vývojářům podrobné pokyny k nastavení Listmonk, výkonný open-source správce newsletterů a mailing listů, k použití Přeposlat e-mail jako svého poskytovatele SMTP. Tato kombinace vám umožňuje efektivně spravovat vaše kampaně a zároveň zajistit bezpečné, soukromé a spolehlivé doručování e-mailů.

  • ListmonkZabývá se správou odběratelů, organizací seznamů, vytvářením kampaní a sledováním výkonu.
  • Přeposlat e-mailFunguje jako zabezpečený SMTP server a zpracovává skutečné odesílání e-mailů pomocí vestavěných bezpečnostních funkcí, jako je SPF, DKIM, DMARC a šifrování TLS.

Integrací těchto dvou služeb si zachováte plnou kontrolu nad svými daty a infrastrukturou a zároveň využijete robustní systém doručování Forward Email.

  • Open SourceListmonk i principy přeposílání e-mailů kladou důraz na transparentnost a kontrolu. Listmonk hostujete sami a vlastníte svá data.
  • Zaměřeno na soukromíPřeposílání e-mailů je postaveno s ohledem na soukromí, minimalizuje uchovávání dat a zaměřuje se na bezpečný přenos.
  • Cenově výhodnéListmonk je zdarma a Forward Email nabízí štědré bezplatné balíčky a cenově dostupné placené tarify, což z něj činí cenově dostupné řešení.
  • ŠkálovatelnostListmonk je vysoce výkonný a infrastruktura Forward Email je navržena pro spolehlivé doručování ve velkém měřítku.
  • Vhodné pro vývojářeListmonk nabízí robustní API a Forward Email poskytuje přímočarou integraci SMTP a webhooky.

Než začnete, ujistěte se, že máte následující:

  • Virtuální privátní server (VPS) s aktuální distribucí Linuxu (doporučeno Ubuntu 20.04+) s alespoň 1 CPU a 1 GB RAM (doporučeno 2 GB).
  • Doménové jméno, které spravujete (vyžaduje přístup k DNS).
  • Aktivní účet u Přeposlat e-mail.
  • Kořen nebo sudo přístup k vašemu VPS.
  • Základní znalost operací příkazového řádku v Linuxu.

Tyto kroky vás provedou instalací Listmonku pomocí Dockeru a Docker Compose na vašem VPS.

1. Aktualizujte svůj server

Ujistěte se, že seznam balíčků ve vašem systému a nainstalované balíčky jsou aktuální.

sudo apt update && sudo apt upgrade -y

2. Instalace závislostí

Nainstalujte Docker, Docker Compose a UFW (nekomplikovaný firewall).

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

3. Stáhněte si konfiguraci Listmonku

Vytvořte adresář pro Listmonk a stáhněte si oficiální verzi. docker-compose.yml soubor.

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

Tento soubor definuje kontejner aplikace Listmonk a jeho požadovaný kontejner databáze PostgreSQL.

4. Konfigurace firewallu (UFW)

Povolte nezbytný provoz (SSH, HTTP, HTTPS) přes firewall. Pokud váš SSH běží na nestandardním portu, upravte nastavení.

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

Po zobrazení výzvy potvrďte povolení brány firewall.

5. Konfigurace přístupu HTTPS

Spuštění Listmonku přes HTTPS je pro bezpečnost zásadní. Máte dvě hlavní možnosti:

Pokud DNS vaší domény spravuje Cloudflare, můžete pro snadné HTTPS využít jejich funkci proxy.

  1. Bod DNSVytvořte A záznam v Cloudflare pro vaši subdoménu Listmonk (např. listmonk.yourdomain.com) ukazující na IP adresu vašeho VPS. Ujistěte se, že Stav proxy serveru je nastaveno na Proxy (oranžový mrak).
  2. Upravit Docker ComposeUpravit docker-compose.yml soubor, který jste stáhli: 
    sed -i 's/9000:9000/80:9000/' docker-compose.yml
    Díky tomu je Listmonk interně přístupný na portu 80, který pak Cloudflare může proxyovat a zabezpečit pomocí HTTPS.

Možnost B: Použití reverzní proxy (Nginx, Caddy atd.)

Alternativně si můžete na svém VPS nastavit reverzní proxy, jako je Nginx nebo Caddy, pro zpracování HTTPS ukončení a proxy požadavků na Listmonk (ve výchozím nastavení běží na portu 9000).

  • Ponechat výchozí nastavení ports: - "127.0.0.1:9000:9000" v docker-compose.yml aby byl Listmonk přístupný pouze lokálně.
  • Nakonfigurujte zvolenou reverzní proxy tak, aby naslouchala na portech 80 a 443, zpracovávala získávání SSL certifikátů (např. přes Let's Encrypt) a přesměrovávala provoz na http://127.0.0.1:9000.
  • Podrobné nastavení reverzní proxy přesahuje rámec této příručky, ale online je k dispozici mnoho návodů.

6. Spusťte Listmonk

Přejděte zpět do svého listmonk adresář (pokud tam ještě nejste) a spusťte kontejnery v odděleném režimu.

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

Docker stáhne potřebné obrazy a spustí aplikaci Listmonk a databázové kontejnery. Poprvé to může trvat minutu nebo dvě.

✅ Přístup k ListmonkuNyní byste měli mít přístup k webovému rozhraní Listmonk prostřednictvím domény, kterou jste nakonfigurovali (např. https://listmonk.yourdomain.com).

7. Konfigurace SMTP pro přeposílání e-mailů v Listmonku

Dále nakonfigurujte Listmonk tak, aby odesílal e-maily pomocí vašeho účtu Forward Email.

  1. Povolte SMTP v Forward Email: Ujistěte se, že jste si v řídicím panelu účtu pro přeposílání e-mailů vygenerovali přihlašovací údaje SMTP. Postupujte podle pokynů. Průvodce přesměrováním e-mailů pro odesílání e-mailů s vlastní doménou přes SMTP pokud jste tak ještě neučinili.
  2. Konfigurace ListmonkuPřihlaste se do administračního panelu Listmonk.

    • Přejít na Nastavení -> SMTP.

    • Listmonk má vestavěnou podporu pro přeposílání e-mailů. Vyberte Přeposlat e-mail ze seznamu poskytovatelů nebo ručně zadejte následující údaje:

      NastaveníHodnota
      Hostitelsmtp.forwardemail.net
      Přístav465
      Ověřovací protokolLOGIN
      Uživatelské jménoVáš přeposílaný e-mail Uživatelské jméno SMTP
      HesloVáš přeposílaný e-mail SMTP heslo
      TLSSSL/TLS
      Z e-mailuVaše přání From adresa (např. newsletter@yourdomain.com). Ujistěte se, že je tato doména nakonfigurována v části Přeposílání e-mailů.

    • DůležitéVždy používat port 465 s SSL/TLS pro zabezpečená připojení s funkcí Forward Email. Nepoužívejte STARTTLS (port 587).

    • Klikněte Uložit.

  3. Odeslat zkušební e-mail: Použijte tlačítko „Odeslat testovací e-mail“ na stránce nastavení SMTP. Zadejte adresu příjemce, ke které máte přístup, a klikněte na PoslatOvěřte, zda e-mail dorazil do schránky příjemce.

8. Konfigurace zpracování odražených zpráv

Zpracování nedoručených e-mailů umožňuje Listmonku automaticky zpracovat e-maily, které nemohly být doručeny (např. kvůli neplatným adresám). Funkce Forward Email poskytuje webhook, který Listmonk upozorní na nedoručené e-maily.

Nastavení přeposílání e-mailů

  1. Přihlaste se do svého Panel pro přeposílání e-mailů.
  2. Přejít na domény, vyberte doménu, kterou používáte pro odesílání, a přejděte na její Nastavení strana.
  3. Přejděte dolů k Adresa URL webhooku pro odražení sekce.
  4. Zadejte následující URL adresu a nahraďte ji <your_listmonk_domain> se skutečnou doménou nebo subdoménou, kde je vaše instance Listmonk přístupná: 
    https://<your_listmonk_domain>/webhooks/service/forwardemail
    Příklad: https://listmonk.yourdomain.com/webhooks/service/forwardemail
  5. Přejděte dále dolů k Ověřovací klíč pro podpis podpisu webhooku sekce.
  6. Kopie vygenerovaný ověřovací klíč. Budete ho potřebovat v Listmonku.
  7. Uložte změny v nastavení domény pro přeposílání e-mailů.

Nastavení Listmonku

  1. V administračním panelu Listmonk přejděte na Nastavení -> Odmrštění.
  2. Umožnit Povolit zpracování bounce.
  3. Umožnit Povolit bounce webhooky.
  4. Přejděte dolů k Poskytovatelé webhooků sekce.
  5. Umožnit Přeposlat e-mail.
  6. Vložit Ověřovací klíč pro podpis podpisu webhooku zkopírovali jste z řídicího panelu Přeposílat e-maily do Klíč pro předání e-mailu pole.
  7. Klikněte Uložit ve spodní části stránky.
  8. Zpracování nedoručených e-mailů je nyní nakonfigurováno! Když funkce Forward Email detekuje nedoručený e-mail odeslaný službou Listmonk, upozorní vaši instanci Listmonk prostřednictvím webhooku a Listmonk odběratele odpovídajícím způsobem označí.
  9. Dokončete níže uvedené kroky v Testování aby se ujistilo, že všechno funguje.

Zde je rychlý přehled základních funkcí Listmonku:

Vytvořte seznam adresátů

  • Přejít na Seznamy v postranním panelu.
  • Klikněte Nový seznam.
  • Vyplňte údaje (Název, Typ: Veřejné/Soukromé, Popis, Štítky) a Uložit.

Přidat odběratele

  • Přejděte na Předplatitelé sekce.
  • Můžete přidat odběratele:
    • RučněKlikněte Nový předplatitel.
    • ImportovatKlikněte Importovat odběratele nahrát soubor CSV.
    • APIPro programové doplňování použijte API Listmonk.
  • Při vytváření nebo importu přiřaďte odběratele k jednomu nebo více seznamům.
  • Nejlepší praxePoužijte proces dvojitého přihlášení. Nakonfigurujte to v části Nastavení -> Přihlášení k odběru a předplatné.

Vytvořte a odešlete kampaň

  • Přejít na Kampaně -> Nová kampaň.
  • Vyplňte podrobnosti kampaně (jméno, předmět, e-mail odesílatele, seznam(y) pro odeslání).
  • Vyberte typ obsahu (Rich Text/HTML, Prostý text, Neupravený HTML).
  • Vytvořte obsah e-mailu. Můžete použít proměnné šablony, jako například {{ .Subscriber.Email }} nebo {{ .Subscriber.FirstName }}.
  • Vždy nejdříve odešlete zkušební e-mail! Pro zobrazení náhledu e-mailu ve vaší schránce použijte možnost „Odeslat test“.
  • Jakmile budete spokojeni, klikněte Spustit kampaň odeslat ihned nebo naplánovat na později.

  • Doručování SMTPPravidelně odesílejte testovací e-maily prostřednictvím stránky nastavení SMTP v Listmonku a testujte kampaně, abyste zajistili správné doručování e-mailů.
  • Ovládání odrážekOdeslat testovací kampaň na známou neplatnou e-mailovou adresu (např. bounce-test@yourdomain.com (pokud nemáte po ruce skutečný, výsledky se však mohou lišit). Po krátké době zkontrolujte statistiky kampaně v Listmonku, zda došlo k opuštění.
  • Záhlaví e-mailůPoužívejte nástroje jako Tester pošty nebo ručně zkontrolujte záhlaví e-mailů a ověřte, zda SPF, DKIM a DMARC procházejí, což indikuje správné nastavení prostřednictvím přeposílání e-mailů.
  • Protokoly přeposílání e-mailůPokud máte podezření, že problémy s doručováním pocházejí ze serveru SMTP, zkontrolujte protokoly řídicího panelu pro přeposílání e-mailů.

  • ŠablonyListmonk používá šablonovací engine Go. Pro pokročilou personalizaci si prohlédněte jeho dokumentaci: {{ .Subscriber.Attribs.your_custom_field }}.
  • APIListmonk poskytuje komplexní REST API pro správu seznamů, odběratelů, kampaní, šablon a dalších funkcí. Odkaz na dokumentaci k API najdete v zápatí vaší instance Listmonk.
  • Vlastní poleDefinujte vlastní pole pro odběratele v části Nastavení -> Pole odběratele pro ukládání dalších dat.
  • WebhookyKromě nedoručených zpráv může Listmonk odesílat webhooky i pro další události (např. předplatné), což umožňuje integraci s jinými systémy.

Integrací samohostovaného serveru Listmonk s bezpečným a soukromí respektujícím doručováním Forward Email vytvoříte robustní a etickou platformu pro e-mailový marketing. Zachováváte si plné vlastnictví dat o svém publiku a zároveň těžíte z vysoké doručitelnosti a automatizovaných bezpečnostních funkcí.

Toto nastavení poskytuje škálovatelnou, cenově efektivní a pro vývojáře přátelskou alternativu k proprietárním e-mailovým službám, což je dokonale v souladu s étosem open source softwaru a ochrany soukromí uživatelů.

Šťastné odesílání! 🚀