Jak samodzielnie hostować newsletter z Listmonk

Przy samodzielnym hostowaniu Listmonk działa na VPS, za który już płacisz. Wysyłka kosztuje tyle, ile przekaźnik SMTP liczy za tysiąc e-maili. Liczba subskrybentów nie zmienia żadnej z tych kwot. To strukturalna zmiana, która sprawia, że samodzielny hosting jest wart czasu na konfigurację, gdy przerośniesz darmowy plan usługi zarządzanej.

Listmonk to open-source'owy menedżer newsletterów napisany w Go. Dostajesz nieograniczoną liczbę subskrybentów, list i kampanii za cenę VPS plus konta przekaźnika SMTP. Jedno musi być jasne, zanim wpiszesz pierwszą komendę: Listmonk obsługuje wszystko poza samą wysyłką. To, czy e-mail trafi do skrzynki odbiorczej czy do spamu, zależy od skonfigurowanego przekaźnika SMTP i rekordów DNS ustawionych na domenie wysyłkowej.

Co obejmuje ten przewodnik

• Wdróż Listmonk i PostgreSQL z Docker Compose za odwrotnym proxy Nginx (lub Caddy) z HTTPS
• Wybierz właściwy przekaźnik SMTP do swojego wolumenu i budżetu (Amazon SES, Postmark, Brevo lub inny)
• Skonfiguruj SPF, DKIM i DMARC na domenie wysyłkowej
• Unikaj czterech produkcyjnych trybów awarii, które często nie zgłaszają jasnych błędów
• Szacowany czas: 30 minut, jeśli masz gotowy VPS i domenę
• Poza zakresem: automatyzacja drip, e-maile transakcyjne, konfiguracje wieloinstancyjne (zobacz FAQ)

Kiedy Listmonk to złe narzędzie

Listmonk jest właściwą odpowiedzią w konkretnej sytuacji. Jeśli Twoja sytuacja jest inna, istnieje lepsza odpowiedź.

Wolumen poniżej ~10K e-maili miesięcznie. Zarządzane darmowe plany w Brevo lub Mailchimp mogą wyjść taniej w sumie niż VPS plus przekaźnik SMTP przy tej skali. Samodzielny hosting zaczyna się opłacać dopiero po przekroczeniu tego zakresu. Sprawdź liczby względem swojej rzeczywistej liczby subskrybentów i częstotliwości wysyłek, zanim zaczniesz wdrożenie.

Nietechniczny zespół. Mailchimp i Brevo mają naprawdę lepsze interfejsy dla osób, które nie pracują w terminalu. Listmonk zakłada, że ktoś w zespole potrafi połączyć się z serwerem przez SSH, czytać logi Dockera i interpretować propagację DNS. Jeśli takiej osoby nie ma, właściwym wyborem są usługi zarządzane.

Potrzeba przepływów automatyzacji. Listmonk wysyła kampanie. Nie obsługuje sekwencji drip, e-maili wyzwalanych zachowaniem ani wizualnych kreatorów przepływów. Jeśli ich potrzebujesz, uruchom Mautic albo połącz Listmonk z n8n jako warstwą automatyzacji.

Listy subskrybentów wrażliwe na RODO. Jeśli Twoi subskrybenci są głównie w UE lub Twoja lista podlega zasadom rezydencji danych RODO, uruchom Listmonk w europejskim centrum danych. Oferujemy lokalizacje we Frankfurcie i Londynie, które spełniają wymogi rezydencji w UE.

Czego potrzebujesz, zanim zaczniesz

Listmonk plus PostgreSQL plus umiarkowane obciążenie kolejki potrzebują minimum 2 GB RAM. 4 GB to komfortowy cel produkcyjny.

Sprzęt. Dla osobistej listy poniżej 50K e-maili miesięcznie wystarczy VPS z 2 vCPU, 4 GB RAM i 120 GB pamięci NVMe. Rosnące listy przy 200K+ miesięcznie potrzebują 4 vCPU i 8 GB RAM. My uruchamiamy tę konfigurację Compose na VPS z 4 GB we Frankfurcie. Wybierz lokalizację blisko swoich subskrybentów, jeśli możesz. Opóźnienie wysyłki nie ma większego znaczenia; ważna jest responsywność panelu administracyjnego.

Domena. Domena wskazująca na Twój VPS przez rekord A. Użyj subdomeny dla interfejsu administracyjnego, na przykład mail.example.com. Domena wysyłkowa i subdomena administracyjna mogą być tą samą domeną główną.

Konto przekaźnika SMTP. Jeszcze go nie zakładaj. Wybór przekaźnika to najbardziej brzemienna w skutki decyzja w tym przewodniku i zależy od Twojego wolumenu. Przejdź do sekcji „Wybór przekaźnika SMTP”, wybierz dostawcę, a potem wróć tutaj z hostem SMTP, portem, nazwą użytkownika i hasłem w ręku.

Oprogramowanie na VPS. Ubuntu 22.04 LTS lub 24.04 LTS. Docker Engine 24.0 lub nowszy z wtyczką Docker Compose. UFW lub równoważny firewall z otwartymi portami 22, 80 i 443. Dostęp SSH jako użytkownik sudo bez uprawnień roota.

Wdrożenie Listmonk z Docker Compose

Utwórz katalog na wdrożenie, a następnie umieść w nim plik docker-compose.yml z dwiema usługami: postgres dla bazy danych i listmonk dla aplikacji. Obie restartują się przy awarii. Listmonk wiąże się z 127.0.0.1 więc odwrotne proxy jest jedynym, co może się do niego dostać.

Plik Docker Compose

I'm ready to translate to Polish. However, it looks like your message got cut off — you wrote "Here is the" but didn't include the text to translate. Please provide the full English text you'd like translated to Polish, and I'll return only the translation. docker-compose.yml. Zweryfikuj dokładne tagi obrazów i nazwy zmiennych środowiskowych względem oficjalnej dokumentacji instalacji Listmonk. Aktualizują się z każdym wydaniem.

# docker-compose.yml
services:
  postgres:
    image: postgres:16-alpine
    container_name: listmonk-postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: listmonk
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: listmonk
    volumes:
      - listmonk-postgres:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U listmonk"]
      interval: 10s
      timeout: 5s
      retries: 6

  app:
    image: listmonk/listmonk:latest
    container_name: listmonk-app
    restart: unless-stopped
    # Bind to loopback only. The reverse proxy is the public entrypoint.
    ports:
      - "127.0.0.1:9000:9000"
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      LISTMONK_app__address: "0.0.0.0:9000"
      LISTMONK_db__host: postgres
      LISTMONK_db__port: 5432
      LISTMONK_db__user: listmonk
      LISTMONK_db__password: ${POSTGRES_PASSWORD}
      LISTMONK_db__database: listmonk

volumes:
  listmonk-postgres:

Utwórz .env plik z POSTGRES_PASSWORD= ustawione na długi losowy ciąg znaków. Następnie uruchom stos i wykonaj jednorazową instalację bazy danych:

# Pull images and start the database first
docker compose up -d postgres

# Run the install step (creates schema and the first admin user)
docker compose run --rm app ./listmonk --install --idempotent --yes

# Start the application
docker compose up -d

Aktualne --install komenda poprosi o e-mail i hasło administratora. Zapisz je. Sprawdź, czy oba kontenery działają:

docker compose ps

Oczekiwany wynik: dwie wymienione usługi, obie ze statusem Up. Wiersz postgres powinien pokazywać (healthy).

Aktualne 127.0.0.1:9000 wiązanie jest celowe. Listmonk nie ma wbudowanego ogranicznika tempa uwierzytelniania ani listy dozwolonych adresów IP. Wystawienie portu 9000 do publicznego internetu oznacza, że każdy na świecie może uderzyć w Twój login administracyjny. Odwrotne proxy sprawia, że ten login jest dostępny tylko przez HTTPS.

Odwrotne proxy Nginx i SSL

Zainstaluj Nginx i Certbot z repozytoriów Ubuntu. Utwórz konfigurację witryny w /etc/nginx/sites-available/listmonk z nagłówkami proxy, których Listmonk potrzebuje do generowania poprawnych linków kampanii:

# /etc/nginx/sites-available/listmonk
server {
    listen 80;
    server_name mail.example.com;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Listmonk streams campaign progress over WebSocket
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Utwórz dowiązanie symboliczne w sites-enabled, przetestuj konfigurację, przeładuj Nginx, a następnie wystaw certyfikat:

sudo ln -s /etc/nginx/sites-available/listmonk /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d mail.example.com

Certbot przepisuje blok serwera, aby nasłuchiwał na porcie 443 z nowym certyfikatem i dodaje przekierowanie z HTTP na HTTPS. Sprawdź:

curl -I https://mail.example.com

Oczekiwany wynik: HTTP/2 200 z prawidłowym nagłówkiem strict-transport-security. Jeśli dostajesz pętlę przekierowań, sprawdź, czy nagłówek X-Forwarded-Proto jest ustawiony w powyższej konfiguracji Nginx. Dziewięć razy na dziesięć pętlę powoduje właśnie ten nagłówek.

Jeśli Listmonk jest jedyną rzeczą na tym VPS, użyj zamiast tego Caddy. Caddyfile ma trzy linie i obsługuje odnawianie certyfikatów bez zadania cron:

mail.example.com {
    reverse_proxy 127.0.0.1:9000
}

Napraw nagłówek Message-ID

Domyślnie Listmonk używa nazwy hosta systemu w wychodzącym nagłówku Message-ID. Jeśli nazwa hosta Twojego VPS to localhost lub cokolwiek, co nie jest prawidłowym FQDN, Listmonk wysyła Message-ID: <[email protected]>. Filtry antyspamowe w Gmailu i Outlooku natychmiast to oznaczają. Jest to udokumentowane w wątku 15410 na forum Cloudron.

Poprawka to jedna linia w config.tomlListmonk. Przy świeżej instalacji wygeneruj plik przez docker compose run --rm app ./listmonk --new-config. Następnie ustaw:

[app]
hostname = "mail.example.com"

Po edycji zrestartuj kontener aplikacji:

docker compose restart app

Zrób to, zanim wyślesz choćby jedną kampanię. Listę skażoną identyfikatorami localhost.localdomain Message-ID trudniej naprawić niż taką, która zaczęła czysto.

Wybór przekaźnika SMTP

Cała wysyłka odbywa się przez skonfigurowany przez Ciebie przekaźnik. To reputacja IP przekaźnika, limity tempa i obsługa odbić decydują o tym, czy Twój e-mail trafi do skrzynki odbiorczej czy do spamu.

Oto porównanie funkcjonalne. Ceny i limity darmowych planów się zmieniają. Zweryfikuj każdy na oficjalnej stronie cennika dostawcy przed podjęciem decyzji.

Dostawca	Struktura kosztów	Webhooki odbić	Najlepszy dla
Amazon SES	Za e-mail, bardzo nisko przy dużym wolumenie	Tak, przez SNS	Koszt przy dużym wolumenie; już na AWS
Postmark	Miesięczna opłata bazowa plus za e-mail	Tak, natywnie	Najpierw dostarczalność; reputacja transakcyjna
Brevo	Darmowy plan dla małego wolumenu, płatne plany powyżej	Tak	Mały wolumen ze ścieżką rozbudowy
Mailgun	Cennik za e-mail	Brak natywnego punktu webhooka; użyj ogólnego API odbić, jeśli potrzeba.	Znajomy deweloperom

To było tylko krótkie spojrzenie na każdy przekaźnik SMTP. Teraz omówimy każdy szczegółowo.

Amazon SES (zalecany punkt startowy)

SES to najtańsza opcja przy dużym wolumenie i najczęściej omawiana w społeczności Listmonk. Konfiguracja ma więcej kroków niż Postmark czy Brevo, ale różnica w koszcie za e-mail jest na tyle duża przy każdym realnym wolumenie, że uzasadnia tę pracę.

Skonfiguruj go w trzech etapach. Po pierwsze, utwórz użytkownika IAM z polityką AmazonSESFullAccess (lub węższą niestandardową polityką tylko z ses:SendRawEmail oraz ses:GetSendQuota). Po drugie, zweryfikuj swoją domenę wysyłkową w konsoli SES. SES przeprowadzi Cię przez dodanie CNAME-ów DKIM. Po trzecie, wygeneruj dane uwierzytelniające SMTP z panelu ustawień SMTP w SES. To nie są Twoje klucze dostępu AWS; SES generuje osobną nazwę użytkownika i hasło specyficzne dla SMTP, gdy klikniesz „Create SMTP credentials”.

W panelu administracyjnym Listmonk w Settings → SMTP dodaj nowy serwer z:

• Host: email-smtp.<region>.amazonaws.com (użyj regionu SES, w którym zweryfikowałeś domenę)
• Port: 587
• Protokół uwierzytelniania: LOGIN
• TLS: STARTTLS
• Nazwa użytkownika i hasło: dane uwierzytelniające SMTP wygenerowane przez SES

SES wymaga STARTTLS na porcie 587. Jeśli zostawisz TLS ustawione na none lub wybierzesz port 465, Listmonk się połączy, SES zwróci 530 Must issue a STARTTLS command first, a test danych uwierzytelniających SMTP w panelu administracyjnym może mimo to pokazać sukces. Wyślij prawdziwy testowy e-mail do osobistej skrzynki, którą kontrolujesz, zanim uruchomisz jakąkolwiek kampanię.

Nowe konta SES zaczynają w trybie sandbox. W sandboxie możesz wysyłać tylko na zweryfikowane adresy e-mail, co jest bezużyteczne dla listy subskrybentów. Otwórz zgłoszenie do wsparcia z konsoli SES, aby poprosić o dostęp produkcyjny. Zatwierdzenie zwykle zajmuje jeden dzień roboczy.

Postmark (alternatywa stawiająca na dostarczalność)

Postmark kosztuje więcej za e-mail niż SES, ale ma natywne wsparcie webhooków odbić i reputację wysokich wskaźników trafienia do skrzynki odbiorczej dzięki rygorystycznym zasadom nadawców. Wart swojej ceny, jeśli Twoje newslettery są krytyczne dla biznesu lub nie chcesz zarządzać przejściem SES z sandboxu do produkcji.

Konfiguracja Listmonk ma ten sam kształt co SES: host, port 587, STARTTLS, dane uwierzytelniające z panelu tokenów API serwera Postmark. Zweryfikuj swoją domenę wysyłkową w konfiguracji podpisu Postmark, dodaj rekordy DKIM, które Postmark generuje, i jesteś gotowy do wysyłki.

Wybierz Postmark, gdy dostarczalność liczy się bardziej niż koszt za e-mail. Wybierz SES, gdy wolumen liczy się bardziej niż dodatkowe ułatwienia.

Ostrzeżenie dotyczące testu danych uwierzytelniających SMTP. Test połączenia w panelu administracyjnym Listmonk zawsze zgłasza sukces, nawet z nieprawidłowymi danymi uwierzytelniającymi. Jest to udokumentowane w kilku zgłoszeniach na GitHubie. Nie ufaj mu. Po skonfigurowaniu dowolnego przekaźnika wyślij kampanię do jednego testowego subskrybenta i potwierdź odbiór w docelowej skrzynce, zanim wyślesz do całej listy.

Unikaj Mailersend do masowej wysyłki kampanii. Jego limit 5 e-maili na połączenie wywołuje błędy 421 Service not available które Listmonk zapisuje jako wysłane, mimo że dostawa się nie powiodła. Kampania wygląda na udaną w Listmonk i porzuca większość swoich wiadomości bez ostrzeżenia.

Aby e-mail faktycznie dotarł: SPF, DKIM i DMARC

To trzy rekordy DNS na Twojej domenie wysyłkowej, które mówią serwerom pocztowym odbiorców, że Twoja domena autoryzowała ten przekaźnik do wysyłki w Twoim imieniu. Pomiń którykolwiek z nich, a znacząca część Twoich wysyłek wyląduje w spamie przy skali, niezależnie od tego, jak czysty jest Twój przekaźnik czy treść. Dodaj je u swojego dostawcy DNS przed wysłaniem pierwszej kampanii.

Rekord SPF

SPF autoryzuje konkretne adresy IP lub usługi wysyłkowe do wysyłania e-maili w imieniu Twojej domeny. Dodaj pojedynczy rekord TXT w korzeniu swojej domeny wysyłkowej z include dla swojego przekaźnika. Dla SES rekord wygląda tak:

v=spf1 include:amazonses.com ~all

Dla Postmark zastąp include wartością include:spf.mtasv.net. Zawsze sprawdzaj oficjalną dokumentację SPF swojego przekaźnika, aby poznać dokładną wartość include. Zmienia się ona w zależności od dostawcy, a czasem od regionu.

Domena może mieć tylko jeden rekord SPF. Jeśli masz już jeden dla innej usługi (Google Workspace, Microsoft 365), scal include z istniejącym rekordem zamiast dodawać drugi.

DKIM

DKIM dołącza kryptograficzny podpis do wychodzących e-maili, który serwery odbiorcze weryfikują względem klucza publicznego w Twoim DNS. Twój przekaźnik generuje parę kluczy. Dodajesz klucz publiczny jako rekord TXT w subdomenie selektora (na przykład sel1._domainkey.example.com) z dokładną wartością, którą podaje przekaźnik.

Listmonk nie obsługuje podpisywania DKIM. Robi to przekaźnik. Nie ma konfiguracji DKIM specyficznej dla Listmonk. Postępuj zgodnie z kreatorem konfiguracji DKIM swojego przekaźnika, dodaj rekordy, które podaje, i poczekaj na propagację DNS (zwykle poniżej 30 minut; czasem kilka godzin).

DMARC

DMARC mówi serwerom odbiorczym, co zrobić z e-mailem, który nie przejdzie kontroli SPF lub DKIM. Zacznij w trybie monitorowania z p=none abyś mógł widzieć niepowodzenia w raportach zbiorczych bez wpływu na dostarczalność, gdy dopracowujesz błędne konfiguracje. Dodaj rekord TXT w _dmarc.example.com:

v=DMARC1; p=none; rua=mailto:[email protected]

Po dwóch lub trzech tygodniach czystych raportów zaostrz politykę do p=quarantine or p=reject. Nie pomijaj fazy monitorowania. Literówka w include SPF połączona z p=reject pierwszego dnia zniszczy Twój własny prawomocny e-mail bez żadnego sygnału, że coś poszło nie tak.

Nagłówek List-Unsubscribe (RFC 8058) jest generowany automatycznie przez Listmonk. Potwierdź, że jest włączony w Settings → General. Gmail i Apple Mail pokazują ten nagłówek jako opcję rezygnacji za jednym kliknięciem, co chroni reputację nadawcy.

Co naprawdę psuje się na produkcji

Cztery tryby awarii, które nie ujawniają się, dopóki nie wyślesz pierwszej prawdziwej kampanii. Wyłap je, zanim zrobią to Twoi subskrybenci.

Problem 1: Wskaźnik odbić nie zgadza się z liczbą przekaźnika. Listmonk przetwarza odbicia, odczytując wyznaczony adres e-mail dla odbić przez POP3 i usuwając każdą odczytaną wiadomość. Obejmuje to odpowiedzi urlopowe, potwierdzenia dostarczenia i powiadomienia o nieobecności, wszystkie sklasyfikowane jako odbicia. Twój przekaźnik liczy tylko prawdziwe niepowodzenia dostawy zwrócone przez serwery pocztowe odbiorców. Jeśli SES raportuje 0,6%, a Listmonk raportuje 4%, to jest ta różnica. Poprawka polega na skonfigurowaniu wywołań zwrotnych webhooków odbić zamiast POP3. Dla SES użyj SNS do dostarczania powiadomień o odbiciach do punktu webhooka Listmonk. Dla Postmark skieruj jego natywny webhook na ten sam punkt. Odbicia z webhooków są dokładne; odbicia z POP3 zawyżają liczby.

Problem 2: Test danych uwierzytelniających SMTP zgłasza sukces, gdy jest błędnie. Jak zauważono w sekcji o przekaźnikach, test połączenia zawsze zgłasza sukces, niezależnie od ważności danych uwierzytelniających. Nie ufaj mu. Zawsze wysyłaj prawdziwy testowy e-mail po skonfigurowaniu lub zmianie dowolnego ustawienia SMTP.

Problem 3: Kampania zatrzymuje się w trakcie wysyłki bez błędu. Listmonk oznacza kampanie jako Finished nawet wtedy, gdy tylko 60% subskrybentów otrzymało e-mail. Pozostałe wysyłki zostały odrzucone przez przekaźnik lub ograniczone na warstwie sieciowej VPS, a Listmonk nie pokazuje żadnej z tych sytuacji jako błędu na poziomie kampanii (wątek 13165 na forum Cloudron). Jeśli kampania pokazuje mniej wysyłek niż subskrybentów, otwórz panel swojego przekaźnika dla okna czasowego wysyłki i porównaj liczbę zaakceptowanych przez przekaźnik z liczbą Listmonk. Prawda jest w przekaźniku.

Problem 4: Nikt nie tworzy kopii zapasowej PostgreSQL. Wolumen Compose zachowuje dane między restartami. Nie chroni przed awarią hosta, przypadkowym docker volume rm ani uszkodzonymi aktualizacjami. Dodaj codzienny pg_dump:

0 2 * * * docker exec listmonk-postgres pg_dump -U listmonk listmonk > /backups/listmonk-$(date +\%Y\%m\%d).sql

Najpierw uruchom tę linię raz ręcznie. Sprawdź, czy plik wyjściowy nie jest pusty, zanim zaufasz wpisowi cron. Skrypt kopii zapasowej, który zapisuje plik o zerowej wielkości bez zgłaszania błędu, jest gorszy niż brak kopii w ogóle, bo przestajesz o nim myśleć.

Zanim zaufasz czemukolwiek z tego na produkcji, wyślij testową kampanię do jednego subskrybenta i potwierdź odbiór w docelowej skrzynce. Jeśli ten jeden e-mail dotrze czysto, kolejne dziesięć tysięcy też dotrze.

Często zadawane pytania

Dlaczego moje wskaźniki odbić w Listmonk są wyższe niż to, co raportuje Amazon SES?

Przetwarzanie odbić przez POP3 w Listmonk zawyża liczby, odczytując odpowiedzi o nieobecności i autorespondery urlopowe jako odbicia. Skonfiguruj wywołania zwrotne webhooka SES SNS dla dokładnych liczb.

Czy Listmonk obsługuje e-maile transakcyjne?

Listmonk to narzędzie do newsletterów i kampanii rozsyłanych. Nie obsługuje natywnie e-maili transakcyjnych (resetów haseł, potwierdzeń zamówień, indywidualnie wyzwalanych e-maili). Dla e-maili transakcyjnych z tej samej domeny wysyłkowej skonfiguruj osobno punkt transakcyjny swojego przekaźnika lub użyj dedykowanego narzędzia, takiego jak Postal albo transakcyjne API Postmark, obok Listmonk.

Jak zaimportować subskrybentów z Mailchimp do Listmonk?

Wyeksportuj swoją listę Mailchimp jako CSV z Audience → Export Audience. W Listmonk przejdź do Subscribers → Import i prześlij plik CSV. Zmapuj kolumny e-mail i nazwy, gdy zostaniesz o to poproszony. Listmonk akceptuje standardowe eksporty CSV z Mailchimp, ConvertKit i większości platform newsletterowych bez konwersji formatu.

Co się dzieje, gdy ktoś rezygnuje z subskrypcji kampanii Listmonk?

Listmonk domyślnie dodaje link rezygnacji do każdego e-maila kampanii. Gdy subskrybent go kliknie, zostaje dodany do listy blokowanych i usunięty ze wszystkich przyszłych kampanii. Nagłówek List-Unsubscribe (RFC 8058) jest dołączany automatycznie, więc klienci pocztowi obsługujący rezygnację jednym kliknięciem (Gmail, Apple Mail) pokazują ją natywnie. Rekord subskrybenta pozostaje w bazie danych do celów audytu, ale żadne dalsze kampanie nie zostaną do niego wysłane.