Talpinkite Listmonk Managed VPS serveryje: jūsų naujienlaiškiai jūsų serveryje

Ką daro Listmonk

Listmonk valdo jūsų siuntimo sąrašus ir naujienlaiškius iš žiniatinklio sąsajos. Tai viena programa, parašyta Go kalba, kurios vienintelė priklausomybė yra PostgreSQL. Jos sąrašai vienakrypčiai: jūs rašote savo prenumeratoriams, o tai nėra jų tarpusavio diskusijų sąrašas.

• Sąrašai: sąrašai su paprastu ar dvigubu opt-in, iki milijonų prenumeratorių, ir segmentavimas SQL išraiškomis pagal jų atributus.
• Kampanijos: vizualinis vilkimo ir paleidimo redaktorius, WYSIWYG redaktorius, Markdown, HTML ar paprastas tekstas ir Go kalbos šablonai su daugiau nei 100 funkcijų.
• Statistika: atidarymai, paspaudimai, atmetimai ir daugiausia sekamos nuorodos, kampanija po kampanijos.
• Transakciniai laiškai: API žinutei pagal šabloną išsiųsti, pavyzdžiui, užsakymo patvirtinimui. „Messengers“ per HTTP webhook taip pat atveria SMS ar WhatsApp, kuriuos galima prijungti prie jūsų pasirinktos paslaugos.
• Prenumeratoriai: puslapis, kuriame kiekvienas tvarko savo nuostatas, eksportuoja savo duomenis arba juos ištrina.
• Komanda: tikslūs vaidmenys ir leidimai, OIDC vieningas prisijungimas ir apriboti API žetonai.
• Medija: paveikslėlių biblioteka diske arba su S3 suderinamoje saugykloje.

Ką leidžia AGPL-3.0 licencija

Listmonk platinama pagal GNU AGPL 3 versijos licenciją. Ją galite naudoti, įskaitant įmonėje, ir siųsti savo bei savo klientų kampanijas, nieko nepirkdami dėl licencijos. Lieka serverio kaina ir jūsų siuntimo paslaugos kaina.

13 straipsnis prideda AGPL būdingą sąlygą: jei programą keičiate, jūsų versija turi aiškiai pasiūlyti visiems ja nuotoliniu būdu, per tinklą, besinaudojantiems nemokamai gauti jos šaltinio kodą. Jei platinate kopijas, taip pat taikomi licencijos kodo bendrinimo įpareigojimai. Paleidžiant Listmonk jos nekeičiant šis straipsnis nesuveikia.

Kurią Listmonk versiją diegti?

Prieš pradedant verta žinoti vieną dalyką. GitHub žyma „Latest“ šiuo metu žymi v7.0.0-beta.2, išleistą 2026 m. lapkričio 10 d., kurią pats projektas pristato kaip beta. Naujausia stabili versija yra v6.2.0, kurioje yra leidimų saugumo pataisų. 2026 m. lapkričio 11 d. Docker atvaizdas latest žymi šią v6.2.0.

7 versija pakeičia visą administravimo sąsają, pakeičia kai kuriuos jos adresus, nustatymą app.from_email paverčia adresų sąrašu ir pakeičia vertimo raktus, o tai paliečia pasirinktinius šablonus. Prieš pereidami perskaitykite jos versijos pastabas.

Projekto Compose failas kiekvieną kartą paleidžiant vykdo --upgrade --yes: naujas atvaizdas migruoja duomenų bazę jūsų nepaklausęs. O migruotos duomenų bazės senesnė versija nebeperskaito, ir grįžimas atgal reikalauja atkurti atsarginę kopiją. Su fiksuota žyma, kaip v6.2.0, versijos keitimas lieka jūsų sprendimas.

Diegimas su Docker Compose

Projektas rekomenduoja Docker Compose: jo failas paleidžia Listmonk ir PostgreSQL kartu. Serveryje, kuriame įdiegtas Docker, sukurkite katalogą ir atsisiųskite šį failą:

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

Projektas prašo pritaikyti šį failą jūsų aplinkai. Štai vienintelės keistinos eilutės, likusios nejuda:

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

• Duomenų bazės slaptažodis: faile pradine reikšme pateiktas listmonk. Pakeiskite jį prieš pirmąjį paleidimą, nes PostgreSQL atvaizdas šį kintamąjį skaito tik tuščiame duomenų kataloge.
• Atvaizdas: konkreti versija vietoj latest, dėl aukščiau aprašytos priežasties.
• Prievadas, paskelbtas adresu 127.0.0.1: tai mūsų pritaikymas. Projekto faile 9000 prievadas skelbiamas be adreso apribojimo, o PostgreSQL jau apribotas vietiniu adresu. Taip pat pasielgus, Listmonk pasiekiama tik per atvirkštinį tarpinį serverį.
• Serverio vardas: faile siūlomas pilnas domeno vardas.

Tada paleiskite paslaugas, iš anksto sukurdami Super Admin paskyrą. Šie du kintamieji reikalingi tik pirmam paleidimui, o be jų paskyra sukuriama pirmo sąsajos apsilankymo metu: geriau, kad ji egzistuotų prieš atveriant jūsų domeną.

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

Be Docker: vykdomasis failas

Listmonk veikia ir kaip atskira programa, šalia jūsų pačių PostgreSQL serverio, 12 ar naujesnės versijos, kuriame duomenų bazė jau sukurta.

1. Atsisiųskite v6.2.0 archyvą projekto versijų puslapyje, pavyzdžiui, listmonk_6.2.0_linux_amd64.tar.gz, vengdami pirmos rodomos beta, ir išskleiskite vykdomąjį failą.
2. Sugeneruokite konfigūracijos failą, tada faile config.toml nurodykite prieigos prie duomenų bazės duomenis.
3. Įdiekite lenteles, tada paleiskite Listmonk.

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

Numatytai config.toml klausosi localhost:9000, kas tinka už atvirkštinio tarpinio serverio. Saugykloje pateikiamas systemd paslaugos failas listmonk@.service.

Serverio dydis

Projekto svetainė mini gamybinį egzempliorių, kuris siunčia daugiau nei 7 milijonų el. laiškų kampaniją naudodamas procesoriaus branduolio dalį ir didžiausią 57 MB atminties apkrovą. Ji nepaskelbia nei minimumo, nei PostgreSQL skaičių, kurie auga kartu su jūsų prenumeratoriais, atidarymais ir paspaudimais. Naudojant Managed VPS, papasakokite mums, kaip ketinate naudotis, ir mes rekomenduosime tinkamą dydį.

HTTPS ir atvirkštinis tarpinis serveris

Jūsų prenumeratoriai spaudžia nuorodas, vedančias į jūsų egzempliorių: atsisakymas, patvirtinimas, paspaudimų sekimas. Todėl ji teikiama per HTTPS savo domeno vardu. Sukurkite šio vardo A ir AAAA įrašus į savo serverį, kur lankytojai atvyksta 80 ir 443 prievadais. Listmonk dokumentacija palieka tarpinio serverio pasirinkimą jums, štai dvi įprastos konfigūracijos.

Su Caddy

Caddy pati gauna ir atnaujina sertifikatą:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Su Nginx ir Certbot

Nginx numatytai atmeta didesnes nei 1 MB užklausas su 413 klaida. Norėdami importuoti prenumeratorių failą ar paveikslėlius, padidinkite šią ribą pagal savo failų dydį:

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

Tada Certbot įdiegia Let's Encrypt sertifikatą ir nukreipimą į HTTPS, o vėliau sertifikatą atnaujina pats:

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

Pirmieji nustatymai

Prisijunkite adresu https://listmonk.example.com/admin, tada atverkite „Settings“:

• „General“, „Root URL“: viešasis jūsų egzemplioriaus adresas, be galinio brūkšnio, kaip https://listmonk.example.com. Listmonk iš jo sudaro atsisakymo, patvirtinimo ir sekimo nuorodas jūsų el. laiškuose. Jos pradinė reikšmė, http://localhost:9000, jūsų prenumeratoriams neveiktų.
• „General“, „Default from email“: numatytasis siuntėjo adresas jūsų domene, vietoj pateikto pavyzdžio.
• „Media“, „Upload path“: /listmonk/uploads, katalogas, kurį Compose failas prijungia serveryje.
• „General“: viešas prenumeratos puslapis ir viešas archyvas pradžioje aktyvūs. Palikite juos, jei jų reikia.
• „Security“, „Enable CAPTCHA“: pradžioje išjungta, ji saugo viešą prenumeratos formą.

Kas lieka viešas, o ką galima uždaryti

Norint filtruoti prieigą pagal IP adresą ar autentifikavimo tarpinį serverį, dokumentacija maršrutus skirsto taip:

Siuntimas: Listmonk eina per jūsų SMTP serverius

Listmonk paruošia ir paskirsto jūsų el. laiškus, tada patiki juos SMTP serveriams, kuriuos nurodote skiltyse „Settings“, „SMTP“. Ji pati jų prenumeratorių pašto dėžutėms nepristato: pristatymo kokybė priklauso nuo šio serverio, jūsų domeno ir jūsų sąrašų.

Masiniam siuntimui rinkitės specializuotą siuntimo paslaugą: ji laiko jūsų siuntimų reputaciją ir jūsų domeno parašus bei moka grąžinti atmetimus. Iš Simafri VPS siuntimas vyksta per autentifikuotą SMTP persiuntimo serverį 587 prievadu: čia tai šios paslaugos persiuntimo serveris.

Orientyrui: Listmonk dokumentacija aprašo Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email ir Lettermint atmetimus. Palyginkite juos pagal savo apimtį ir gavėjus.

Tada spustelėkite „Test connection“: Listmonk išsiunčia bandomąjį laišką ir, jei siuntimas nepavyksta, parodo serverio klaidą. Galite nurodyti kelis serverius, pasirinkti vieną iš jų kampanijai arba nukreipti siuntimus pagal siuntėjo adresą ar domeną.

Sparta

Nustatykite ją skiltyse „Settings“, „Performance“, žemiau savo paslaugos ribos:

• „Concurrency“ ir „Message rate“: siuntimo gijų skaičius ir žinučių per sekundę skaičius kiekvienai. Pradinės reikšmės, 10 ir 10, leidžia iki 100 žinučių per sekundę.
• „Batch size“: prenumeratorių skaičius, nuskaitomas iš duomenų bazės per vieną praėjimą, pradžioje 1 000, laikytinas virš siekiamos spartos. Didesnis naudoja daugiau atminties.
• „Enable sliding window limit“: žinučių riba per laikotarpį, naudinga, kai jūsų paslauga skaičiuoja per valandą.
• „Maximum error threshold“: klaidų skaičius, viršijus kurį kampanija pristabdoma.

Nepavykusi žinutė bandoma iš naujo pagal nustatymą „Retries“, kitais serverio ryšiais. Jei vėl nepavyksta, Listmonk pažymi ją kaip klaidą ir pereina prie kitos: didelės kampanijos metu stebėkite šias klaidas.

Pristatomumas, atsisakymas ir sutikimas

Talpinant programą šios temos lieka jūsų rankose, o būtent nuo jų priklauso, ar jūsų el. laiškai pasiekia gavėjus.

SPF, DKIM ir DMARC

Siųskite iš savo domeno adreso ir jo DNS zonoje paskelbkite SPF ir DKIM įrašus, kuriuos pateikia jūsų siuntimo paslauga, kartu su DMARC įrašu. Google visų trijų reikalauja iš siuntėjų, siunčiančių daugiau nei 5 000 žinučių per dieną į Gmail paskyras, su siuntimo domenu, suderintu su SPF ar DKIM, atsisakymu vienu paspaudimu rinkodaros žinutėse ir nepageidaujamo pašto skundų dalimi žemiau 0,30 %, idealiu atveju žemiau 0,10 %.

Atsisakymas

• Žinutėje: įdėkite {{ UnsubscribeURL }} į savo šablono apačią. Ši nuoroda veda į nuostatų valdymą ir atsisakymą.
• Antraštėse: parinktis „Include List-Unsubscribe header“ skiltyse „Settings“, „Privacy“, pradžioje aktyvi, leidžia pašto programoms pasiūlyti atsisakymą vienu paspaudimu.
• Duomenys: tas pats nustatymų puslapis palieka prenumeratoriui teisę eksportuoti savo duomenis, juos ištrinti ir įtraukti save į užblokuotų sąrašą. Šios parinktys pradžioje aktyvios.

Jūsų gavėjų sutikimas

Listmonk taiko jūsų pasirinktą sąrašo tipą. Sąraše su paprastu opt-in be patvirtinimo pridėtas prenumeratorius vis tiek gauna jūsų kampanijas. Sąraše su double opt-in jis pirmiausia gauna patvirtinimo el. laišką, ir jūsų kampanijas gauna tik patvirtinti prenumeratoriai. Tai pasirinkimas, geriausiai saugantis jūsų siuntimo reputaciją ir išlaikantis aiškų sutikimo pėdsaką.

Taisyklės priklauso nuo jūsų gavėjų šalies. Prancūzijoje, pavyzdžiui, CNIL reikalauja išankstinio privačių asmenų sutikimo, teigiamu veiksmu, pavyzdžiui, iš anksto nepažymėtu langeliu, su išimtimi jūsų klientams dėl panašių produktų ar paslaugų. Tarp profesionalų rinkodara gali remtis teisėtu interesu, jei susijusi su jų profesija. Bet kuriuo atveju kiekviena žinutė nurodo siuntėją ir suteikia paprastą būdą atsisakyti kitų.

Rašykite tik tiems, kurie laukia jūsų žinučių. Nupirktas ar senas sąrašas didina atmetimus ir skundus dėl nepageidaujamo pašto, o pasekmes patiria jūsų domenas.

Atidarymų ir paspaudimų sekimas

Sekimo pikselis ir paspaudimų sekimas liečia privatumą, ir dokumentacija prašo juos naudoti laikantis tokių taisyklių kaip BDAR. Numatytai šis sekimas nesiejamas su kiekvienu prenumeratoriumi: parinktis „Individual subscriber tracking“ jį susieja, o „Disable tracking“ jį visiškai išjungia, skiltyse „Settings“, „Privacy“.

Atmetimai

Toliau rašyti adresui, kuris atmeta jūsų žinutes, kenkia jūsų siuntimo reputacijai. Atmetimų apdorojimas pradžioje išjungtas: įjunkite jį skiltyse „Settings“, „Bounces“, tada pasirinkite vieną iš dviejų kelių.

• Jūsų siuntimo paslaugos webhook: įjunkite „Enable bounce webhooks“ ir savo paslaugos parinktį. Listmonk gauna SES, Azure Communication Services, SendGrid, Postmark, Forward Email ir Lettermint atmetimus adresu, kaip https://listmonk.example.com/webhooks/service/ses, kurio paskutinis žodis keičiasi pagal paslaugą. Šis adresas turi likti viešas.
• POP3 pašto dėžutė: Listmonk iš naujo skaito dėžutę, gaunančią atmetimus, jūsų siuntėjo adreso ar atskirą. Tada atmetimo tipą ji nustato pagal žinutės turinį, o tai, ko neatpažįsta, laiko lengvu.

Atskirai dėžutei nurodykite ją kaip grįžimo adresą skiltyse „Settings“, „SMTP“, „Custom headers“:

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

Pradiniai nustatymai yra tie, kuriuos dokumentacija pateikia SES, ir jie sudaro gerą pagrindą:

PostgreSQL, vienintelė priklausomybė

Listmonk reikalauja PostgreSQL 12 ar naujesnės. Compose failas pateikia postgres:17-alpine, jos duomenys laikomi Docker tome listmonk-data. Joje gyvena prenumeratoriai, kampanijos, šablonai, statistika ir dauguma nustatymų; konfigūracijoje lieka tik prieiga prie duomenų bazės ir klausymo adresas.

Norėdami nukreipti į esamą PostgreSQL serverį, pakeiskite paslaugos app kintamuosius LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password ir LISTMONK_db__database.

Listmonk sukurta dideliems sąrašams. Augant duomenų bazei, būtent ji gali sulėtinti sąsają: su milijonais prenumeratorių skydelis ir skaitikliai gali rodytis dešimtis sekundžių. Tuomet projektas pataria du veiksmus:

• „Cache slow database queries“, skiltyse „Settings“, „Performance“: skaitikliai skaičiuojami reguliariais intervalais, numatytai kiekvieną naktį 3 val.
• VACUUM ANALYZE didelėje duomenų bazėje, pavyzdžiui, kas savaitę. Komanda vykdymo metu blokuoja užklausas, paprastai kelias sekundes.

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

Atsarginės kopijos ir atnaujinimai

Jūsų egzempliorių sudaro du elementai: PostgreSQL duomenų bazė ir katalogas uploads, jei paveikslėliai lieka diske. pg_dump sukuria nuoseklų eksportą nestabdydamas Listmonk ir neblokuodamas kitos prieigos prie duomenų bazės:

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

Norėdami atkurti, sustabdykite Listmonk, ištuštinkite duomenų bazę ir iš naujo įkelkite eksportą. Kaip nurodo dokumentacija, šis veiksmas ištrina esamą duomenų bazę:

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

Atnaujinimas

1. Perskaitykite naujos versijos pastabas: Listmonk apie naujas versijas praneša savo sąsajoje, o kai kuriose yra saugumo pataisų.
2. Eksportuokite duomenų bazę, kaip projektas prašo prieš bet kokį atnaujinimą.
3. Pakeiskite atvaizdo žymą faile docker-compose.yml.
4. Paleiskite dokumentacijos komandas. Compose failas migruoja duomenų bazę paleidžiant.

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

Su vykdomuoju failu sustabdykite Listmonk, pakeiskite vykdomąjį failą, paleiskite ./listmonk --upgrade, tada paleiskite iš naujo. Norėdami grįžti prie ankstesnės versijos, atkurkite prieš atnaujinimą padarytą eksportą, tada grąžinkite seną žymą.

Kas ką daro Managed VPS serveryje

Talpinant savo serveryje, be programos reikia prižiūrėti ir patį serverį. Naudojant Managed VPS, mūsų komandos perima serverį ir proaktyviai stebi jūsų egzempliorių; Listmonk lieka jūsų programa su savo nustatymais, jūsų sąrašais ir kampanijomis.

Jei norite, kad mūsų komandos įsikištų į pačią programą, ši paslauga apmokestinama valandomis arba fiksuota kaina, o skaičiavimas pateikiamas prieš įsikišimą.