Listmonk met Forward Email voor veilige nieuwsbriefbezorging

Deze handleiding biedt ontwikkelaars stapsgewijze instructies voor het instellen Listmonk, een krachtige open-source nieuwsbrief- en mailinglijstbeheerder, te gebruiken E-mail doorsturen als SMTP-provider. Deze combinatie stelt u in staat uw campagnes effectief te beheren en tegelijkertijd veilige, privé en betrouwbare e-mailbezorging te garanderen.

  • Listmonk: Beheert abonnementen, organiseert lijsten, maakt campagnes en volgt prestaties.
  • E-mail doorsturen:Fungeert als beveiligde SMTP-server en verwerkt de daadwerkelijke verzending van e-mails met ingebouwde beveiligingsfuncties zoals SPF, DKIM, DMARC en TLS-encryptie.

Door deze twee te integreren, behoudt u de volledige controle over uw gegevens en infrastructuur, terwijl u tegelijkertijd gebruikmaakt van het robuuste bezorgsysteem van Forward Email.

  • Open source: Zowel Listmonk als de principes achter Forward Email benadrukken transparantie en controle. Je host Listmonk zelf en bent eigenaar van je data.
  • Privacygericht:Forward Email is ontworpen met privacy als uitgangspunt, waarbij gegevensretentie tot een minimum wordt beperkt en de nadruk ligt op veilige verzending.
  • Kosteneffectief: Listmonk is gratis en Forward Email biedt ruime gratis abonnementen en betaalbare betaalde abonnementen, wat dit een budgetvriendelijke oplossing maakt.
  • Schaalbaarheid:Listmonk levert zeer hoge prestaties en de infrastructuur van Forward Email is ontworpen voor betrouwbare levering op schaal.
  • Ontwikkelaarsvriendelijk:Listmonk biedt een robuuste API en Forward Email biedt eenvoudige SMTP-integratie en webhooks.

Voordat u begint, moet u ervoor zorgen dat u over het volgende beschikt:

  • Een Virtual Private Server (VPS) met een recente Linux-distributie (Ubuntu 20.04+ aanbevolen) met minimaal 1 CPU en 1 GB RAM (2 GB aanbevolen).
  • Een domeinnaam die u beheert (DNS-toegang vereist).
  • Een actieve rekening met E-mail doorsturen.
  • Wortel of sudo toegang tot uw VPS.
  • Basiskennis van Linux-opdrachtregelbewerkingen.

Deze stappen begeleiden u bij het installeren van Listmonk met behulp van Docker en Docker Compose op uw VPS.

1. Werk uw server bij

Zorg ervoor dat de pakketlijst van uw systeem en de geïnstalleerde pakketten up-to-date zijn.

sudo apt update && sudo apt upgrade -y

2. Afhankelijkheden installeren

Installeer Docker, Docker Compose en UFW (Uncomplicated Firewall).

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

3. Download Listmonk-configuratie

Maak een directory voor Listmonk en download de officiële docker-compose.yml bestand.

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

Dit bestand definieert de Listmonk-toepassingscontainer en de vereiste PostgreSQL-databasecontainer.

4. Firewall configureren (UFW)

Laat essentieel verkeer (SSH, HTTP, HTTPS) door de firewall. Als uw SSH op een niet-standaardpoort draait, pas dit dan aan.

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

Bevestig dat u de firewall wilt inschakelen wanneer u daarom wordt gevraagd.

5. HTTPS-toegang configureren

Het is cruciaal voor de beveiliging om Listmonk via HTTPS te gebruiken. Je hebt twee primaire opties:

Als de DNS van uw domein wordt beheerd door Cloudflare, kunt u hun proxyfunctie gebruiken voor eenvoudige HTTPS.

  1. Punt DNS: Maak een A record in Cloudflare voor uw Listmonk-subdomein (bijv. listmonk.yourdomain.com) die naar uw VPS IP-adres verwijst. Zorg ervoor dat de Proxystatus is ingesteld op Geproxydeerd (oranje wolk).
  2. Docker Compose wijzigen: Bewerk de docker-compose.yml bestand dat u hebt gedownload: 
    sed -i 's/9000:9000/80:9000/' docker-compose.yml
    Hierdoor is Listmonk intern toegankelijk via poort 80, die Cloudflare vervolgens kan proxyen en beveiligen met HTTPS.

Optie B: Een reverse proxy gebruiken (Nginx, Caddy, etc.)

U kunt er ook voor kiezen om een omgekeerde proxy zoals Nginx of Caddy op uw VPS in te stellen om HTTPS-beëindiging en proxyverzoeken naar Listmonk af te handelen (standaard draait deze op poort 9000).

  • De standaard behouden ports: - "127.0.0.1:9000:9000" in docker-compose.yml om ervoor te zorgen dat Listmonk alleen lokaal toegankelijk is.
  • Configureer de door u gekozen omgekeerde proxy om te luisteren op poorten 80 en 443, het verkrijgen van SSL-certificaten af te handelen (bijvoorbeeld via Let's Encrypt) en verkeer door te sturen naar http://127.0.0.1:9000.
  • Gedetailleerde reverse proxy-instellingen vallen buiten het bestek van deze handleiding, maar er zijn online veel tutorials beschikbaar.

6. Start Listmonk

Navigeer terug naar je listmonk map (als u daar nog niet bent) en start de containers in de losgemaakte modus.

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

Docker downloadt de benodigde images en start de Listmonk-applicatie en databasecontainers. Dit kan de eerste keer een minuut of twee duren.

✅ Toegang tot Listmonk: U zou nu toegang moeten hebben tot de Listmonk-webinterface via het domein dat u hebt geconfigureerd (bijv. https://listmonk.yourdomain.com).

7. Configureer SMTP voor doorsturen van e-mail in Listmonk

Configureer vervolgens Listmonk om e-mails te versturen via uw Forward Email-account.

  1. SMTP inschakelen in doorsturen van e-mail: Zorg ervoor dat u SMTP-referenties hebt gegenereerd in het dashboard van uw Forward Email-account. Volg de Handleiding voor het doorsturen van e-mail met een aangepast domein via SMTP als je dat nog niet gedaan hebt.
  2. Configureer Listmonk: Meld u aan bij uw Listmonk-beheerpaneel.

    • Navigeren naar Instellingen -> SMTP.

    • Listmonk heeft ingebouwde ondersteuning voor het doorsturen van e-mail. Selecteer DoorsturenE-mail uit de lijst met providers, of voer handmatig de volgende gegevens in:

      InstellingWaarde
      Gastheersmtp.forwardemail.net
      Haven465
      Auth-protocolLOGIN
      GebruikersnaamUw doorstuur-e-mail SMTP-gebruikersnaam
      WachtwoordUw doorstuur-e-mail SMTP-wachtwoord
      TLSSSL/TLS
      Vanuit e-mailUw gewenste From adres (bijv. newsletter@yourdomain.comZorg ervoor dat dit domein is geconfigureerd in E-mail doorsturen.

    • Belangrijk: Gebruik altijd Port 465 met SSL/TLS Voor beveiligde verbindingen met Forward Email. Gebruik geen STARTTLS (poort 587).

    • Klik Opslaan.

  3. Test-e-mail verzenden: Gebruik de knop 'Test-e-mail verzenden' op de SMTP-instellingenpagina. Voer een ontvangersadres in dat toegankelijk is en klik op VersturenControleer of de e-mail in de inbox van de ontvanger aankomt.

8. Bounceverwerking configureren

Dankzij bounceverwerking kan Listmonk automatisch e-mails verwerken die niet konden worden afgeleverd (bijvoorbeeld vanwege ongeldige adressen). Forward Email biedt een webhook om Listmonk op de hoogte te stellen van bounces.

E-mail doorsturen instellen

  1. Meld u aan bij uw Dashboard voor doorsturen van e-mail.
  2. Navigeren naar Domeinen, selecteer het domein dat u gebruikt voor het verzenden en ga naar het bijbehorende domein. Instellingen bladzijde.
  3. Scroll naar beneden naar de Bounce-webhook-URL sectie.
  4. Voer de volgende URL in, vervang <your_listmonk_domain> met het daadwerkelijke domein of subdomein waar uw Listmonk-instantie toegankelijk is: 
    https://<your_listmonk_domain>/webhooks/service/forwardemail
    Voorbeeld: https://listmonk.yourdomain.com/webhooks/service/forwardemail
  5. Scroll verder naar beneden naar de Verificatiesleutel voor webhookhandtekeningpayload sectie.
  6. Kopiëren De gegenereerde verificatiesleutel. Deze heb je nodig in Listmonk.
  7. Sla de wijzigingen op in uw Forward Email-domeininstellingen.

Listmonk-installatie

  1. Navigeer in uw Listmonk-beheerpaneel naar Instellingen -> Bounces.
  2. Inschakelen Bounceverwerking inschakelen.
  3. Inschakelen Bounce-webhooks inschakelen.
  4. Scroll naar beneden naar de Webhook-providers sectie.
  5. Inschakelen E-mail doorsturen.
  6. Plak de Verificatiesleutel voor webhookhandtekeningpayload die u hebt gekopieerd vanuit het dashboard E-mail doorsturen naar de Doorstuur-e-mailsleutel veld.
  7. Klik Opslaan onderaan de pagina.
  8. Bounceverwerking is nu geconfigureerd! Wanneer Forward Email een bounce detecteert voor een e-mail verzonden door Listmonk, wordt uw Listmonk-instantie hiervan via de webhook op de hoogte gesteld en markeert Listmonk de abonnee dienovereenkomstig.
  9. Voltooi de onderstaande stappen in Testen om er zeker van te zijn dat alles werkt.

Hier volgt een kort overzicht van de belangrijkste Listmonk-functies:

Maak een mailinglijst

  • Ga naar Lijsten in de zijbalk.
  • Klik Nieuwe lijst.
  • Vul de details in (Naam, Type: Openbaar/Privé, Beschrijving, Tags) en Opslaan.

Abonnees toevoegen

  • Navigeer naar de Abonnees sectie.
  • U kunt abonnees toevoegen:
    • Handmatig: Klik Nieuwe abonnee.
    • Importeren: Klik Abonnees importeren om een CSV-bestand te uploaden.
    • API: Gebruik de Listmonk API voor programmatische toevoegingen.
  • Wijs abonnees toe aan een of meer lijsten tijdens het maken of importeren.
  • Beste praktijk: Gebruik een dubbel opt-in-proces. Configureer dit onder Instellingen -> Opt-in en abonnementen.

Een campagne maken en verzenden

  • Ga naar Campagnes -> Nieuwe campagne.
  • Vul de campagnegegevens in (naam, onderwerp, afzender, lijst(en) waarnaar moet worden verzonden).
  • Kies uw inhoudstype (Rich Text/HTML, Platte tekst, Onbewerkte HTML).
  • Stel de inhoud van uw e-mail samen. U kunt sjabloonvariabelen gebruiken zoals {{ .Subscriber.Email }} of {{ .Subscriber.FirstName }}.
  • Stuur altijd eerst een testmail! Gebruik de optie 'Test verzenden' om een voorbeeld van de e-mail in uw inbox te bekijken.
  • Als u tevreden bent, klikt u op Campagne starten om het direct te verzenden of voor later te plannen.

  • SMTP-bezorging:Verstuur regelmatig test-e-mails via de SMTP-instellingenpagina van Listmonk en testcampagnes om te controleren of e-mails correct worden afgeleverd.
  • Bounce-behandeling: Stuur een testcampagne naar een bekend ongeldig e-mailadres (bijv. bounce-test@yourdomain.com (als je geen echte bij de hand hebt, hoewel de resultaten kunnen variëren). Controleer na korte tijd de campagnestatistieken in Listmonk om te zien of de bounce is geregistreerd.
  • E-mailheaders: Gebruik hulpmiddelen zoals Mailtester U kunt ook handmatig e-mailheaders controleren om te controleren of SPF, DKIM en DMARC worden doorgegeven, wat aangeeft dat de instellingen via Forward Email correct zijn.
  • E-maillogboeken doorsturenControleer de logboeken van het dashboard 'E-mail doorsturen' als u vermoedt dat er problemen zijn met de bezorging van e-mails door de SMTP-server.

  • Sjablonen: Listmonk maakt gebruik van de template-engine van Go. Bekijk de documentatie voor geavanceerde personalisatie: {{ .Subscriber.Attribs.your_custom_field }}.
  • APIListmonk biedt een uitgebreide REST API voor het beheren van lijsten, abonnees, campagnes, sjablonen en meer. De link naar de API-documentatie vindt u in de voettekst van uw Listmonk-instantie.
  • Aangepaste velden: Definieer aangepaste abonneevelden onder Instellingen -> Abonneevelden om aanvullende gegevens op te slaan.
  • Webhaken:Naast bounces kan Listmonk ook webhooks versturen voor andere gebeurtenissen (bijvoorbeeld abonnementen), waardoor integratie met andere systemen mogelijk is.

Door de zelfgehoste kracht van Listmonk te integreren met de veilige, privacy-respecterende levering van Forward Email, creëert u een robuust en ethisch e-mailmarketingplatform. U behoudt de volledige controle over uw doelgroepgegevens en profiteert tegelijkertijd van een hoge leverbaarheid en geautomatiseerde beveiligingsfuncties.

Deze opzet biedt een schaalbaar, kosteneffectief en ontwikkelaarsvriendelijk alternatief voor propriëtaire e-maildiensten en past perfect bij de filosofie van opensourcesoftware en de privacy van gebruikers.

Fijne verzending! 🚀