Email Spam Tester

Email Spam Tester › Email Spam Tester dla cPanel i WHM

Email Spam Tester dla cPanel i WHM

Wtyczka dla dostawców hostingu. Klienci znajdą ją w cPanel w sekcji Email, wyślą prawdziwą wiadomość e-mail z jednej ze swoich skrzynek i otrzymają listę elementów do poprawy. Przy każdym wykrytym problemie zobaczą dokładny rekord DNS lub odpowiedni przycisk w cPanel.

Wersja 0.1.1, 30 września 2026 r. Pobierz (94 KB), SHA-256 4909ff8402b3244711bc13bac96cfc22810ee33d48f80885f87e44809572cdd0. Instrukcja instalacji znajduje się na końcu tej strony, a ten sam tekst jest dostępny w archiwum jako INSTALL.md. Kod źródłowy, testy i wydania są dostępne na GitHub.

Dla kogo jest przeznaczony

Dla firm, które obsługują serwery cPanel & WHM dla innych. Instalujesz go raz jako root, a następnie pojawia się w sekcji cPanel » Email dla wybranych pakietów. Dopóki nie włączysz go w Feature Manager, klienci nie zobaczą niczego nowego.

Bez niego klient, który chce sprawdzić, dlaczego jego wiadomości trafiają do spamu, musi znaleźć narzędzie testujące, otworzyć klienta poczty i ręcznie wysłać wiadomość e-mail. Dzięki niemu test jest dostępny jako przycisk obok skrzynek pocztowych, a wiadomość rzeczywiście jest wysyłana z Twojego serwera, z jego adresem IP, nazwą HELO, podpisem DKIM i przez używany przez niego serwer pośredniczący.

Co otrzymują klienci w cPanel

Test

Klient wybiera skrzynkę pocztową i wysyła standardową wiadomość testową (krótką osobistą wiadomość e-mail w języku angielskim, zawierającą część tekstową i HTML) albo własną wiadomość. W przypadku własnej wiadomości wkleja temat, HTML oraz opcjonalną wersję w zwykłym tekście, a wiadomość jest wysyłana dokładnie w takiej postaci. Exim wysyła ją tak samo jak każdą inną wiadomość z tego konta. Około minutę później na tej samej stronie pojawia się raport ze wszystkimi 42 testami: SPF, DKIM, DMARC i zgodność identyfikatorów, odwrotny DNS i HELO, TLS, listy blokujące IP, SpamAssassin i Rspamd, wymagania dla nadawców publikowane przez Gmail i Yahoo oraz treść. Dostępne są dwie oceny, techniczna w skali do 100 oraz klasyczna od 0 do 10.

Opcja „Sprawdź folder u dostawców poczty” jest domyślnie zaznaczona. Gdy jest włączona, jedna kopia wiadomości trafia również do każdej z naszych skrzynek testowych, łącznie około 30 wiadomości u 14 dostawców, w tym Gmail, Outlook, Yahoo, GMX i Proton. W Gmail są to publiczne skrzynki testowe, w których każdy może zobaczyć temat, nazwę nadawcy i folder. Tabela uzupełnia się przez maksymalnie 30 minut i pokazuje dla każdego dostawcy folder Odebrane, Spam lub Oferty. Jeśli dostawca od razu odrzucił wiadomość, tabela informuje o tym i przytacza odpowiedź jego serwera, wraz z kodem SMTP, pobraną z dziennika Exim na Twoim serwerze.

Pod ocenami znajduje się sekcja Co poprawić. Jeśli DNS domeny znajduje się na Twoim serwerze, cPanel może poprawić DKIM, SPF i DMARC po kliknięciu przycisku. Wtyczka pokazuje rekord w obecnej i przyszłej postaci, a przed zmianą prosi o potwierdzenie. Jeśli DNS jest obsługiwany gdzie indziej, klient otrzymuje dokładny rekord do skopiowania, wraz z jego nazwą, typem i wartością. Odwrotny DNS i własny rekord A serwera znajdują się w osobnej grupie przeznaczonej dla administratora serwera, z uzupełnionymi wartościami. Kilka minut po zakończeniu testów pojawia się pisemny plan od Email Spam Tester, a opcja „Sprawdź ponownie” wysyła nową wiadomość po dodaniu rekordów.

Historia

Wszystkie testy wysłane przez konto, od najnowszego, wraz z datą, skrzynką pocztową, informacją o użytej wiadomości, obiema ocenami i liczbą wiadomości w poszczególnych folderach. Wykres pokazuje zmiany oceny pomiędzy testami. Przy każdym teście wymienione są wyniki, które zmieniły się od poprzedniego testu tej samej domeny, więc jeśli po poprawce wynik testu DKIM zmienił się z negatywnego na pozytywny, widać to bezpośrednio w danym wierszu. Otwarcie testu pokazuje jego raport oraz odpowiedzi serwerów odbiorczych dla każdego dostawcy. Ostatnie 200 testów każdego konta jest przechowywanych na Twoim serwerze.

Stałe monitorowanie

Test wykonany ze skrzynki pocztowej pokazuje, jak wysyłane są wiadomości z tej skrzynki. Typowy problem z cPanel występuje jednak gdzie indziej. Witryna WordPress lub formularz kontaktowy wysyła wiadomość z nadawcą kopertowym user@hostname, zgodność SPF przestaje działać, a żaden test wykonany ze skrzynki pocztowej tego nie pokaże. Monitorowanie tak.

Niewidoczna kopia tworzona podczas monitorowania opuszcza Twój serwer tą samą ścieżką co wiadomość, z tego samego IP, z tym samym HELO i tym samym podpisem DKIM. Exim tworzy ją dla każdej wiadomości wysyłanej przez monitorowaną domenę i dostarcza na prywatny adres należący do tej domeny, dzięki czemu raport opisuje rzeczywistą ścieżkę, a sama wiadomość dociera do odbiorców bez zmian.

Karta Monitorowanie pokazuje wiadomości domeny jako strumień. Każda pozycja zawiera domenę odbiorcy (nigdy adres), źródło wiadomości oraz informacje o nieudanych testach. Źródłami mogą być poczta internetowa, klient poczty, PHP lub WordPress, a także skrypty wywołujące sendmail. Nad strumieniem znajduje się jednowierszowe podsumowanie ostatnich 24 godzin oraz alerty: DKIM przestał przechodzić test, SPF lub DMARC nie działa dla jednego źródła, wysyłający IP znajduje się na liście blokującej albo serwery odbiorcze odrzucają wiadomości. Każdą wiadomość można otworzyć jako raport techniczny z wynikami testów (bez nagłówków wiadomości), a klient może poprosić o przygotowanie dla niej planu przez AI.

Monitorowanie pozostaje wyłączone, dopóki administrator nie zezwoli na nie na serwerze. Następnie każdy klient włącza je osobno dla własnych domen.

Co otrzymujesz w WHM

WHM » Plugins » Email Spam Tester to jedna strona.

Cena

Na razie bezpłatnie, z monitorowaniem w cenie. W email-spam-tester.com nie trzeba zakładać konta i obecnie nie ma żadnych opłat. Jeśli kiedykolwiek się to zmieni, najpierw pojawi się informacja w dzienniku zmian.

Dane i prywatność

Dane wysyłane z Twojego serwera:

Raport z testu działa tak samo jak w serwisie: pozostaje dostępny pod swoim linkiem i może go otworzyć każda osoba mająca ten link, wraz z tematem i nadawcą. Sama wiadomość e-mail jest usuwana godzinę po jej otrzymaniu, gdy wszystkie testy zostaną wykonane. Do tego czasu każda osoba mająca link może przeczytać ją w całości. Część testu folderów dotycząca Gmail również jest publiczna, jak opisano powyżej, dlatego poufne wiadomości lepiej testować bez niej.

Kopie monitorowanych wiadomości są rzeczywistą korespondencją, a ich raporty są prywatne. Może je otworzyć tylko wtyczka na Twoim serwerze, używając klucza instalacji. Nie ma do nich publicznego linku. Kopia jest usuwana dwa dni po jej otrzymaniu, a jej raport po 90 dniach. Historia i kanał monitorowania pozostają na Twoim serwerze.

Pełne zasady znajdziesz na stronie dotyczącej prywatności.

Pytania zadawane przez dostawców hostingu

Czy wtyczka samodzielnie zmienia DNS?

Nie. Rekord jest zmieniany tylko wtedy, gdy klient naciśnie przycisk obok wykrytego problemu i potwierdzi stan przed zmianą oraz po niej, a także tylko wtedy, gdy DNS domeny jest obsługiwany przez Twój serwer. Przyciski SPF i DMARC tworzą wyłącznie brakujący rekord. Jeśli rekord już istnieje, zostaje wyświetlony w scalonej postaci, aby klient mógł skopiować go ręcznie, a przycisk nigdy go nie zastępuje. Przycisk DKIM może zastąpić rekord, który nie jest zgodny z kluczem serwera, ale tylko wtedy, gdy istnieje dokładnie jeden taki rekord. Każda zmiana trafia do dziennika konta oraz do dziennika w katalogu /var/cpanel/email_spam_tester/, który może edytować tylko użytkownik root. Zapisywany jest również rekord DNS udostępniany przed zmianą.

Mój serwer przekazuje pocztę wychodzącą przez smarthost. Czy wtyczka nadal działa?

Powinna działać, ale nie testowałem jej jeszcze za smarthostem. Wiadomość testowa jest wysyłana tą samą drogą co cała poczta z konta, więc raport pokazuje IP i nazwę serwera przekazującego, ponieważ właśnie te dane widzą odbiorcy. Naprawienie jego odwrotnego DNS lub usunięcie go z listy blokującej należy wtedy do operatora serwera przekazującego. Jedna informacja zostaje utracona. Powody odrzucenia wiadomości podawane przez dostawcę pochodzą z dziennika Exim na Twoim serwerze, a przy korzystaniu z serwera przekazującego dziennik ten zawiera tylko jego odpowiedź. Wiadomość zaakceptowana przez serwer przekazujący, a następnie odrzucona przez dostawcę, może zostać oznaczona jako „Nie odebrano”. Kopie monitorujące również przechodzą przez serwer przekazujący.

Czy monitorowanie wpływa na dostarczalność?

Wiadomość klienta jest wysyłana tak jak wcześniej, bez zmian, a jej odbiorcy niczego nie widzą, ponieważ kopia jest osobno dostarczana na nasz adres. Monitorowanie wpływa jednak na godzinowy limit wysyłania. Każda kopia jest liczona jako jedna wiadomość w ramach limitu domeny „max emails per hour”, więc domena zbliżająca się do limitu osiągnie go wcześniej, przy ustawieniu domyślnym najwyżej o 20 wiadomości na godzinę. Po przekroczeniu tej liczby kopii w ciągu godziny wiadomości są wysyłane bez kopii.

Czy sprawdzenie folderów również wlicza się do limitu godzinowego?

Tak, wysyła około 30 wiadomości. Przed rozpoczęciem wtyczka sprawdza, ile wiadomości domena może jeszcze wysłać w tej godzinie, i informuje klienta, jeśli limit jest zbyt niski.

Co przetestowano w działającym środowisku?

Obsługiwana jest wersja cPanel & WHM 134 lub nowsza. Dotychczas przetestowałem w działającym środowisku wersję 138 (11.138) na Ubuntu 24.04. Testy obejmowały instalację i aktualizację, rejestrację, przełącznik funkcji, testy ze sprawdzaniem folderów i bez niego, historię oraz monitorowanie wiadomości ze wszystkich czterech źródeł. Nie przetestowałem jeszcze w działającym środowisku innych systemów operacyjnych, CloudLinux z CageFS, przycisków DKIM, SPF i DMARC (DNS serwera testowego jest obsługiwany gdzie indziej), serwera przekazującego pocztę przez smarthost ani wyłączania monitorowania dla całego serwera, dla którego przeprowadzono jedynie próbę bez wprowadzania zmian. Jeśli uruchomisz wtyczkę w jednym z tych środowisk, chętnie dowiem się, jak przebiegło wdrożenie.

Instalacja krok po kroku

Ten przewodnik zakłada, że masz dostęp root do serwera i nie korzystałeś wcześniej z wtyczek WHM. Każde poniższe polecenie jest przeznaczone do skopiowania i wklejenia bez zmian.

1. Czego potrzebujesz

Przed instalacją możesz sprawdzić oba połączenia. Pierwsze polecenie powinno wyświetlić wiersz zaczynający się od 220, a drugie powinno wyświetlić 200:

timeout 10 bash -c 'exec 3<>/dev/tcp/t.email-spam-tester.com/25 && head -1 <&3'
curl -s -o /dev/null -w '%{http_code}\n' https://email-spam-tester.com/health

2. Instalacja

Zaloguj się przez SSH jako root i uruchom kolejno poniższe polecenia.

Przejdź do katalogu domowego użytkownika root, w którym będzie znajdować się wtyczka:

cd /root

Pobierz archiwum i jego sumę kontrolną. Jeśli wszystko działa, nic nie zostanie wyświetlone:

curl -fsSLO https://email-spam-tester.com/cpanel/latest.tar.gz
curl -fsSLO https://email-spam-tester.com/cpanel/latest.tar.gz.sha256

Sprawdź, czy pobrany plik jest nienaruszony. Powinien pojawić się komunikat latest.tar.gz: OK. Jeśli zobaczysz FAILED, pobierz plik ponownie i nie kontynuuj:

sha256sum -c latest.tar.gz.sha256

Rozpakuj go do /root/email-spam-tester-cpanel. Ponownie nic nie zostanie wyświetlone:

mkdir -p email-spam-tester-cpanel
tar -xzf latest.tar.gz -C email-spam-tester-cpanel --strip-components=1

Uruchom instalator. Najpierw sprawdza wszystkie pliki, a następnie kopiuje je we właściwe miejsca:

cd /root/email-spam-tester-cpanel && ./install.sh

Powinny pojawić się komunikaty Checking Perl syntax…, Root module…, cPanel pages…, kilka wierszy z instalatora wtyczek cPanel, Switching the feature off in all feature lists… oraz WHM page…. Ostatnie wiersze powinny wyglądać tak:

Installed. Next: WHM » Plugins » Email Spam Tester » Register this server.
Customers do not see it yet: turn on email_spam_tester in WHM » Feature Manager
for the feature lists (packages) that should have it.

Zachowaj katalog /root/email-spam-tester-cpanel. Aktualizacje i skrypt uninstall.sh są uruchamiane z tego katalogu.

3. Rejestracja serwera w WHM

  1. Zaloguj się do WHM jako root.
  2. W menu po lewej stronie otwórz Plugins i kliknij Email Spam Tester.
  3. W polu Registration widnieje komunikat "Not registered". Znajdujące się pod nim pole adresu e-mail administratora jest opcjonalne.
  4. Kliknij Register this server.

U góry pojawi się zielony wiersz "Registered. Installation #…", a w polu będzie teraz widoczny status Registered, numer instalacji i początek klucza. Podczas rejestracji wysyłane są: nazwa hosta serwera, wersja cPanel, wersja wtyczki, liczba kont oraz adres e-mail, jeśli został podany. Klucz jest przechowywany w /var/cpanel/email_spam_tester/config.json i może go odczytać tylko root.

Na tej samej stronie możesz zmienić limity dzienne, domyślnie 20 testów na konto i 500 na serwer.

4. Włączenie wtyczki dla klientów

Po instalacji nikt nie widzi wtyczki. Sam wybierasz, w których pakietach będzie dostępna.

  1. Sprawdź, z której listy funkcji korzystają Twoje pakiety: WHM » Packages » Edit a Package, wybierz pakiet i sprawdź pole Feature List. Na wielu serwerach jest to default.
  2. Otwórz WHM » Packages » Feature Manager.
  3. W sekcji Manage feature list wybierz tę listę i kliknij Edit.
  4. Znajdź na liście Email Spam Tester. Jeśli lista jest długa, możesz użyć funkcji wyszukiwania w przeglądarce. Zaznacz pole wyboru i kliknij Save.
  5. Powtórz te czynności dla każdej listy funkcji, na której wtyczka ma być dostępna.

Klienci korzystający z tych pakietów zobaczą teraz Email Spam Tester w sekcji Email w cPanel. Pamiętaj, aby zaznaczyć tę funkcję również na listach funkcji tworzonych później.

5. Wysłanie pierwszego testu jako klient

Zaloguj się do cPanel jako jeden z tych klientów. W WHM możesz użyć Account Information » List Accounts i kliknąć ikonę cPanel obok konta.

  1. Otwórz Email » Email Spam Tester. Strona ma trzy karty: Test, History i Monitoring.
  2. Na karcie Test wybierz skrzynkę pocztową. Jeśli konto nie ma żadnej, utwórz ją najpierw w Email » Email Accounts.
  3. Pozostaw wybraną opcję Standard test email i zaznaczoną opcję Check the folder at email providers.
  4. Kliknij Send test.

Strona pokazuje wykonywane czynności: sprawdzanie rekordów DNS, wysyłanie i oczekiwanie na dostarczenie wiadomości e-mail. Po około minucie pojawi się raport. Zawiera dwa wyniki, techniczny w skali do 100 oraz klasyczny w skali od 0 do 10, a pod nimi sekcję What to fix. Lista zawiera przycisk, którym cPanel może poprawić rekord na tym serwerze, dokładny rekord do skopiowania, jeśli DNS jest obsługiwany gdzie indziej, oraz wartości odwrotnego DNS dla Ciebie jako administratora serwera. Poniżej znajdują się wszystkie wyniki kontroli. Sekcja Where the email landed jest uzupełniana przez kolejne 30 minut informacjami Inbox, Spam lub Promotions dla każdego dostawcy poczty oraz odpowiedzią dostawcy, jeśli odmówił przyjęcia wiadomości. Kilka minut po zakończeniu kontroli pojawi się pisemny plan działania.

Sprawdzanie folderów wysyła około 30 wiadomości e-mail. Jeśli godzinowy limit wysyłania dla domeny jest zbyt niski, strona poinformuje o tym przed wysłaniem czegokolwiek.

6. Stałe monitorowanie (opcjonalne)

Gdy monitorowanie jest włączone dla domeny, Exim wysyła niewidoczną kopię każdej wiadomości wysłanej przez domenę na prywatny adres w Email Spam Tester, a klient otrzymuje raport techniczny każdej wiadomości. Odbiorcy niczego nie widzą. Każda kopia jest liczona jako jedna wiadomość w godzinowym limicie wysyłania domeny, domyślnie maksymalnie 20 kopii na godzinę.

  1. W WHM » Plugins » Email Spam Tester znajdź pole Constant monitoring i kliknij Allow constant monitoring on this server. Wtyczka sprawdza konfigurację Exim, dodaje swoją regułę, przebudowuje i uruchamia ponownie Exim, a jeśli którykolwiek etap się nie powiedzie, przywraca poprzedni stan. Po powodzeniu zobaczysz komunikat "Constant monitoring is allowed on this server: the Exim rule is in, Exim was rebuilt and restarted.", a w polu reguła będzie oznaczona jako Active.
  2. Klient otwiera kartę Monitoring w cPanel, klika Turn on obok domeny i potwierdza. Wiadomości wysłane od tego momentu pojawią się na karcie w ciągu minuty lub dwóch.

Aby wyłączyć monitorowanie dla całego serwera, kliknij Disable monitoring on the whole server w tym samym polu.

7. Aktualizacja

Pobierz i rozpakuj nową wersję w miejscu starej, a następnie ponownie uruchom instalator:

cd /root
curl -fsSLO https://email-spam-tester.com/cpanel/latest.tar.gz
curl -fsSLO https://email-spam-tester.com/cpanel/latest.tar.gz.sha256
sha256sum -c latest.tar.gz.sha256
tar -xzf latest.tar.gz -C email-spam-tester-cpanel --strip-components=1
cd /root/email-spam-tester-cpanel && ./install.sh

Proces powinien zakończyć się komunikatem "Updated. The registration, limits and feature settings are unchanged." Jeśli monitorowanie jest dozwolone, instalator zaktualizuje również regułę Exim.

8. Odinstalowanie

cd /root/email-spam-tester-cpanel && ./uninstall.sh

To polecenie usuwa regułę monitorowania z Exim, wyłącza monitorowanie dla każdej domeny oraz usuwa wtyczkę z cPanel i WHM. Proces kończy się komunikatem "Removed. The key is kept in /var/cpanel/email_spam_tester (use --purge to delete it)." Aby usunąć również klucz, uruchom zamiast tego ./uninstall.sh --purge.

Rekordy DNS nigdy nie są modyfikowane ani usuwane, w tym rekordy utworzone przez klientów za pomocą przycisków wtyczki.

9. Jeśli coś poszło nie tak

Klienci nie widzą ikony. Funkcja jest wyłączona na liście funkcji używanej przez ich pakiet. Powtórz krok 4 i sprawdź, z której listy funkcji faktycznie korzysta ich pakiet.

Na stronie widnieje komunikat "The server administrator has not activated Email Spam Tester in WHM yet". Serwer nie jest zarejestrowany. Wykonaj krok 3.

Rejestracja kończy się niepowodzeniem. Czerwony komunikat u góry strony WHM podaje przyczynę. Najczęściej serwer nie może połączyć się z email-spam-tester.com przez HTTPS. Uruchom test curl z kroku 1, który musi wyświetlić 200, i sprawdź reguły zapory dla ruchu wychodzącego.

Test informuje, że wiadomość nie dotarła w ciągu 3 minut. Wiadomość utknęła w kolejce albo została odrzucona. Uruchom test portu 25 z kroku 1. Jeśli nic nie wyświetla albo przekracza limit czasu, dostawca blokuje wychodzący port 25. Poproś go o odblokowanie portu albo wysyłaj pocztę przez serwer pośredniczący. Aby sprawdzić, co Exim zrobił z wiadomością:

grep 't.email-spam-tester.com' /var/log/exim_mainlog | tail -5

Klient może również sprawdzić skrzynkę w Email » Track Delivery.

Strony pod adresem cpanel.<domain> czasami zwracają błąd 502. Jest to związane z serwerem proxy Apache dla subdomen usług cPanel i dotyczy każdej strony cPanel, nie tylko tej wtyczki. Problem nie występuje pod bezpośrednim adresem https://<domain>:2083. Aby go naprawić, otwórz WHM » Service Configuration » Apache Configuration » Include Editor, wybierz Pre VirtualHost Include dla wszystkich wersji, dodaj poniższe wiersze i zapisz:

<IfModule setenvif_module>
    SetEnvIfNoCase Host "^(cpanel|webmail|whm|webdisk|cpcalendars|cpcontacts)\." proxy-nokeepalive=1 proxy-initial-not-pooled=1
</IfModule>

Następnie zastosuj zmianę:

apachectl configtest && /scripts/rebuildhttpdconf && /scripts/restartsrv_httpd

10. Pomoc

Napisz na adres hi@email-spam-tester.com. Jeśli instalacja się nie powiodła, dołącz dane wyjściowe polecenia ./install.sh. Jeśli wynik testu wygląda nieprawidłowo, dołącz link do raportu. Więcej informacji o wtyczce znajdziesz pod adresem https://email-spam-tester.com/cpanel-integration/.