Listmonk z funkcją przekazywania wiadomości e-mail w celu bezpiecznego dostarczania newsletterów

Ten przewodnik zawiera instrukcje krok po kroku dla programistów dotyczące konfiguracji Listmonk, potężnego menedżera newsletterów i list mailingowych typu open source, do korzystania z Przekaż dalej e-mail jako dostawcy SMTP. Ta kombinacja pozwala efektywnie zarządzać kampaniami, zapewniając jednocześnie bezpieczne, prywatne i niezawodne dostarczanie wiadomości e-mail.

• Listmonk: Zarządza subskrybentami, organizuje listy, tworzy kampanie i śledzi wyniki.
• Forward Email: Działa jako bezpieczny serwer SMTP, obsługując wysyłanie wiadomości e-mail z wbudowanymi funkcjami bezpieczeństwa, takimi jak SPF, DKIM, DMARC i szyfrowanie TLS.

Integrując te dwa rozwiązania, zachowujesz pełną kontrolę nad swoimi danymi i infrastrukturą, jednocześnie wykorzystując niezawodny system dostarczania wiadomości e-mail Forward Email.

• Open Source: Zarówno Listmonk, jak i zasady stojące za Forward Email kładą nacisk na przejrzystość i kontrolę. Sam hostujesz Listmonk, będąc właścicielem swoich danych.
• Skupiony na prywatności: Forward Email został stworzony z myślą o prywatności, minimalizując retencję danych i koncentrując się na bezpiecznej transmisji.
• Ekonomiczny: Listmonk jest darmowy, a Forward Email oferuje hojne pakiety bezpłatne i przystępne plany płatne, co czyni go rozwiązaniem przyjaznym dla budżetu.
• Skalowalność: Listmonk jest wysoce wydajny, a infrastruktura Forward Email została zaprojektowana z myślą o niezawodnym dostarczaniu w dużej skali.
• Przyjazny dla programistów: Listmonk oferuje solidne API, a Forward Email zapewnia prostą integrację SMTP i webhooki.

Zanim zaczniesz, upewnij się, że masz następujące rzeczy:

• Wirtualny serwer prywatny (VPS) z najnowszą dystrybucją Linuksa (zalecany Ubuntu 20.04+) z co najmniej 1 procesorem i 1 GB pamięci RAM (zalecane 2 GB).
• Potrzebujesz dostawcy? Sprawdź zalecana lista VPS.
• Nazwa domeny, którą kontrolujesz (wymagany dostęp DNS).
• Aktywne konto z Przekaż dalej e-mail.
• Dostęp root lub sudo do Twojego VPS.
• Podstawowa znajomość operacji wiersza poleceń Linuksa.

Poniższe kroki przeprowadzą Cię przez proces instalacji Listmonk za pomocą Dockera i Docker Compose na Twoim VPS.

1. Zaktualizuj swój serwer

Upewnij się, że lista pakietów systemu i zainstalowane pakiety są aktualne.

sudo apt update && sudo apt upgrade -y

2. Zainstaluj zależności

Zainstaluj Docker, Docker Compose i UFW (Uncomplicated Firewall).

sudo apt install -y docker.io docker-compose ufw

3. Pobierz konfigurację Listmonk

Utwórz katalog dla Listmonk i pobierz oficjalny plik docker-compose.yml.

mkdir listmonk && cd listmonk
curl -Lo docker-compose.yml https://raw.githubusercontent.com/knadh/listmonk/master/docker-compose.yml

Ten plik definiuje kontener aplikacji Listmonk i wymagany kontener bazy danych PostgreSQL.

4. Skonfiguruj zaporę sieciową (UFW)

Zezwól na niezbędny ruch (SSH, HTTP, HTTPS) przez zaporę sieciową. Jeśli Twój SSH działa na niestandardowym porcie, dostosuj go odpowiednio.

sudo ufw allow ssh
sudo ufw allow http
sudo ufw allow https
sudo ufw enable

Potwierdź włączenie zapory, gdy zostaniesz o to poproszony.

5. Konfigurowanie dostępu HTTPS

Uruchamianie Listmonka przez HTTPS jest kluczowe dla bezpieczeństwa. Masz dwie podstawowe opcje:

Opcja A: Korzystanie z serwera proxy Cloudflare (zalecane ze względu na prostotę)

Jeśli serwerem DNS Twojej domeny zarządza Cloudflare, możesz wykorzystać funkcję serwera proxy tej firmy, aby łatwo nawiązać połączenie HTTPS.

1. Wskaż DNS: Utwórz rekord A w Cloudflare dla swojej subdomeny Listmonk (np. listmonk.yourdomain.com) wskazujący na adres IP Twojego VPS. Upewnij się, że Status proxy jest ustawiony na Zalogowany przez proxy (pomarańczowa chmurka).
2. Modyfikuj Docker Compose: Edytuj pobrany plik docker-compose.yml:

   sed -i 's/9000:9000/80:9000/' docker-compose.yml

Dzięki temu Listmonk będzie dostępny wewnętrznie na porcie 80, który Cloudflare może następnie przekierować i zabezpieczyć za pomocą protokołu HTTPS.

Opcja B: Korzystanie z odwrotnego serwera proxy (Nginx, Caddy itp.)

Alternatywnie możesz skonfigurować odwrotny serwer proxy, taki jak Nginx lub Caddy na swoim VPS, który będzie obsługiwał zakończenie protokołu HTTPS i żądania proxy kierowane do Listmonk (domyślnie działającego na porcie 9000).

• Zachowaj domyślną wartość ports: - "127.0.0.1:9000:9000" w docker-compose.yml, aby zapewnić dostęp do Listmonka tylko lokalnie.
• Skonfiguruj wybrany serwer proxy odwrotnego, aby nasłuchiwał na portach 80 i 443, obsługiwał pozyskiwanie certyfikatów SSL (np. za pośrednictwem Let's Encrypt) i przekierowywał ruch do http://127.0.0.1:9000.
• Szczegółowa konfiguracja serwera proxy odwrotnego wykracza poza zakres tego przewodnika, ale wiele samouczków jest dostępnych online.

6. Uruchom Listmonk

Wróć do katalogu listmonk (jeśli jeszcze tam nie jesteś) i uruchom kontenery w trybie odłączonym.

cd ~/listmonk # Or the directory where you saved docker-compose.yml
docker compose up -d

Docker pobierze niezbędne obrazy i uruchomi aplikację Listmonk oraz kontenery bazy danych. Za pierwszym razem może to potrwać minutę lub dwie.

✅ Dostęp do Listmonk: Teraz powinieneś mieć możliwość uzyskania dostępu do interfejsu internetowego Listmonk za pośrednictwem skonfigurowanej domeny (np. https://listmonk.yourdomain.com).

7. Skonfiguruj przekazywanie wiadomości e-mail SMTP w Listmonk

Następnie skonfiguruj Listmonk tak, aby wysyłał wiadomości e-mail za pomocą konta Forward Email.

1. Włącz SMTP w przekierowaniu poczty: Upewnij się, że wygenerowałeś dane uwierzytelniające SMTP w panelu konta przekierowania poczty. Postępuj zgodnie z Przewodnik po przesyłaniu wiadomości e-mail z niestandardową domeną przez SMTP, jeśli jeszcze tego nie zrobiłeś.
2. Skonfiguruj Listmonk: Zaloguj się do panelu administracyjnego Listmonk.

• Przejdź do Ustawienia -> SMTP.

• Listmonk ma wbudowaną obsługę przekazywania wiadomości e-mail. Wybierz Przekaż dalej wiadomość e-mail z listy dostawców lub ręcznie wprowadź następujące dane:

• Ważne: Zawsze używaj portu 465 z SSL/TLS do bezpiecznych połączeń z funkcją Forward Email. Nie używaj protokołu STARTTLS (port 587).

• Kliknij Zapisz.

3. Wyślij testowy e-mail: Użyj przycisku „Wyślij testowy e-mail” na stronie ustawień SMTP. Wprowadź adres odbiorcy, do którego masz dostęp, i kliknij Wyślij. Sprawdź, czy e-mail dotarł do skrzynki odbiorczej odbiorcy.

8. Konfigurowanie przetwarzania zwrotów

Przetwarzanie zwrotów pozwala Listmonkowi automatycznie obsługiwać wiadomości e-mail, które nie mogły zostać dostarczone (np. z powodu nieprawidłowego adresu). Funkcja Forward Email udostępnia webhook do powiadamiania Listmonka o zwrotach.

Konfiguracja przekazywania wiadomości e-mail

1. Zaloguj się do Panel przekazywania wiadomości e-mail.
2. Przejdź do sekcji Domeny, wybierz domenę, której używasz do wysyłania wiadomości i przejdź do jej strony Ustawienia.
3. Przewiń w dół do sekcji Adres URL webhooka Bounce.
4. Wprowadź poniższy adres URL, zastępując <your_listmonk_domain> rzeczywistą domeną lub subdomeną, w której dostępna jest Twoja instancja Listmonk:

   https://<your_listmonk_domain>/webhooks/service/forwardemail

Przykład: https://listmonk.yourdomain.com/webhooks/service/forwardemail 5. Przewiń w dół do sekcji Klucz weryfikacji podpisu ładunku webhooka. 6. Skopiuj wygenerowany klucz weryfikacyjny. Będzie potrzebny w Listmonk. 7. Zapisz zmiany w ustawieniach domeny Forward Email.

Konfiguracja Listmonka

1. W panelu administracyjnym Listmonk przejdź do Ustawienia -> Odsyłanie.
2. Włącz opcję Włącz przetwarzanie odsyłania.
3. Włącz opcję Włącz webhooki odsyłania.
4. Przewiń w dół do sekcji Dostawcy webhooków.
5. Włącz opcję Przekazuj e-maile.
6. Wklej Klucz weryfikacji podpisu webhooka skopiowany z pulpitu nawigacyjnego Przekazuj e-maile w pole Klucz przekazu e-mail.
7. Kliknij Zapisz na dole strony.
8. Przetwarzanie odsyłania jest teraz skonfigurowane! Gdy funkcja Przekazuj e-maile wykryje odsyłanie dla wiadomości e-mail wysłanej przez Listmonk, powiadomi ona Twoją instancję Listmonk za pośrednictwem webhooka, a Listmonk odpowiednio oznaczy subskrybenta.
9. Wykonaj poniższe kroki w Testowanie, aby upewnić się, że wszystko działa poprawnie.

Oto krótki przegląd podstawowych funkcji Listmonka:

Utwórz listę mailingową

• Przejdź do zakładki Listy na pasku bocznym.
• Kliknij Nowa lista.
• Uzupełnij szczegóły (nazwa, typ: publiczna/prywatna, opis, tagi) i Zapisz.

Dodaj subskrybentów

• Przejdź do sekcji Subskrybenci.
• Możesz dodać subskrybentów:
• Ręcznie: Kliknij Nowy subskrybent.
• Import: Kliknij Importuj subskrybentów, aby przesłać plik CSV.
• API: Użyj API Listmonk do programowego dodawania.
• Przypisz subskrybentów do jednej lub kilku list podczas tworzenia lub importowania.
• Najlepsza praktyka: Użyj procesu podwójnej zgody. Skonfiguruj to w Ustawienia -> Zgoda i subskrypcje.

Utwórz i wyślij kampanię

• Przejdź do Kampanie -> Nowa kampania.
• Uzupełnij szczegóły kampanii (nazwa, temat, adres e-mail od odbiorcy, lista(y) do wysłania).
• Wybierz typ treści (Rich Text/HTML, zwykły tekst, Raw HTML).
• Utwórz treść e-maila. Możesz użyć zmiennych szablonu, takich jak {{ .Subscriber.Email }} lub {{ .Subscriber.FirstName }}.
• Zawsze najpierw wysyłaj e-mail testowy! Użyj opcji „Wyślij test”, aby wyświetlić podgląd wiadomości w skrzynce odbiorczej.
• Po zakończeniu kliknij Rozpocznij kampanię, aby wysłać ją natychmiast lub zaplanować na później.

• Dostarczanie SMTP: Regularnie wysyłaj testowe e-maile za pośrednictwem strony ustawień SMTP w Listmonk i testuj kampanie, aby upewnić się, że e-maile są dostarczane poprawnie.
• Obsługa zwrotów: Wyślij testową kampanię na znany, nieprawidłowy adres e-mail (np. bounce-test@yourdomain.com, jeśli nie masz pod ręką prawdziwego, choć wyniki mogą się różnić). Po chwili sprawdź statystyki kampanii w Listmonk, aby upewnić się, że zwrot został zarejestrowany.
• Nagłówki e-maili: Użyj narzędzi takich jak Tester poczty lub ręcznie sprawdź nagłówki e-maili, aby upewnić się, że SPF, DKIM i DMARC są poprawne, co wskazuje na poprawną konfigurację funkcji przekazywania wiadomości e-mail.
• Dzienniki przekazywania wiadomości e-mail: Sprawdź dzienniki panelu przekazywania wiadomości e-mail, jeśli podejrzewasz problemy z dostarczaniem pochodzące z serwera SMTP.

• Szablony: Listmonk korzysta z silnika szablonów Go. Zapoznaj się z dokumentacją, aby uzyskać informacje o zaawansowanej personalizacji: {{ .Subscriber.Attribs.your_custom_field }}.
• API: Listmonk oferuje kompleksowe API REST do zarządzania listami, subskrybentami, kampaniami, szablonami i nie tylko. Link do dokumentacji API znajdziesz w stopce swojej instancji Listmonk.
• Pola niestandardowe: Zdefiniuj pola niestandardowe subskrybentów w Ustawienia -> Pola subskrybentów, aby przechowywać dodatkowe dane.
• Webhooki: Oprócz odrzuceń, Listmonk może wysyłać webhooki dla innych zdarzeń (np. subskrypcji), umożliwiając integrację z innymi systemami.

Łącząc możliwości samodzielnego hostingu Listmonk z bezpieczną i chroniącą prywatność funkcją Forward Email, tworzysz solidną i etyczną platformę do marketingu e-mailowego. Zachowujesz pełną kontrolę nad danymi swoich odbiorców, jednocześnie korzystając z wysokiej skuteczności dostarczania wiadomości i zautomatyzowanych funkcji bezpieczeństwa.

Taka konfiguracja zapewnia skalowalną, ekonomiczną i przyjazną dla deweloperów alternatywę dla zastrzeżonych usług poczty e-mail, idealnie wpisując się w ideę otwartego oprogramowania i prywatności użytkowników.

Szczęśliwego wysyłania! 🚀