Mitināt Listmonk Managed VPS serverī: jūsu jaunumu vēstules jūsu serverī

Ko dara Listmonk

Listmonk pārvalda jūsu izplatīšanas sarakstus un jaunumu vēstules no tīmekļa saskarnes. Tā ir viena programma, uzrakstīta Go valodā, kuras vienīgā atkarība ir PostgreSQL. Tās saraksti ir vienvirziena: jūs rakstāt saviem abonentiem, un tas nav diskusiju saraksts viņu starpā.

• Saraksti: saraksti ar single vai double opt-in, līdz pat miljoniem abonentu, un segmentēšana ar SQL izteiksmēm pēc viņu atribūtiem.
• Kampaņas: vizuāls redaktors ar vilkšanu un nomešanu, WYSIWYG redaktors, Markdown, HTML vai vienkāršs teksts un Go valodas veidnes ar vairāk nekā 100 funkcijām.
• Statistika: atvēršanas, klikšķi, atlēcieni un visvairāk sekotās saites, kampaņu pa kampaņai.
• Darījumu ziņas: API, lai nosūtītu ziņu pēc veidnes, piemēram, pasūtījuma apstiprinājumu. «Messengers» ar HTTP webhook paver arī SMS vai WhatsApp, pieslēdzot jūsu izvēlēto pakalpojumu.
• Abonenti: lapa, kurā katrs pārvalda savas preferences, eksportē savus datus vai tos dzēš.
• Komanda: precīzas lomas un atļaujas, OIDC vienotā pieteikšanās un ierobežoti API marķieri.
• Mediji: attēlu bibliotēka diskā vai ar S3 saderīgā glabātuvē.

Ko atļauj AGPL-3.0 licence

Listmonk tiek izplatīts ar GNU AGPL 3. versijas licenci. Jūs varat to izmantot, tostarp uzņēmumā, un sūtīt savas un savu klientu kampaņas, nepērkot nekādu licenci. Paliek servera izmaksas un jūsu sūtīšanas pakalpojuma izmaksas.

13. pants pievieno AGPL raksturīgu nosacījumu: ja jūs mainīsiet programmu, jūsu versijai skaidri jāpiedāvā ikvienam, kas to izmanto attālināti, caur tīklu, bez maksas iegūt tās pirmkodu. Ja izplatāt kopijas, licences koda koplietošanas pienākumi attiecas arī uz to. Listmonk darbināšana bez mainīšanas šo pantu neiedarbina.

Kuru Listmonk versiju uzstādīt?

Kas jāzina pirms sākat. GitHub birka «Latest» šobrīd apzīmē v7.0.0-beta.2 no 2026. gada 10. novembra, ko pats projekts pasniedz kā beta. Pēdējā stabilā versija ir v6.2.0, kurā ir drošības labojumi atļaujām. 2026. gada 11. novembrī Docker attēls latest apzīmē šo v6.2.0.

7. versija nomaina visu administrēšanas saskarni, maina dažas tās adreses, iestatījumu app.from_email pārvērš par adrešu sarakstu un maina tulkojumu atslēgas, kas skar pielāgotās veidnes. Pirms pārejas izlasiet tās laidiena piezīmes.

Projekta Compose fails katrā startā palaiž --upgrade --yes: jauns attēls migrē datubāzi, neprasot jums. Taču migrētu datubāzi vecāka versija nelasa, un atgriešanās prasa atjaunot rezerves kopiju. Ar fiksētu birku, piemēram, v6.2.0, versijas maiņa paliek jūsu lēmums.

Uzstādīšana ar Docker Compose

Projekts iesaka Docker Compose: tā fails palaiž Listmonk un PostgreSQL kopā. Serverī, kur uzstādīts Docker, izveidojiet mapi un lejupielādējiet šo failu:

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

Projekts lūdz pielāgot šo failu jūsu videi. Lūk, vienīgās rindas, kas jāmaina, pārējais nekustas:

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

• Datubāzes parole: fails kā sākuma vērtību nodrošina listmonk. Nomainiet to pirms pirmās palaišanas, jo PostgreSQL attēls šo mainīgo nolasa tikai uz tukšas datu mapes.
• Attēls: konkrēta versija latest vietā, iepriekš minētā iemesla dēļ.
• Ports, publicēts uz 127.0.0.1: tas ir mūsu pielāgojums. Projekta fails publicē portu 9000 bez adreses ierobežojuma un jau ierobežo PostgreSQL ar lokālo adresi. Apstrādāts tāpat, Listmonk ir sasniedzams tikai caur reverso starpniekserveri.
• Resursdatora vārds: fails iesaka pilnu domēna vārdu.

Pēc tam palaidiet pakalpojumus, jau iepriekš izveidojot Super Admin kontu. Šie divi mainīgie kalpo tikai pirmajai palaišanai, un bez tiem konts tiek izveidots pirmajā saskarnes apmeklējumā: labāk, lai tas pastāv, pirms atverat savu domēnu.

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

Bez Docker: binārais fails

Listmonk darbojas arī kā atsevišķa programma, blakus jūsu pašu PostgreSQL serverim, 12. vai jaunākā versijā, kur datubāze jau ir izveidota.

1. Lejupielādējiet v6.2.0 arhīvu projekta versiju lapā, piemēram, listmonk_6.2.0_linux_amd64.tar.gz, izvairoties no beta versijas, kas redzama augšā, un izvelciet bināro failu.
2. Ģenerējiet konfigurācijas failu, pēc tam failā config.toml norādiet piekļuvi datubāzei.
3. Uzstādiet tabulas, pēc tam palaidiet Listmonk.

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

Pēc noklusējuma config.toml klausās uz localhost:9000, kas der aiz reversā starpniekservera. Repozitorijs nodrošina pakalpojuma failu listmonk@.service systemd videi.

Servera izmērs

Projekta vietne min produkcijas instanci, kas sūta kampaņu ar vairāk nekā 7 miljoniem e-pastu, izmantojot procesora kodola daļu un 57 MB atmiņas maksimumu. Tā nepublicē ne minimumu, ne skaitli PostgreSQL, kura apjoms aug līdz ar jūsu abonentiem, atvēršanām un klikšķiem. Ar Managed VPS aprakstiet mums savu lietojumu, un mēs jums iesakām piemērotu izmēru.

HTTPS un reversais starpniekserveris

Jūsu abonenti klikšķina uz saitēm, kas norāda uz jūsu instanci: atteikšanās, apstiprinājums, klikšķu izsekošana. Tāpēc tā jāpadara pieejama ar HTTPS uz sava domēna vārda. Izveidojiet šī vārda A un AAAA ierakstus uz savu serveri, kur apmeklētāji nonāk uz portiem 80 un 443. Listmonk dokumentācija atstāj starpniekservera izvēli, lūk, divas parastas konfigurācijas.

Ar Caddy

Caddy pats iegūst un atjauno sertifikātu:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Ar Nginx un Certbot

Nginx pēc noklusējuma atsaka pieprasījumus, kas lielāki par 1 MB, ar kļūdu 413. Lai importētu abonentu failu vai attēlus, paaugstiniet šo robežu atbilstoši savu failu izmēram:

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

Pēc tam Certbot uzstāda Let's Encrypt sertifikātu un novirzīšanu uz HTTPS, un sertifikātu atjauno pats:

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

Pirmie iestatījumi

Pieslēdzieties adresē https://listmonk.example.com/admin, pēc tam atveriet «Settings»:

• «General», «Root URL»: jūsu instances publiskā adrese, bez beigu slīpsvītras, piemēram, https://listmonk.example.com. No tās Listmonk ņem atteikšanās, apstiprinājuma un izsekošanas saites jūsu e-pastos. Tās sākuma vērtība, http://localhost:9000, jūsu abonentiem nedarbotos.
• «General», «Default from email»: noklusējuma sūtītāja adrese, uz jūsu domēna, norādītā piemēra vietā.
• «Media», «Upload path»: /listmonk/uploads, mape, ko Compose fails montē serverī.
• «General»: publiskā abonēšanas lapa un publiskais arhīvs sākumā ir aktīvi. Paturiet tos, ja tie jums vajadzīgi.
• «Security», «Enable CAPTCHA»: sākumā atslēgts, tas aizsargā publisko abonēšanas veidlapu.

Kas paliek publisks un ko var slēgt

Lai filtrētu piekļuvi pēc IP adreses vai ar autentifikācijas starpniekserveri, dokumentācija maršrutus sadala šādi:

Sūtīšana: Listmonk iet caur jūsu SMTP serveriem

Listmonk sagatavo un ieplāno jūsu e-pastus, pēc tam uztic tos SMTP serveriem, ko deklarējat sadaļā «Settings», «SMTP». Tas pats tos jūsu abonentu pastkastēs nepiegādā: piegādes kvalitāte tātad ir atkarīga no šī servera, jūsu domēna un jūsu sarakstiem.

Masveida sūtīšanai izvēlieties specializētu sūtīšanas pakalpojumu: tas nes jūsu sūtījumu reputāciju un jūsu domēna parakstus un prot atgriezt atlēcienus. No Simafri VPS sūtīšana notiek caur autentificētu SMTP releju, izmantojot portu 587: šeit tā ir šī pakalpojuma.

Lai orientētos, Listmonk dokumentācija apraksta atlēcienus no Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email un Lettermint. Salīdziniet tos pēc sava apjoma un adresātiem.

Pēc tam noklikšķiniet uz «Test connection»: Listmonk nosūta testa ziņu un parāda servera kļūdu, ja sūtīšana neizdodas. Varat deklarēt vairākus serverus, izvēlēties vienu no tiem katrai kampaņai vai maršrutēt sūtījumus pēc sūtītāja adreses vai domēna.

Ātrums

Iestatiet to sadaļā «Settings», «Performance», zem sava pakalpojuma robežas:

• «Concurrency» un «Message rate»: sūtīšanas pavedienu skaits un ziņu skaits sekundē katram. Sākuma vērtības, 10 un 10, ļauj līdz 100 ziņām sekundē.
• «Batch size»: abonentu skaits, ko katrā piegājienā nolasa no datubāzes, sākumā 1 000, ko paturēt virs mērķa ātruma. Augstāks tas patērē vairāk atmiņas.
• «Enable sliding window limit»: ziņu griesti uz laika posmu, noderīgi, kad jūsu pakalpojums skaita pa stundām.
• «Maximum error threshold»: kļūdu skaits, pēc kura kampaņa tiek apturēta.

Ziņa, kas neizdodas, tiek mēģināta vēlreiz pēc iestatījuma «Retries», pa citiem servera savienojumiem. Ja tā neizdodas atkal, Listmonk to atzīmē kā kļūdu un pāriet pie nākamās: lielas kampaņas laikā sekojiet šīm kļūdām.

Piegāde, atteikšanās un piekrišana

Lietojumprogrammas mitināšana savā serverī jūs dara par šo jautājumu saimnieku, un tieši tie izšķir, vai jūsu e-pasti nonāk galā.

SPF, DKIM un DMARC

Sūtiet no sava domēna adreses un publicējiet tā DNS zonā SPF un DKIM ierakstus, ko jums dod sūtīšanas pakalpojums, kopā ar DMARC ierakstu. Google pieprasa visus trīs sūtītājiem, kas uz Gmail kontiem sūta vairāk nekā 5 000 ziņu dienā, ar sūtītāja domēnu, kas saskaņots ar SPF vai DKIM, atteikšanos ar vienu klikšķi mārketinga ziņām un surogātpasta ziņošanas līmeni zem 0,30 %, ideālā gadījumā zem 0,10 %.

Atteikšanās

• Ziņā: ievietojiet {{ UnsubscribeURL }} savas veidnes kājenē. Šī saite ved uz preferenču pārvaldību un atteikšanos.
• Galvenēs: opcija «Include List-Unsubscribe header» sadaļā «Settings», «Privacy», sākumā aktīva, ļauj pasta programmatūrai piedāvāt atteikšanos ar vienu klikšķi.
• Dati: tā pati iestatījumu lapa abonentam atstāj tiesības eksportēt savus datus, tos dzēst un ieslēgt bloķēšanas sarakstā. Šīs opcijas sākumā ir aktīvas.

Jūsu adresātu piekrišana

Listmonk piemēro jūsu izvēlēto saraksta veidu. Sarakstā ar single opt-in abonents, kas pievienots bez apstiprinājuma, tik un tā saņem jūsu kampaņas. Sarakstā ar double opt-in viņš vispirms saņem apstiprinājuma e-pastu, un jūsu kampaņas saņem tikai apstiprinātie abonenti. Tā ir izvēle, kas vislabāk sargā jūsu sūtīšanas reputāciju un saglabā skaidru piekrišanas pēdu.

Noteikumi ir atkarīgi no jūsu adresātu valsts. Francijā, piemēram, CNIL pieprasa privātpersonu iepriekšēju piekrišanu ar pozitīvu darbību, piemēram, ar neatzīmētu rūtiņu, ar izņēmumu jūsu klientiem attiecībā uz līdzīgiem produktiem vai pakalpojumiem. Starp profesionāļiem prospektēšanās var balstīties uz leģitīmo interesi, ja tā attiecas uz viņu profesiju. Jebkurā gadījumā katra ziņa identificē sūtītāju un piedāvā vienkāršu veidu, kā atteikties no nākamajām.

Rakstiet tikai cilvēkiem, kas gaida jūsu ziņas. Pirkts vai vecs saraksts palielina atlēcienus un surogātpasta ziņojumus, un sekas nes jūsu domēns.

Atvēršanu un klikšķu izsekošana

Izsekošanas pikselis un klikšķu izsekošana skar privātumu, un dokumentācija lūdz tos izmantot, ievērojot tādus noteikumus kā VDAR. Pēc noklusējuma šī izsekošana nav saistīta ar katru abonentu: opcija «Individual subscriber tracking» to sasaista, bet «Disable tracking» to pilnībā izslēdz, sadaļā «Settings», «Privacy».

Atlēcieni

Turpināt rakstīt adresei, kas noraida jūsu ziņas, bojā jūsu sūtīšanas reputāciju. Atlēcienu apstrāde sākumā ir atslēgta: ieslēdziet to sadaļā «Settings», «Bounces», pēc tam izvēlieties vienu no šiem diviem ceļiem.

• Jūsu sūtīšanas pakalpojuma webhook: ieslēdziet «Enable bounce webhooks» un sava pakalpojuma opciju. Listmonk saņem atlēcienus no SES, Azure Communication Services, SendGrid, Postmark, Forward Email un Lettermint uz tādu adresi kā https://listmonk.example.com/webhooks/service/ses, pēdējam vārdam mainoties atkarībā no pakalpojuma. Šai adresei jāpaliek publiskai.
• POP3 pastkaste: Listmonk nolasa pastkasti, kas saņem atlēcienus, jūsu sūtītāja adreses pastkaste vai speciāla pastkaste. Tad tas atlēciena veidu nosaka pēc ziņas satura un to, ko neatpazīst, uzskata par vieglu.

Speciālai pastkastei deklarējiet to kā atgriešanas adresi sadaļā «Settings», «SMTP», «Custom headers»:

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

Sākuma iestatījumi ir tie, ko dokumentācija dod SES, un tie veido labu pamatu:

PostgreSQL, vienīgā atkarība

Listmonk prasa PostgreSQL 12 vai jaunāku. Compose fails nodrošina postgres:17-alpine, ar datiem Docker sējumā listmonk-data. Abonenti, kampaņas, veidnes, statistika un lielākā daļa iestatījumu dzīvo tur; konfigurācijā paliek tikai piekļuve datubāzei un klausīšanās adrese.

Lai vērstu uz esošu PostgreSQL serveri, mainiet pakalpojuma app mainīgos LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password un LISTMONK_db__database.

Listmonk ir veidots lieliem sarakstiem. Augot datubāzei, tieši tā var palēnināt saskarni: ar miljoniem abonentu informācijas panelis un skaitītāji var parādīties desmitiem sekunžu. Projekts tad iesaka divus soļus:

• «Cache slow database queries», sadaļā «Settings», «Performance»: skaitītāji tiek aprēķināti regulāros intervālos, pēc noklusējuma katru nakti plkst. 3.
• VACUUM ANALYZE uz lielas datubāzes, piemēram, katru nedēļu. Komanda uz sava izpildes laiku bloķē pieprasījumus, parasti dažas sekundes.

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

Rezerves kopijas un atjauninājumi

Jūsu instanci veido divi elementi: PostgreSQL datubāze un mape uploads, ja jūsu attēli paliek diskā. pg_dump izveido konsekventu eksportu, neapturot Listmonk un nebloķējot pārējo piekļuvi datubāzei:

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

Lai atjaunotu, apturiet Listmonk, iztukšojiet datubāzi, pēc tam no jauna ielādējiet eksportu. Kā precizē dokumentācija, šī darbība dzēš esošo datubāzi:

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

Atjaunināšana

1. Izlasiet jaunās versijas piezīmes: Listmonk par jaunām versijām paziņo savā saskarnē, un dažās ir drošības labojumi.
2. Eksportējiet datubāzi, kā projekts prasa pirms jebkura atjauninājuma.
3. Nomainiet attēla birku failā docker-compose.yml.
4. Palaidiet dokumentācijas komandas. Compose fails datubāzi migrē startā.

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

Ar bināro failu apturiet Listmonk, nomainiet bināro failu, palaidiet ./listmonk --upgrade, pēc tam palaidiet to no jauna. Lai atgrieztos pie iepriekšējās versijas, atjaunojiet eksportu, kas veikts pirms atjauninājuma, pēc tam atgrieziet veco birku.

Kurš ko dara Managed VPS serverī

Mitināšana savā serverī prasa uzturēt serveri papildus lietojumprogrammai. Ar Managed VPS mūsu komandas uzņemas serveri un proaktīvi seko jūsu instancei; Listmonk paliek jūsu programmatūra ar saviem iestatījumiem, jūsu sarakstiem un kampaņām.

Ja vēlaties, lai mūsu komandas iejaucas pašā lietojumprogrammā, šis pakalpojums tiek rēķināts par stundu vai par fiksētu summu, ar novērtējumu, kas paziņots pirms iejaukšanās.