Listmonk hosztolása Managed VPS-en: hírlevelei a saját szerverén

Mit tud a Listmonk

A Listmonk a levelezőlistáit és a hírleveleit kezeli egy webes felületről. Egyetlen, Goban írt program, amelynek egyetlen függősége a PostgreSQL. A listái egyirányúak: Ön ír a feliratkozóinak, és nem a feliratkozók közötti beszélgetési listáról van szó.

• A listák: egyszeres vagy dupla opt-in listák, akár milliós feliratkozószámig, és az attribútumaikra vonatkozó SQL-kifejezésekkel végzett szegmentálás.
• A kampányok: vizuális húzd-és-ejtsd szerkesztő, WYSIWYG szerkesztő, Markdown, HTML vagy egyszerű szöveg, valamint Go nyelvű sablonok több mint 100 függvénnyel.
• A statisztikák: megnyitások, kattintások, visszapattanók és a legtöbbet követett linkek, kampányonként.
• A tranzakciós üzenetek: egy API, amellyel sablon alapján küldhető üzenet, például rendelés-visszaigazolás. A webhook típusú „messengerek” az SMS-t és a WhatsAppot is megnyitják, az Ön által választott szolgáltatásra kötve.
• A feliratkozók: egy oldal, ahol mindenki kezelheti a beállításait, exportálhatja az adatait, vagy törölheti őket.
• A csapat: pontos szerepkörök és jogosultságok, OIDC egyszeri bejelentkezés és korlátozott API-tokenek.
• A médiafájlok: képtár a lemezen vagy egy S3-kompatibilis tárolón.

Mit enged meg az AGPL-3.0 licenc

A Listmonk a GNU AGPL 3. verziójú licence alatt jelenik meg. Használhatja, vállalkozásban is, és küldheti vele a saját és az ügyfelei kampányait, licenc vásárlása nélkül. Marad a szerver költsége és a küldő szolgáltatásáé.

A 13. szakasz az AGPL-re jellemző feltételt tesz hozzá: ha módosítja a programot, a változatának egyértelműen fel kell kínálnia mindenkinek, aki távolról, a hálózaton keresztül használja, a forráskód ingyenes megszerzését. Ha másolatokat terjeszt, a licenc kódmegosztási kötelezettségei is érvényesek. A Listmonk módosítás nélküli futtatása nem váltja ki ezt a szakaszt.

Melyik Listmonk-verziót telepítsem?

Egy tudnivaló, mielőtt hozzákezd. A GitHubon a „Latest” címke jelenleg a 2026. november 10-i v7.0.0-beta.2 verziót jelöli, amelyet maga a projekt is bétaként mutat be. A legutóbbi stabil verzió a v6.2.0, amely biztonsági javításokat tartalmaz a jogosultságokhoz. 2026. november 11-én a latest Docker image ezt a v6.2.0-t jelöli.

A 7-es verzió lecseréli az egész adminisztrációs felületet, megváltoztatja néhány címét, az app.from_email beállítást címek listájává teszi, és fordítási kulcsokat módosít, ami az egyéni sablonokat érinti. Mielőtt áttér rá, olvassa el a kiadási megjegyzéseit.

A projekt Compose-fájlja minden indításkor lefuttatja a --upgrade --yes parancsot: egy új image kérdés nélkül migrálja az adatbázist. Egy migrált adatbázis viszont nem olvasható be régebbi verzióval, és a visszalépéshez mentést kell visszaállítani. Rögzített címkével, például a v6.2.0-val, a verzióváltás az Ön döntése marad.

Telepítés Docker Compose-zal

A projekt a Docker Compose-t ajánlja: a fájlja együtt indítja a Listmonkot és a PostgreSQL-t. Egy olyan szerveren, ahol a Docker telepítve van, hozzon létre egy mappát, és töltse le ezt a fájlt:

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

A projekt azt kéri, hogy igazítsa ezt a fájlt a környezetéhez. Ezek az egyetlen módosítandó sorok, a többi nem változik:

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

• Az adatbázis jelszava: a fájl kiindulási értékként a listmonk szót adja. Módosítsa az első indítás előtt, mert a PostgreSQL image ezt a változót csak üres adatmappa esetén olvassa be.
• Az image: egy adott verzió a latest helyett, a fent látott okból.
• A 127.0.0.1 címen közzétett port: ez a mi igazításunk. A projekt fájlja a 9000-es portot címkorlátozás nélkül teszi közzé, a PostgreSQL-t viszont már a helyi címre korlátozza. Ugyanígy kezelve a Listmonk csak a fordított proxyn keresztül érhető el.
• A gazdagépnév: a fájl teljes tartománynevet javasol.

Ezután indítsa el a szolgáltatásokat, előre létrehozva a Super Admin fiókot. Ez a két változó csak az első indításhoz kell, és nélkülük a fiók a felület első megnyitásakor jön létre: jobb, ha már létezik, mielőtt megnyitja a domainjét.

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

Docker nélkül: a bináris

A Listmonk önálló programként is fut, a saját PostgreSQL-szervere mellett, amely 12-es vagy újabb verziójú, és ahol az adatbázis már létre van hozva.

1. Töltse le a v6.2.0 archívumát a projekt kiadási oldaláról, például a listmonk_6.2.0_linux_amd64.tar.gz fájlt, elkerülve az elöl megjelenített bétát, és bontsa ki a binárist.
2. Generálja le a konfigurációs fájlt, majd adja meg az adatbázis-hozzáféréseket a config.toml fájlban.
3. Telepítse a táblákat, majd indítsa el a Listmonkot.

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

Alapértelmezésként a config.toml a localhost:9000 címen figyel, ami fordított proxy mögött megfelel. A tároló egy listmonk@.service szolgáltatásfájlt ad a systemd-hez.

A szerver mérete

A projekt webhelye egy éles példányt említ, amely több mint 7 millió e-mailes kampányt küld egy processzormag töredékével és 57 MB-os memóriacsúccsal. Sem minimumot, sem a PostgreSQL-re vonatkozó számot nem közöl, pedig az adatbázis mérete a feliratkozókkal, a megnyitásokkal és a kattintásokkal együtt nő. Egy Managed VPS esetén írja le nekünk a használatát, és mi azt a méretet javasoljuk, amely megfelel.

HTTPS és a fordított proxy

A feliratkozói olyan linkekre kattintanak, amelyek az Ön példányára mutatnak: leiratkozás, megerősítés, kattintáskövetés. Ezért HTTPS-en, saját domainnéven kell kiszolgálni. Hozza létre ennek a névnek az A és AAAA rekordjait a szerverére, ahová a látogatók a 80-as és a 443-as porton érkeznek. A Listmonk dokumentációja szabadon hagyja a proxy megválasztását, íme két gyakori konfiguráció.

Caddyvel

A Caddy maga szerzi meg és újítja meg a tanúsítványt:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Nginxszel és Certbottal

Az Nginx alapértelmezésként 413-as hibával elutasítja az 1 MB-nál nagyobb kéréseket. Feliratkozói fájl vagy képek importálásához emelje ezt a korlátot a fájljai méretéhez igazítva:

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;
    }
}

A Certbot ezután telepíti a Let's Encrypt-tanúsítványt és a HTTPS-re irányító átirányítást, majd magától megújítja a tanúsítványt:

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

Az első beállítások

Jelentkezzen be a https://listmonk.example.com/admin címen, majd nyissa meg a „Settings” menüt:

• „General”, „Root URL”: a példánya nyilvános címe, záró perjel nélkül, például https://listmonk.example.com. A Listmonk ebből állítja elő az e-mailjei leiratkozási, megerősítési és követési linkjeit. A kiindulási értéke, a http://localhost:9000, a feliratkozóinál nem működne.
• „General”, „Default from email”: az alapértelmezett feladói cím, a saját domainjén, a megadott példa helyett.
• „Media”, „Upload path”: /listmonk/uploads, az a mappa, amelyet a Compose-fájl a szerverre csatol.
• „General”: a nyilvános feliratkozási oldal és a nyilvános archívum kiindulásként aktív. Tartsa meg őket, ha szüksége van rájuk.
• „Security”, „Enable CAPTCHA”: kiindulásként kikapcsolt, a nyilvános feliratkozási űrlapot védi.

Ami nyilvános marad, és ami lezárható

A hozzáférés IP-cím vagy hitelesítő proxy szerinti szűréséhez a dokumentáció így osztja fel az útvonalakat:

A küldés: a Listmonk az Ön SMTP-szervereit használja

A Listmonk előkészíti és ütemezi az e-mailjeit, majd a „Settings”, „SMTP” menüben megadott SMTP-szervereknek adja át őket. Nem ő kézbesíti őket a feliratkozói postaládáiba: a kézbesítés minősége tehát ettől a szervertől, a domainjétől és a listáitól függ.

Nagy mennyiségű küldéshez válasszon egy erre szakosodott küldő szolgáltatást: ez hordozza a küldései hírnevét és a domainje aláírásait, és képes visszajelezni a visszapattanókat. Simafri VPS-ről a küldés egy hitelesített SMTP-továbbítón keresztül megy, a 587-es porton: itt ennek a szolgáltatásnak a továbbítóján.

Eligazodásként a Listmonk dokumentációja az Amazon SES, az Azure Communication Services, a SendGrid, a Postmark, a Forward Email és a Lettermint visszapattanóit írja le. Hasonlítsa össze őket a mennyisége és a címzettjei szerint.

Ezután kattintson a „Test connection” gombra: a Listmonk próbaüzenetet küld, és megjeleníti a szerver hibáját, ha a küldés meghiúsul. Több szervert is megadhat, kampányonként kiválaszthatja az egyiket, vagy a feladó címe, illetve domainje szerint irányíthatja a küldéseket.

A küldési sebesség

Állítsa be a „Settings”, „Performance” menüben, a szolgáltatása korlátja alatt:

• „Concurrency” és „Message rate”: a küldési szálak száma, és szálanként a másodpercenkénti üzenetek száma. A kiindulási értékek, a 10 és a 10, másodpercenként legfeljebb 100 üzenetet engedélyeznek.
• „Batch size”: az egy menetben az adatbázisból beolvasott feliratkozók száma, kiindulásként 1000, a célzott sebesség fölött tartandó. Magasabb értéknél több memóriát fogyaszt.
• „Enable sliding window limit”: üzenetplafon egy időtartamra, hasznos, ha a szolgáltatása óránként számol.
• „Maximum error threshold”: a hibák száma, amely fölött egy kampány szünetel.

Egy sikertelen üzenetet a „Retries” beállítás szerint újra megpróbál, a szerver más kapcsolatain. Ha megint sikertelen, a Listmonk hibaként jegyzi fel, és továbblép a következőre: egy nagy kampány alatt figyelje ezeket a hibákat.

Kézbesíthetőség, leiratkozás és hozzájárulás

Az alkalmazás hosztolása Önre bízza ezeket a témákat, és ezek döntik el, megérkeznek-e az e-mailjei.

SPF, DKIM és DMARC

Küldjön a domainje egy címéről, és tegye közzé a DNS-zónájában az SPF- és DKIM-rekordokat, amelyeket a küldő szolgáltatása ad, valamint egy DMARC-rekordot. A Google mindhármat kéri azoktól a küldőktől, akik naponta több mint 5000 üzenetet küldenek Gmail-fiókokba, SPF-hez vagy DKIM-hez igazodó küldő domainnel, a marketingüzenetek egykattintásos leiratkozásával, és 0,30 % alatti, ideális esetben 0,10 % alatti spambejelentési aránnyal.

A leiratkozás

• Az üzenetben: helyezze a {{ UnsubscribeURL }} kifejezést a sablonja láblécébe. Ez a link a beállítások kezeléséhez és a leiratkozáshoz vezet.
• A fejlécekben: a „Settings”, „Privacy” menü „Include List-Unsubscribe header” opciója, amely kiindulásként aktív, lehetővé teszi, hogy a levelezőprogramok egykattintásos leiratkozást kínáljanak.
• Az adatok: ugyanez a beállítási oldal jogot ad a feliratkozónak az adatai exportálására, törlésére, és arra, hogy letiltólistára tegye magát. Ezek az opciók kiindulásként aktívak.

A címzettek hozzájárulása

A Listmonk az Ön által választott listatípust alkalmazza. Egy egyszeres opt-in listán a megerősítés nélkül hozzáadott feliratkozó is megkapja a kampányait. Egy dupla opt-in listán először megerősítő e-mailt kap, és csak a megerősített feliratkozók kapják meg a kampányait. Ez a választás védi a legjobban a küldési hírnevét, és ez őrzi meg egyértelműen a beleegyezés nyomát.

A szabályok a címzettjei országától függenek. Franciaországban például a CNIL a magánszemélyek előzetes hozzájárulását kéri, pozitív cselekvéssel, például egy előre nem bejelölt jelölőnégyzettel, kivétellel az ügyfelei számára hasonló termékek vagy szolgáltatások esetén. Szakmai szereplők között a megkeresés alapulhat jogos érdeken, ha a szakmájukat érinti. Minden esetben minden üzenet azonosítja a feladót, és egyszerű módot ad a további üzenetek elutasítására.

Csak olyan személyeknek írjon, akik várják az üzeneteit. Egy vásárolt vagy régi lista megemeli a visszapattanók és a spambejelentések számát, és ennek a következményeit az Ön domainje viseli.

A megnyitások és a kattintások követése

A követőpixel és a kattintáskövetés érinti a magánszférát, a dokumentáció pedig azt kéri, hogy az olyan szabályok betartásával használja őket, mint a GDPR. Alapértelmezésként ez a követés nincs hozzákötve az egyes feliratkozókhoz: az „Individual subscriber tracking” opció hozzákapcsolja, a „Disable tracking” pedig teljesen kikapcsolja, a „Settings”, „Privacy” menüben.

A visszapattanók

Ha továbbra is olyan címre ír, amely elutasítja az üzeneteit, azzal rontja a küldési hírnevét. A visszapattanók kezelése kiindulásként ki van kapcsolva: kapcsolja be a „Settings”, „Bounces” menüben, majd válassza az alábbi két út egyikét.

• A küldő szolgáltatása webhookja: kapcsolja be az „Enable bounce webhooks” opciót és a szolgáltatása opcióját. A Listmonk a SES, az Azure Communication Services, a SendGrid, a Postmark, a Forward Email és a Lettermint visszapattanóit egy olyan címen kapja, mint a https://listmonk.example.com/webhooks/service/ses, az utolsó szó a szolgáltatás szerint változik. Ennek a címnek nyilvánosnak kell maradnia.
• Egy POP3-postaláda: a Listmonk újraolvas egy postaládát, amely a visszapattanókat fogadja, a feladói címéét vagy egy külön postaládát. Ilyenkor a visszapattanó típusát az üzenet tartalma alapján találgatja, és enyhének tekinti, amit nem ismer fel.

Külön postaláda esetén adja meg visszatérési címként a „Settings”, „SMTP”, „Custom headers” menüben:

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

A kiindulási beállítások azok, amelyeket a dokumentáció az SES-hez ad, és jó alapot adnak:

A PostgreSQL, az egyetlen függőség

A Listmonk PostgreSQL 12-t vagy újabbat igényel. A Compose-fájl a postgres:17-alpine image-et hozza, az adataival a listmonk-data Docker-kötetben. A feliratkozók, a kampányok, a sablonok, a statisztikák és a beállítások nagy része itt él; csak az adatbázis-hozzáférések és a figyelési cím marad a konfigurációban.

Egy meglévő PostgreSQL-szerver használatához módosítsa az app szolgáltatás LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password és LISTMONK_db__database változóit.

A Listmonkot nagy listákra tervezték. Ahogy az adatbázis nő, az lassíthatja a felületet: több millió feliratkozónál az irányítópult és a számlálók megjelenítése több tíz másodpercig is eltarthat. A projekt ilyenkor két lépést tanácsol:

• „Cache slow database queries”, a „Settings”, „Performance” menüben: a számlálók rendszeres időközönként számolódnak, alapértelmezésként minden éjjel 3 órakor.
• VACUUM ANALYZE egy nagy adatbázison, például hetente. A parancs a lefutása idejére blokkolja a lekérdezéseket, általában néhány másodpercre.

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

Mentések és frissítések

Két elem alkotja a példányát: a PostgreSQL-adatbázis és az uploads mappa, ha a képei a lemezen maradnak. A pg_dump konzisztens exportot készít anélkül, hogy leállítaná a Listmonkot vagy blokkolná az adatbázis többi elérését:

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

A visszaállításhoz állítsa le a Listmonkot, ürítse ki az adatbázist, majd töltse be újra az exportot. Ahogyan a dokumentáció pontosítja, ez a lépés törli a meglévő adatbázist:

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

Frissítés

1. Olvassa el az új verzió megjegyzéseit: a Listmonk jelzi a felületén az új verziókat, és némelyik biztonsági javításokat tartalmaz.
2. Exportálja az adatbázist, ahogyan a projekt minden frissítés előtt kéri.
3. Módosítsa az image címkéjét a docker-compose.yml fájlban.
4. Futtassa a dokumentáció parancsait. A Compose-fájl induláskor migrálja az adatbázist.

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

A binárissal állítsa le a Listmonkot, cserélje le a binárist, futtassa a ./listmonk --upgrade parancsot, majd indítsa újra. Egy korábbi verzióra való visszatéréshez állítsa vissza a frissítés előtt készített exportot, majd tegye vissza a régi címkét.

Ki mit csinál egy Managed VPS-en

A saját üzemeltetés az alkalmazás mellett a szerver gondozását is megköveteli. Egy Managed VPS esetén csapataink átveszik a szervert, és proaktívan követik a példányát; a Listmonk továbbra is az Ön szoftvere marad, a beállításaival, a listáival és a kampányaival.

Ha inkább azt szeretné, hogy csapataink magában az alkalmazásban avatkozzanak be, ez a szolgáltatás óradíjban vagy átalánydíjban számlázódik, a beavatkozás előtt közölt árajánlattal.