Gostovanje Listmonk na Managed VPS: vaša glasila na vašem strežniku

Kaj počne Listmonk

Listmonk upravlja vaše poštne sezname in glasila iz spletnega vmesnika. Je en sam program, napisan v jeziku Go, katerega edina odvisnost je PostgreSQL. Njegovi seznami so enosmerni: pišete svojim naročnikom, ne gre pa za razpravljalni seznam med njimi.

• Seznami: seznami z enostavnim ali dvojnim opt-in, do milijonov naročnikov, in segmentacija z izrazi SQL po njihovih atributih.
• Kampanje: vizualni urejevalnik s povleci in spusti, urejevalnik WYSIWYG, Markdown, HTML ali navadno besedilo ter predloge v jeziku Go z več kot 100 funkcijami.
• Statistika: odprtja, kliki, odboji in najbolj spremljane povezave, po kampanjah.
• Transakcijska sporočila: API za pošiljanje sporočila po predlogi, na primer potrdila naročila. „Messengers“ prek webhooka HTTP odpirajo tudi SMS ali WhatsApp, za povezavo s storitvijo po vaši izbiri.
• Naročniki: stran, kjer vsak upravlja svoje nastavitve, izvozi svoje podatke ali jih izbriše.
• Ekipa: natančne vloge in dovoljenja, enotna prijava OIDC in omejeni žetoni API.
• Mediji: knjižnica slik na disku ali v shrambi, združljivi z S3.

Kaj dovoljuje licenca AGPL-3.0

Listmonk je objavljen pod licenco GNU AGPL, različica 3. Lahko ga uporabljate, tudi v podjetju, in pošiljate svoje kampanje ter kampanje svojih strank, ne da bi morali kupiti licenco. Ostane strošek strežnika in vaše storitve pošiljanja.

13. člen dodaja pogoj, značilen za AGPL: če program spremenite, mora vaša različica vsem, ki jo uporabljajo na daljavo, prek omrežja, jasno ponuditi možnost brezplačnega prejema izvorne kode. Če razpečujete kopije, veljajo tudi obveznosti licence glede deljenja kode. Poganjanje programa Listmonk brez spreminjanja tega člena ne sproži.

Katero različico programa Listmonk namestiti?

Ena stvar, ki jo je dobro vedeti pred začetkom. Na GitHubu oznaka „Latest“ trenutno označuje različico v7.0.0-beta.2 z dne 10. novembra 2026, ki jo projekt sam predstavlja kot beto. Zadnja stabilna različica je v6.2.0, ki vsebuje varnostne popravke dovoljenj. Na dan 11. novembra 2026 slika Docker latest označuje to različico v6.2.0.

Različica 7 nadomesti ves skrbniški vmesnik, spremeni nekatere njegove naslove, nastavitev app.from_email spremeni v seznam naslovov in spremeni ključe prevodov, kar zadeva predloge po meri. Preden nanjo preidete, preberite njene opombe k izdaji.

Datoteka Compose projekta ob vsakem zagonu zažene --upgrade --yes: nova slika zbirko migrira, ne da bi vas vprašala. Migrirane zbirke pa starejša različica ne more brati, vrnitev nazaj pa zahteva obnovo varnostne kopije. S fiksno oznako, kot je v6.2.0, sprememba različice ostane vaša odločitev.

Namestitev z Docker Compose

Projekt priporoča Docker Compose: njegova datoteka skupaj zažene Listmonk in PostgreSQL. Na strežniku z nameščenim Dockerjem ustvarite mapo in prenesite to datoteko:

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

Projekt zahteva, da to datoteko prilagodite svojemu okolju. Tukaj so edine vrstice, ki jih je treba spremeniti, preostalo se ne premakne:

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

• Geslo zbirke: datoteka kot začetno vrednost vsebuje listmonk. Spremenite ga pred prvim zagonom, ker slika PostgreSQL to spremenljivko prebere le na praznem podatkovnem imeniku.
• Slika: določena različica namesto latest, iz zgoraj omenjenega razloga.
• Vrata, objavljena na 127.0.0.1: to je naša prilagoditev. Datoteka projekta objavi vrata 9000 brez omejitve naslova, PostgreSQL pa že omeji na lokalni naslov. Če Listmonk obravnavamo enako, je dosegljiv le prek obratnega posredniškega strežnika.
• Ime gostitelja: datoteka svetuje popolnoma kvalificirano ime domene.

Nato zaženite storitve in vnaprej ustvarite račun Super Admin. Ti dve spremenljivki služita samo prvemu zagonu, brez njiju pa se račun ustvari ob prvem obisku vmesnika: bolje, da obstaja, preden odprete svojo domeno.

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

Brez Dockerja: binarna datoteka

Listmonk teče tudi kot samostojen program, ob vašem lastnem strežniku PostgreSQL, različice 12 ali novejše, kjer je zbirka že ustvarjena.

1. Prenesite arhiv različice v6.2.0 s strani izdaj projekta, na primer listmonk_6.2.0_linux_amd64.tar.gz, pri čemer se izogibajte beti, prikazani na vrhu, in razpakirajte binarno datoteko.
2. Ustvarite konfiguracijsko datoteko, nato v config.toml vpišite dostope do zbirke.
3. Namestite tabele, nato zaženite Listmonk.

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

Privzeto config.toml posluša na localhost:9000, kar ustreza za obratnim posredniškim strežnikom. Repozitorij vsebuje servisno datoteko listmonk@.service za systemd.

Velikost strežnika

Spletišče projekta navaja produkcijsko instanco, ki pošlje kampanjo več kot 7 milijonov e-poštnih sporočil z delom jedra procesorja in vrhom 57 MB pomnilnika. Ne objavlja ne minimuma ne številke za PostgreSQL, katerega obseg raste z vašimi naročniki, odprtji in kliki. Na Managed VPS nam opišite svojo rabo in priporočimo vam ustrezno velikost.

HTTPS in obratni posredniški strežnik

Vaši naročniki klikajo povezave, ki kažejo na vašo instanco: odjava, potrditev, sledenje klikom. Zato se streže prek HTTPS na lastnem imenu domene. Ustvarite zapisa A in AAAA tega imena na svoj strežnik, kamor obiskovalci prihajajo na vrata 80 in 443. Dokumentacija programa Listmonk izbiro posredniškega strežnika prepušča vam, tukaj sta dve pogosti konfiguraciji.

S Caddyjem

Caddy potrdilo pridobi in obnavlja sam:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Z Nginxom in Certbotom

Nginx privzeto zavrača zahteve, večje od 1 MB, z napako 413. Za uvoz datoteke naročnikov ali slik to omejitev zvišajte glede na velikost svojih datotek:

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 nato namesti potrdilo Let’s Encrypt in preusmeritev na HTTPS, potrdilo pa nato obnavlja sam:

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

Prve nastavitve

Prijavite se na https://listmonk.example.com/admin, nato odprite „Settings“:

• „General“, „Root URL“: javni naslov vaše instance, brez končne poševnice, na primer https://listmonk.example.com. Listmonk iz njega izpelje povezave za odjavo, potrditev in sledenje v vaših e-poštnih sporočilih. Njegova začetna vrednost, http://localhost:9000, pri vaših naročnikih ne bi delovala.
• „General“, „Default from email“: privzeti naslov pošiljatelja, na vaši domeni, namesto priloženega primera.
• „Media“, „Upload path“: /listmonk/uploads, mapa, ki jo datoteka Compose priklopi na strežnik.
• „General“: javna stran za naročanje in javni arhiv sta na začetku aktivna. Ohranite ju, če ju potrebujete.
• „Security“, „Enable CAPTCHA“: na začetku izklopljeno, ščiti javni obrazec za naročanje.

Kaj ostane javno in kaj se lahko zapre

Za filtriranje dostopa, po naslovu IP ali prek posredniškega strežnika za overjanje, dokumentacija poti razdeli takole:

Pošiljanje: Listmonk uporablja vaše strežnike SMTP

Listmonk pripravi in časovno razporedi vaša e-poštna sporočila, nato jih zaupa strežnikom SMTP, ki jih navedete v „Settings“, „SMTP“. Sam jih ne dostavi v nabiralnike vaših naročnikov: kakovost dostave je torej odvisna od tega strežnika, vaše domene in vaših seznamov.

Za množično pošiljanje izberite specializirano storitev pošiljanja: nosi ugled vaših pošiljk in podpise vaše domene ter zna sporočati odboje. Z VPS Simafri pošiljanje poteka prek overjenega releja SMTP, na vratih 587: tukaj je to rele te storitve.

Za orientacijo dokumentacija programa Listmonk opisuje odboje storitev Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email in Lettermint. Primerjajte jih glede na svoj obseg in prejemnike.

Nato kliknite „Test connection“: Listmonk pošlje poskusno sporočilo in prikaže napako strežnika, če pošiljanje spodleti. Določite lahko več strežnikov, enega izberete za posamezno kampanjo ali pošiljanja usmerjate glede na naslov ali domeno pošiljatelja.

Hitrost

Nastavite jo v „Settings“, „Performance“, pod omejitvijo svoje storitve:

• „Concurrency“ in „Message rate“: število niti pošiljanja in sporočil na sekundo za vsako. Začetni vrednosti, 10 in 10, dovoljujeta do 100 sporočil na sekundo.
• „Batch size“: število naročnikov, prebranih iz zbirke ob vsakem prehodu, na začetku 1000, ki naj ostane nad ciljno hitrostjo. Višja vrednost porabi več pomnilnika.
• „Enable sliding window limit“: zgornja meja sporočil v določenem času, uporabna, kadar vaša storitev šteje po urah.
• „Maximum error threshold“: število napak, nad katerim se kampanja zaustavi.

Sporočilo, ki spodleti, se ponovi po nastavitvi „Retries“, prek drugih povezav strežnika. Če spodleti še enkrat, ga Listmonk zabeleži kot napako in preide na naslednje: med veliko kampanjo spremljajte te napake.

Dostavljivost, odjava in privolitev

Samostojno gostovanje aplikacije vas naredi gospodarja teh tem, od njih pa je odvisno, ali vaša sporočila prispejo.

SPF, DKIM in DMARC

Pošiljajte z naslova svoje domene in v njeno cono DNS objavite zapisa SPF in DKIM, ki vam ju da vaša storitev pošiljanja, ter zapis DMARC. Google vse tri zahteva od pošiljateljev več kot 5000 sporočil na dan na račune Gmail, z domeno pošiljanja, poravnano s SPF ali DKIM, odjavo z enim klikom za tržna sporočila in stopnjo prijav neželene pošte pod 0,30 %, idealno pod 0,10 %.

Odjava

• V sporočilu: {{ UnsubscribeURL }} postavite v nogo svoje predloge. Ta povezava vodi do upravljanja nastavitev in odjave.
• V glavah: možnost „Include List-Unsubscribe header“ v „Settings“, „Privacy“, na začetku aktivna, poštnim programom omogoča, da ponudijo odjavo z enim klikom.
• Podatki: ista stran z nastavitvami naročniku prepušča pravico do izvoza podatkov, njihovega izbrisa in uvrstitve na seznam blokiranih. Te možnosti so na začetku aktivne.

Privolitev vaših prejemnikov

Listmonk uveljavlja vrsto seznama, ki jo izberete. Na seznamu z enostavnim opt-in naročnik, dodan brez potrditve, vseeno prejema vaše kampanje. Na seznamu z dvojnim opt-in najprej prejme potrditveno e-poštno sporočilo, vaše kampanje pa prejemajo samo potrjeni naročniki. To je izbira, ki najbolje ščiti ugled vašega pošiljanja in ohranja jasno sled soglasja.

Pravila so odvisna od države vaših prejemnikov. V Franciji na primer CNIL zahteva predhodno privolitev posameznikov, z dejanjem, kot je neoznačeno polje, z izjemo za vaše stranke pri podobnih izdelkih ali storitvah. Med podjetji se lahko trženje opira na zakoniti interes, če zadeva njihovo dejavnost. V vsakem primeru vsako sporočilo identificira pošiljatelja in ponuja preprost način za zavrnitev naslednjih.

Pišite samo osebam, ki vaša sporočila pričakujejo. Kupljen ali star seznam poveča odboje in prijave neželene pošte, posledice pa nosi vaša domena.

Sledenje odprtjem in klikom

Sledilni piksel in sledenje klikom posegata v zasebnost, dokumentacija pa zahteva, da ju uporabljate ob spoštovanju pravil, kot je GDPR. Privzeto to sledenje ni povezano z vsakim naročnikom: možnost „Individual subscriber tracking“ ga poveže, „Disable tracking“ pa ga povsem izklopi, v „Settings“, „Privacy“.

Odboji

Nadaljnje pisanje na naslov, ki vaša sporočila zavrača, kvari ugled vašega pošiljanja. Obdelava odbojev je na začetku izklopljena: vključite jo v „Settings“, „Bounces“, nato izberite eno od teh dveh poti.

• Webhook vaše storitve pošiljanja: vključite „Enable bounce webhooks“ in možnost svoje storitve. Listmonk prejema odboje storitev SES, Azure Communication Services, SendGrid, Postmark, Forward Email in Lettermint na naslov, kot je https://listmonk.example.com/webhooks/service/ses, pri čemer se zadnja beseda spreminja glede na storitev. Ta naslov mora ostati javen.
• Nabiralnik POP3: Listmonk redno bere nabiralnik, ki prejema odboje, tisti vašega naslova pošiljatelja ali namenski nabiralnik. Vrsto odboja nato ugane po vsebini sporočila in za lahkega šteje tistega, ki ga ne prepozna.

Za namenski nabiralnik ga določite kot povratni naslov v „Settings“, „SMTP“, „Custom headers“:

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

Začetne nastavitve so tiste, ki jih dokumentacija navaja za SES, in tvorijo dobro osnovo:

PostgreSQL, edina odvisnost

Listmonk zahteva PostgreSQL 12 ali novejši. Datoteka Compose prinaša postgres:17-alpine, s podatki v nosilcu Docker listmonk-data. Naročniki, kampanje, predloge, statistika in večina nastavitev živijo tam; v konfiguraciji ostanejo le dostopi do zbirke in naslov poslušanja.

Za usmeritev na obstoječi strežnik PostgreSQL spremenite spremenljivke LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password in LISTMONK_db__database storitve app.

Listmonk je zasnovan za velike sezname. Ko zbirka raste, lahko ravno ona upočasni vmesnik: pri milijonih naročnikov se lahko nadzorna plošča in števci prikazujejo več deset sekund. Projekt nato svetuje dve potezi:

• „Cache slow database queries“, v „Settings“, „Performance“: števci se izračunajo v rednih presledkih, privzeto vsako noč ob 3. uri.
• VACUUM ANALYZE na veliki zbirki, na primer vsak teden. Ukaz za čas izvajanja blokira poizvedbe, običajno nekaj sekund.

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

Varnostne kopije in posodobitve

Vašo instanco tvorita dva elementa: zbirka PostgreSQL in mapa uploads, če vaše slike ostanejo na disku. pg_dump ustvari skladen izvoz, ne da bi ustavil Listmonk ali blokiral druge dostope do zbirke:

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

Za obnovo ustavite Listmonk, izpraznite zbirko in nato znova naložite izvoz. Kot pojasnjuje dokumentacija, ta poteza izbriše zbirko na mestu:

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

Posodabljanje

1. Preberite opombe nove različice: Listmonk vas na nove različice opozori v svojem vmesniku, nekatere pa vsebujejo varnostne popravke.
2. Izvozite zbirko, kot projekt zahteva pred vsako posodobitvijo.
3. Spremenite oznako slike v docker-compose.yml.
4. Zaženite ukaze iz dokumentacije. Datoteka Compose zbirko migrira ob zagonu.

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

Z binarno datoteko ustavite Listmonk, zamenjajte binarno datoteko, zaženite ./listmonk --upgrade, nato ga znova zaženite. Za vrnitev na starejšo različico obnovite izvoz, narejen pred posodobitvijo, nato vrnite staro oznako.

Kdo kaj dela na Managed VPS

Samostojno gostovanje poleg aplikacije zahteva tudi vzdrževanje strežnika. Na Managed VPS naše ekipe prevzamejo strežnik in proaktivno spremljajo vašo instanco; Listmonk ostaja vaša programska oprema, z vašimi nastavitvami, seznami in kampanjami.

Če želite, da naše ekipe posežejo v samo aplikacijo, se ta storitev zaračuna po urah ali pavšalno, z oceno stroškov, sporočeno pred posegom.