Listmonk majutamine Managed VPS-is: teie uudiskirjad teie enda serveris

Mida Listmonk teeb

Listmonk haldab teie levitusnimekirju ja uudiskirju veebiliidesest. See on üks Go-s kirjutatud programm, mille ainus sõltuvus on PostgreSQL. Selle nimekirjad on ühesuunalised: kirjutate oma tellijatele ja see ei ole nende omavaheline aruteluloend.

• Nimekirjad: nimekirjad ühe või kahe opt-in’iga, kuni miljonite tellijateni, ning segmenteerimine SQL-avaldistega nende atribuutide järgi.
• Kampaaniad: visuaalne lohistamisredaktor, WYSIWYG-redaktor, Markdown, HTML või lihttekst ning Go-keele mallid, kus on üle 100 funktsiooni.
• Statistika: avamised, klõpsud, tagasipõrked ja enim jälgitud lingid, kampaania kaupa.
• Tehingupõhised sõnumid: API sõnumi saatmiseks malli järgi, näiteks tellimuse kinnitus. HTTP-webhooki «messengerid» avavad ka SMS-i või WhatsAppi, mis ühendatakse teie valitud teenusega.
• Tellijad: leht, kus igaüks haldab oma eelistusi, ekspordib oma andmeid või kustutab need.
• Meeskond: täpsed rollid ja õigused, OIDC ühtne sisselogimine ja piiratud API-märgid.
• Meedia: piltide teek kettal või S3-ühilduvas salvestuses.

Mida AGPL-3.0-litsents lubab

Listmonk avaldatakse GNU AGPL versiooni 3 litsentsi all. Võite seda kasutada, ettevõttes samuti, ja saata nii oma kui ka oma klientide kampaaniaid, ilma et peaksite litsentsi ostma. Jääb serveri hind ja teie saatmisteenuse hind.

Artikkel 13 lisab AGPL-ile omase tingimuse: kui te programmi muudate, peab teie versioon selgelt pakkuma kõigile, kes seda kaugelt, võrgu kaudu kasutavad, võimalust saada selle lähtekood tasuta. Kui levitate koopiaid, kehtivad ka litsentsi koodi jagamise kohustused. Listmonki muutmata käitamine seda artiklit ei käivita.

Millist Listmonki versiooni paigaldada?

Üks asi, mida enne alustamist teada. GitHubis tähistab silt «Latest» praegu versiooni v7.0.0-beta.2 10. novembrist 2026, mida projekt ise esitleb beetana. Viimane stabiilne versioon on v6.2.0, mis sisaldab õiguste turvaparandusi. 11. novembri 2026 seisuga osutab Dockeri tõmmis latest sellele v6.2.0-le.

Versioon 7 asendab kogu halduse liidese, muudab mõnda selle aadressi, teeb sättest app.from_email aadresside loendi ja muudab tõlkevõtmeid, mis puudutab kohandatud malle. Lugege selle väljalaskemärkmeid enne sellele üleminekut.

Projekti Compose’i fail käivitab igal käivitamisel --upgrade --yes: uus tõmmis migreerib andmebaasi teilt küsimata. Migreeritud andmebaasi aga vanema versiooniga uuesti lugeda ei saa ja tagasiminek nõuab varukoopia taastamist. Kindla sildiga, näiteks v6.2.0, jääb versioonivahetus teie otsustada.

Paigaldus Docker Compose’iga

Projekt soovitab Docker Compose’i: selle fail käivitab Listmonki ja PostgreSQL-i koos. Looge serveris, kuhu Docker on paigaldatud, kaust ja tõmmake see fail:

mkdir listmonk
cd listmonk
curl -LO https://github.com/knadh/listmonk/raw/master/docker-compose.yml

Projekt palub seda faili oma keskkonnale kohandada. Siin on ainsad read, mida muuta, ülejäänud ei liigu:

x-db-credentials: &db-credentials
  POSTGRES_USER: &db-user listmonk
  POSTGRES_PASSWORD: &db-password un-mot-de-passe-long
  POSTGRES_DB: &db-name listmonk

services:
  app:
    image: listmonk/listmonk:v6.2.0
    ports:
      - "127.0.0.1:9000:9000"
    hostname: listmonk.example.com

• Andmebaasi parool: fail annab algväärtuseks listmonk. Muutke see enne esimest käivitamist, sest PostgreSQL-i tõmmis loeb seda muutujat ainult tühjalt andmekaustalt.
• Tõmmis: kindel versioon muutuja latest asemel, ülalnimetatud põhjusel.
• Port avaldatud aadressil 127.0.0.1: see on meie kohandus. Projekti fail avaldab pordi 9000 ilma aadressipiiranguta ja piirab PostgreSQL-i juba kohaliku aadressiga. Sama moodi käsitletuna on Listmonk kättesaadav ainult pöördproksi kaudu.
• Hostinimi: fail soovitab täielikku domeeninime.

Käivitage seejärel teenused, luues Super Admini konto ette. Need kaks muutujat on vaja ainult esimesel käivitamisel ja ilma nendeta luuakse konto liidese esimesel külastamisel: parem, et see on olemas enne, kui oma domeeni avate.

LISTMONK_ADMIN_USER=votre-identifiant LISTMONK_ADMIN_PASSWORD=votre-mot-de-passe docker compose up -d

Ilma Dockerita: binaarfail

Listmonk töötab ka eraldi programmina, teie enda PostgreSQL-serveri kõrval, versioonis 12 või uuem, kus andmebaas on juba loodud.

1. Laadige projekti versioonide lehelt alla v6.2.0 arhiiv, näiteks listmonk_6.2.0_linux_amd64.tar.gz, vältides esikohal kuvatavat beetat, ja pakkige binaarfail lahti.
2. Genereerige seadistusfail ja sisestage seejärel andmebaasi juurdepääsuandmed faili config.toml.
3. Paigaldage tabelid ja käivitage seejärel Listmonk.

./listmonk --new-config
./listmonk --install
./listmonk

Vaikimisi kuulab config.toml aadressil localhost:9000, mis sobib pöördproksi taha. Hoidla pakub systemd jaoks teenusefaili listmonk@.service.

Serveri suurus

Projekti sait toob näiteks tootmisinstantsi, mis saadab kampaania, milles on üle 7 miljoni e-kirja, protsessori tuuma murdosaga ja 57 MB mälu tipuga. See ei avalda ei miinimumi ega arvu PostgreSQL-i jaoks, mille maht kasvab koos teie tellijate, avamiste ja klõpsudega. Managed VPS-is kirjeldage meile oma kasutust ja soovitame sobiva suuruse.

HTTPS ja pöördproksi

Teie tellijad klõpsavad linkidel, mis osutavad teie instantsile: tellimuse tühistamine, kinnitamine, klõpsude jälgimine. Seda teenindatakse seega HTTPS-iga oma domeeninimel. Looge selle nime A- ja AAAA-kirjed oma serverisse, kus külastajad jõuavad portidele 80 ja 443. Listmonki dokumentatsioon jätab proksi valiku vabaks, siin on kaks tavalist seadistust.

Caddy-ga

Caddy hangib ja uuendab sertifikaadi ise:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Nginxi ja Certbotiga

Nginx keeldub vaikimisi päringutest, mis on suuremad kui 1 MB, veaga 413. Tellijafaili või piltide importimiseks tõstke see piir oma failide mõõtu:

server {
    listen 80;
    listen [::]:80;
    server_name listmonk.example.com;
    client_max_body_size 100m;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Certbot paigaldab seejärel Let’s Encrypti sertifikaadi ja HTTPS-ile ümbersuunamise ning uuendab sertifikaati ise:

sudo certbot --nginx -d listmonk.example.com

Esimesed sätted

Logige sisse aadressil https://listmonk.example.com/admin ja avage seejärel «Settings»:

• «General», «Root URL»: teie instantsi avalik aadress, ilma lõpu kaldkriipsuta, näiteks https://listmonk.example.com. Listmonk tuletab sellest teie e-kirjade tellimuse tühistamise, kinnitamise ja jälgimise lingid. Selle algväärtus, http://localhost:9000, ei töötaks teie tellijatel.
• «General», «Default from email»: vaikimisi saatja aadress, teie domeenil, antud näite asemel.
• «Media», «Upload path»: /listmonk/uploads, kaust, mille Compose’i fail serverisse paigaldab.
• «General»: avalik tellimisleht ja avalik arhiiv on alguses aktiivsed. Hoidke need, kui neid vajate.
• «Security», «Enable CAPTCHA»: alguses keelatud, see kaitseb avalikku tellimisvormi.

Mis jääb avalikuks, mida saab sulgeda

Ligipääsu filtreerimiseks, IP-aadressi või autentimisproksi järgi, jagab dokumentatsioon marsruudid nii:

Saatmine: Listmonk kasutab teie SMTP-servereid

Listmonk valmistab teie e-kirjad ette ja ajastab need, seejärel usaldab need SMTP-serveritele, mille deklareerite jaotises «Settings», «SMTP». See ei toimeta neid ise teie tellijate postkastidesse: kättetoimetamise kvaliteet sõltub seega sellest serverist, teie domeenist ja teie nimekirjadest.

Massiliseks saatmiseks valige spetsialiseeritud saatmisteenus: see kannab teie saatmiste mainet ja teie domeeni allkirju ning oskab tagasipõrkeid tagasi edastada. Simafri VPS-ist läheb saatmine läbi autenditud SMTP-releesõlme pordis 587: siin selle teenuse oma.

Orienteerumiseks kirjeldab Listmonki dokumentatsioon Amazon SES-i, Azure Communication Servicesi, SendGridi, Postmarki, Forward Maili ja Lettermintu tagasipõrkeid. Võrrelge neid oma mahu ja adressaatide järgi.

Klõpsake seejärel «Test connection»: Listmonk saadab proovisõnumi ja kuvab serveri tõrke, kui saatmine ebaõnnestub. Võite deklareerida mitu serverit, valida neist ühe kampaania kohta või suunata saatmisi saatja aadressi või domeeni järgi.

Kiirus

Seadke see jaotises «Settings», «Performance», oma teenuse piiri alla:

• «Concurrency» ja «Message rate»: saatmislõimede arv ja sõnumite arv sekundis iga lõime kohta. Algväärtused, 10 ja 10, lubavad kuni 100 sõnumit sekundis.
• «Batch size»: andmebaasist iga käiguga loetavate tellijate arv, alguses 1000, mida hoida soovitud kiirusest kõrgemal. Kõrgemana kulutab see rohkem mälu.
• «Enable sliding window limit»: sõnumite ülempiir ajavahemiku jooksul, kasulik, kui teie teenus loeb tunni kaupa.
• «Maximum error threshold»: tõrgete arv, millest alates kampaania peatatakse.

Ebaõnnestunud sõnumit korratakse sätte «Retries» järgi, serveri teistel ühendustel. Kui see ebaõnnestub jälle, märgib Listmonk selle veaks ja läheb järgmise juurde: jälgige neid tõrkeid suure kampaania ajal.

Kättetoimetatavus, tellimuse tühistamine ja nõusolek

Rakenduse ise majutamine jätab need teemad teie kätte ja just need otsustavad, kas teie e-kirjad kohale jõuavad.

SPF, DKIM ja DMARC

Saatke oma domeeni aadressilt ja avaldage selle DNS-tsoonis SPF- ja DKIM-kirjed, mille teie saatmisteenus teile annab, koos DMARC-kirjega. Google nõuab kõiki kolme saatjatelt, kes saadavad Gmaili kontodele üle 5000 sõnumi päevas, saatmisdomeeniga, mis on joondatud SPF-i või DKIM-iga, ühe klõpsuga tellimuse tühistamisega turundussõnumite puhul ning spämmina teatamise määraga alla 0,30 %, ideaalis alla 0,10 %.

Tellimuse tühistamine

• Sõnumis: pange {{ UnsubscribeURL }} oma malli jalusesse. See link viib eelistuste haldamise ja tellimuse tühistamise juurde.
• Päistes: valik «Include List-Unsubscribe header» jaotises «Settings», «Privacy», alguses aktiivne, võimaldab postiprogrammidel pakkuda ühe klõpsuga tellimuse tühistamist.
• Andmed: sama sätete leht jätab tellijale õiguse oma andmeid eksportida, need kustutada ja end blokeerimisnimekirja panna. Need valikud on alguses aktiivsed.

Teie adressaatide nõusolek

Listmonk rakendab nimekirja tüüpi, mille valite. Simple opt-in nimekirjas saab kinnituseta lisatud tellija teie kampaaniad ikkagi kätte. Double opt-in nimekirjas saab ta kõigepealt kinnituskirja ja teie kampaaniaid saavad ainult kinnitanud tellijad. See on valik, mis kaitseb teie saatmismaine kõige paremini ja hoiab nõusolekust selge jälje.

Reeglid sõltuvad teie adressaatide riigist. Prantsusmaal näiteks nõuab CNIL eraisikutelt eelnevat nõusolekut, positiivse tegevusega, näiteks eelmärkimata ruuduga, erandiga teie klientide jaoks sarnaste toodete või teenuste puhul. Ettevõtete vahel võib pealekäimine tugineda õigustatud huvile, kui see puudutab nende ametit. Igal juhul tuvastab iga sõnum saatja ja pakub lihtsa viisi järgmistest keeldumiseks.

Kirjutage ainult inimestele, kes teie sõnumeid ootavad. Ostetud või vana nimekiri tõstab tagasipõrkeid ja spämmina teatamisi, ning tagajärgi kannab teie domeen.

Avamiste ja klõpsude jälgimine

Jälgimispiksel ja klõpsude jälgimine puudutavad eraelu ning dokumentatsioon palub neid kasutada selliste reeglite nagu GDPR järgi. Vaikimisi ei seota seda jälgimist iga tellijaga: valik «Individual subscriber tracking» seob selle ja «Disable tracking» lülitab selle täielikult välja, jaotises «Settings», «Privacy».

Tagasipõrked

Kirjutamise jätkamine aadressile, mis teie sõnumeid tagasi lükkab, kahjustab teie saatmismaine. Tagasipõrgete töötlemine on alguses keelatud: lülitage see sisse jaotises «Settings», «Bounces» ja valige seejärel üks neist kahest teest.

• Teie saatmisteenuse webhook: lubage «Enable bounce webhooks» ja oma teenuse valik. Listmonk võtab vastu SES-i, Azure Communication Servicesi, SendGridi, Postmarki, Forward Maili ja Lettermint’i tagasipõrked aadressil nagu https://listmonk.example.com/webhooks/service/ses, viimane sõna muutub teenuse järgi. See aadress peab jääma avalikuks.
• POP3-postkast: Listmonk loeb uuesti postkasti, mis tagasipõrkeid vastu võtab, teie saatja aadressi oma või pühendatud postkasti. Siis arvab ta tagasipõrke tüübi sõnumi sisu järgi ja peab kergeks seda, mida ta ära ei tunne.

Pühendatud postkasti jaoks deklareerige see tagasiaadressina jaotises «Settings», «SMTP», «Custom headers»:

[
  {"Return-Path": "your-bounce-inbox@example.com"}
]

Algsätted on need, mida dokumentatsioon SES-i jaoks annab, ja need moodustavad hea aluse:

PostgreSQL, ainus sõltuvus

Listmonk nõuab PostgreSQL 12 või uuemat. Compose’i fail toob postgres:17-alpine, andmetega Dockeri köites listmonk-data. Tellijad, kampaaniad, mallid, statistika ja enamik sätteid elavad seal; ainult andmebaasi juurdepääsuandmed ja kuulamisaadress jäävad konfiguratsiooni.

Olemasoleva PostgreSQL-serveri sihtimiseks muutke teenuse app muutujaid LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password ja LISTMONK_db__database.

Listmonk on loodud suurte nimekirjade jaoks. Andmebaasi kasvades võib just see liidese aeglaseks muuta: miljonite tellijatega võivad juhtpaneeli ja loendurite kuvamine võtta kümneid sekundeid. Projekt soovitab siis kahte sammu:

• «Cache slow database queries» jaotises «Settings», «Performance»: loendurid arvutatakse korrapäraste ajavahemike järel, vaikimisi igal ööl kell 3.
• VACUUM ANALYZE suurel andmebaasil, näiteks igal nädalal. Käsk blokeerib päringud oma töötamise ajaks, üldiselt mõneks sekundiks.

docker compose exec db psql -U listmonk -d listmonk -c 'VACUUM ANALYZE;'

Varukoopiad ja uuendused

Teie instantsi moodustab kaks elementi: PostgreSQL-i andmebaas ja kaust uploads, kui teie pildid jäävad kettale. pg_dump annab järjepideva ekspordi, Listmonki peatamata ja teisi andmebaasi ligipääse blokeerimata:

docker compose exec -T db pg_dump -U listmonk listmonk > listmonk-$(date +%F).sql
tar -czf listmonk-uploads-$(date +%F).tar.gz uploads

Taastamiseks peatage Listmonk, tühjendage andmebaas ja laadige eksport uuesti. Nagu dokumentatsioon täpsustab, kustutab see toiming olemasoleva andmebaasi:

docker compose stop app
docker compose exec db psql -U listmonk -d listmonk -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public;'
docker compose exec -T db psql -U listmonk -d listmonk < listmonk-2026-11-01.sql
docker compose start app

Uuendamine

1. Lugege uue versiooni märkmeid: Listmonk teatab uutest versioonidest oma liideses ja mõni neist sisaldab turvaparandusi.
2. Eksportige andmebaas, nagu projekt enne iga uuendust nõuab.
3. Muutke failis docker-compose.yml tõmmise silti.
4. Käivitage dokumentatsiooni käsud. Compose’i fail migreerib andmebaasi käivitamisel.

docker compose down app
docker compose pull
docker compose up app -d

Binaarfailiga peatage Listmonk, asendage binaarfail, käivitage ./listmonk --upgrade ja käivitage see seejärel uuesti. Varasemale versioonile naasmiseks taastage enne uuendust tehtud eksport ja pange seejärel vana silt tagasi.

Kes mida teeb Managed VPS-is

Ise majutamine nõuab lisaks rakendusele ka serveri hoidmist. Managed VPS-is võtavad meie meeskonnad serveri enda hoole alla ja jälgivad teie instantsi proaktiivselt; Listmonk jääb teie tarkvaraks oma sätete, teie nimekirjade ja teie kampaaniatega.

Kui eelistate, et meie meeskonnad sekkuksid rakendusse endasse, arveldatakse see teenus tunni- või kindlahinnaga, hinnapakkumine edastatakse enne sekkumist.