Email Spam Tester

Email Spam Tester › Email Spam Tester pro cPanel a WHM

Email Spam Tester pro cPanel a WHM

Plugin pro poskytovatele hostingu. Vaši zákazníci ho najdou v cPanel v části Email, odešlou skutečný e-mail z jedné ze svých poštovních schránek a získají seznam toho, co je třeba opravit, včetně přesného DNS záznamu nebo tlačítka v cPanel u každého zjištění.

Verze 0.1.1, 30. září 2026. Stáhnout (94 KB), SHA-256 4909ff8402b3244711bc13bac96cfc22810ee33d48f80885f87e44809572cdd0. Postup instalace najdete na konci této stránky a stejný text je v archivu v souboru INSTALL.md. Zdrojový kód, testy a vydání jsou na GitHub.

Pro koho je určen

Pro společnosti, které provozují servery cPanel & WHM pro jiné uživatele. Nainstalujete ho jednou jako root a zobrazí se v části cPanel » Email u vybraných balíčků. Dokud ho nezapnete ve Feature Manager, zákazníci neuvidí nic nového.

Bez něj musí zákazník, který chce zjistit, proč jeho e-maily končí ve spamu, najít testovací nástroj, otevřít e-mailového klienta a ručně odeslat e-mail. S ním má testovací tlačítko přímo vedle svých e-mailových schránek a e-mail se skutečně odešle z vašeho serveru, s jeho IP, názvem HELO, podpisem DKIM a přesně přes ten relay server, který používáte.

Co zákazníci získají v cPanel

Test

Zákazník vybere poštovní schránku a odešle buď standardní testovací e-mail (krátký osobní e-mail v angličtině s textovou a HTML částí), nebo vlastní zprávu. U vlastní zprávy vloží předmět, HTML a volitelně verzi v prostém textu. Zpráva se odešle přesně v této podobě. Exim ji odešle stejně jako jakýkoli jiný e-mail z daného účtu. Přibližně za minutu se na stejné stránce zobrazí přehled se všemi 42 kontrolami: SPF, DKIM, DMARC a zarovnání, reverzní DNS a HELO, TLS, seznamy blokovaných IP adres, SpamAssassin a Rspamd, požadavky na odesílatele zveřejněné službami Gmail a Yahoo a kontrola obsahu. K dispozici jsou dvě skóre, technické skóre ze 100 a klasické skóre od 0 do 10.

Možnost „Zkontrolovat složku u poskytovatelů e-mailu“ je ve výchozím nastavení zaškrtnutá. Pokud je zapnutá, jedna kopie e-mailu se odešle také do každé z našich testovacích schránek, celkem jde přibližně o 30 e-mailů u 14 poskytovatelů, mezi které patří Gmail, Outlook, Yahoo, GMX a Proton. U Gmail jde o veřejné testovací schránky, kde může kdokoli vidět předmět, jméno odesílatele a složku. Tabulka se postupně vyplňuje po dobu až 30 minut a u každého poskytovatele zobrazuje Doručenou poštu, Spam nebo Promoakce. Pokud poskytovatel e-mail rovnou odmítl, tabulka to uvede a zobrazí odpověď jeho serveru včetně kódu SMTP z protokolu Exim na vašem serveru.

Pod skóre následuje část Co opravit. Pokud je DNS domény na vašem serveru, cPanel může jedním tlačítkem opravit DKIM, SPF a DMARC. Plugin zobrazí aktuální podobu záznamu i podobu po změně a nejprve požádá o potvrzení. Pokud je DNS hostováno jinde, zákazník dostane přesný záznam ke zkopírování včetně jeho názvu, typu a hodnoty. Reverzní DNS a vlastní záznam A serveru jsou v samostatné skupině určené správci serveru a hodnoty jsou předvyplněné. Několik minut po dokončení kontrol následuje písemný plán od Email Spam Tester. Možnost „Zkontrolovat znovu“ po nastavení záznamů odešle nový e-mail.

Historie

Všechny testy odeslané z účtu, od nejnovějšího, s datem, poštovní schránkou, informací o tom, o který e-mail šlo, oběma skóre a počty podle složek. Graf zobrazuje vývoj skóre mezi jednotlivými testy. U každého testu jsou uvedeny kontroly, jejichž výsledek se od předchozího testu stejné domény změnil. Pokud se tedy kontrola DKIM po opravě změnila z neúspěšné na úspěšnou, tato změna je přímo v daném řádku. Po otevření testu se zobrazí jeho přehled a u každého poskytovatele také odpovědi přijímajících serverů. Posledních 200 testů každého účtu se uchovává na vašem serveru.

Průběžné monitorování

Test z poštovní schránky ukazuje, jak se odesílají e-maily z této schránky. Typický problém v cPanel ale vzniká jinde. Web WordPress nebo kontaktní formulář odesílá e-maily s obálkovým odesílatelem user@hostname, zarovnání SPF selže a žádný test z poštovní schránky to neodhalí. Monitorování ano.

Skrytá kopie vytvořená monitorováním opustí váš server stejnou cestou jako původní e-mail, ze stejné IP adresy, se stejným HELO a stejným podpisem DKIM. Exim ji vytvoří pro každý e-mail odeslaný monitorovanou doménou a doručí ji na neveřejnou adresu, která této doméně patří. Přehled proto popisuje skutečnou cestu, zatímco samotný e-mail dorazí příjemcům beze změny.

Karta Monitorování zobrazuje e-maily domény jako přehled událostí. U každého je uvedena doména příjemce (nikdy celá adresa), zdroj e-mailu a neúspěšné kontroly. Zdrojem může být webmail, poštovní klient, PHP nebo WordPress a skripty volající sendmail. Nad přehledem je jednořádkový souhrn za posledních 24 hodin a upozornění: DKIM přestal procházet, SPF nebo DMARC selhává u jednoho zdroje, odesílající IP adresa je na seznamu blokovaných adres nebo přijímající servery odmítají e-maily. Každý e-mail lze otevřít jako technický přehled jeho kontrol (hlavičky e-mailu nejsou zahrnuty) a zákazník si k němu může vyžádat plán od AI.

Monitorování zůstává vypnuté, dokud je správce na serveru nepovolí. Poté si je každý zákazník zapne pro své vlastní domény.

Co získáte ve WHM

WHM » Plugins » Email Spam Tester je jedna stránka.

Cena

Zatím zdarma, včetně monitorování. Na email-spam-tester.com si nemusíte vytvářet účet a v tuto chvíli nemusíte nic platit. Pokud se to někdy změní, dozvíte se to nejdříve v přehledu změn.

Data a soukromí

Co opouští váš server:

Testovací report funguje stejně jako na webu: zůstává dostupný na svém odkazu a může ho otevřít kdokoli, kdo má odkaz, včetně předmětu a odesílatele. Samotný e-mail se odstraní hodinu po přijetí, jakmile proběhnou jeho kontroly. Do té doby si ho může v plném znění přečíst kdokoli, kdo má odkaz. Část kontroly složek pro Gmail je také veřejná, jak je popsáno výše, proto je lepší důvěrné e-maily testovat bez ní.

Kopie pro monitorování jsou skutečná korespondence a jejich reporty jsou soukromé. Otevřít je může pouze plugin na vašem serveru pomocí instalačního klíče. Veřejný odkaz neexistuje. Kopie se odstraní dva dny po přijetí a její report po 90 dnech. Historie a přehled monitorování zůstávají na vašem serveru.

Úplné zásady najdete na stránce o soukromí.

Otázky poskytovatelů hostingu

Mění plugin DNS automaticky?

Ne. Záznam se změní pouze tehdy, když zákazník stiskne tlačítko vedle zjištěného problému a potvrdí původní a nový stav, a jen pokud váš server hostuje DNS dané domény. Tlačítka SPF a DMARC pouze vytvoří chybějící záznam. Existující záznam se zobrazí ve sloučené podobě, aby jej zákazník mohl ručně zkopírovat, a tlačítko jej nikdy nenahradí. Tlačítko DKIM může nahradit záznam, který neodpovídá klíči serveru, ale pouze pokud existuje právě jeden. Každá změna se zapíše do protokolu účtu a také do protokolu v adresáři /var/cpanel/email_spam_tester/, který může upravovat pouze root. Spolu se změnou se uloží i záznam, který DNS poskytovalo před ní.

Můj server odesílá poštu přes smarthost. Bude plugin fungovat i tak?

Měl by, ale za smarthostem jsem jej zatím netestoval. Testovací e-mail se odešle stejným způsobem jako veškerá pošta z daného účtu, takže report zobrazí IP a název relay serveru, protože právě ty vidí příjemci. Oprava jeho reverzního DNS nebo odstranění ze seznamu blokovaných adres je pak úkolem provozovatele relay serveru. Jedna informace se však ztratí. Důvody, které poskytovatel uvede při odmítnutí e-mailu, pocházejí z protokolu Exim na vašem serveru. Při použití relay serveru tento protokol obsahuje pouze jeho odpověď. E-mail, který relay server přijal a poskytovatel později odmítl, se proto může zobrazit jako „Nepřijato“. Přes relay server procházejí také monitorovací kopie.

Ovlivňuje monitorování doručitelnost?

E-mail zákazníka se odešle beze změny stejně jako dříve a jeho příjemci nic neuvidí, protože kopie představuje samostatné doručení na naši adresu. Monitorování ale ovlivňuje hodinový limit odesílání. Každá kopie se jednou započítá do limitu domény „max emails per hour“, takže doména blízko svého limitu jej dosáhne dříve, při výchozím nastavení nejvýše o 20 e-mailů za hodinu. Po dosažení tohoto počtu kopií za hodinu se e-maily odesílají bez kopie.

Započítává se do hodinového limitu také kontrola složek?

Ano, odešle přibližně 30 e-mailů. Před spuštěním plugin zkontroluje, kolik e-mailů může doména v dané hodině ještě odeslat, a pokud to nestačí, upozorní zákazníka.

Co bylo otestováno v reálném provozu?

Podporovány jsou cPanel & WHM 134 a novější. Zatím jsem plugin otestoval v reálném provozu ve verzi 138 (11.138) na Ubuntu 24.04. Test zahrnoval instalaci a upgrade, registraci, přepínač funkce, testy s kontrolou složek i bez ní, historii a monitorování e-mailů ze všech čtyř zdrojů. V reálném provozu zatím nebyly otestovány ostatní operační systémy, CloudLinux s CageFS, tlačítka DKIM, SPF a DMARC (DNS testovacího serveru je hostováno jinde), server odesílající přes smarthost a vypnutí monitorování pro celý server, které bylo pouze vyzkoušeno nanečisto. Pokud plugin provozujete v některém z těchto prostředí, rád se dozvím, jak to dopadlo.

Instalace krok za krokem

Tento návod předpokládá, že máte na serveru přístup root a dosud jste nepoužívali pluginy WHM. Každý níže uvedený příkaz je určen ke zkopírování a vložení beze změn.

1. Co potřebujete

Před instalací můžete zkontrolovat obě připojení. První příkaz by měl vypsat řádek začínající 220, druhý by měl vypsat 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. Instalace

Přihlaste se přes SSH jako root a spusťte postupně následující příkazy.

Přejděte do domovského adresáře uživatele root, kde bude plugin uložen:

cd /root

Stáhněte archiv a jeho kontrolní součet. Při úspěšném provedení se nic nevypíše:

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

Zkontrolujte, zda je stažený soubor neporušený. Měli byste vidět latest.tar.gz: OK. Pokud uvidíte FAILED, stáhněte ho znovu a nepokračujte:

sha256sum -c latest.tar.gz.sha256

Rozbalte ho do /root/email-spam-tester-cpanel. Opět se nic nevypíše:

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

Spusťte instalační program. Nejprve zkontroluje všechny soubory a potom je zkopíruje na příslušná místa:

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

Měli byste vidět Checking Perl syntax…, Root module…, cPanel pages…, několik řádků z instalačního programu pluginů cPanel, Switching the feature off in all feature lists… a WHM page…. Poslední řádky by měly být:

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.

Adresář /root/email-spam-tester-cpanel ponechte na místě. Spouštějí se z něj aktualizace a uninstall.sh.

3. Registrace serveru ve WHM

  1. Přihlaste se do WHM jako root.
  2. V levé nabídce otevřete Plugins a klikněte na Email Spam Tester.
  3. V poli Registrace je uvedeno „Not registered“. Pole pro e-mail správce pod ním je nepovinné.
  4. Klikněte na Registrovat tento server.

Nahoře se zobrazí zelený řádek „Registered. Installation #…“ a v poli je nyní uveden stav Registered, číslo instalace a začátek klíče. Při registraci se odesílá název hostitele serveru, verze cPanel, verze pluginu, počet účtů a e-mail, pokud jste ho zadali. Klíč je uložen v /var/cpanel/email_spam_tester/config.json a může ho číst pouze root.

Na stejné stránce můžete změnit denní limity. Ve výchozím nastavení je to 20 testů na účet a 500 na server.

4. Zapnutí pro zákazníky

Po instalaci plugin nikdo nevidí. Vyberete, které balíčky k němu budou mít přístup.

  1. Zjistěte, který seznam funkcí vaše balíčky používají: WHM » Packages » Edit a Package, vyberte balíček a podívejte se na pole Feature List. Na mnoha serverech je to default.
  2. Otevřete WHM » Packages » Feature Manager.
  3. V části Manage feature list vyberte daný seznam a klikněte na Edit.
  4. Najděte v seznamu Email Spam Tester (pokud je seznam dlouhý, pomůže funkce hledání v prohlížeči), zaškrtněte jeho políčko a klikněte na Save.
  5. Opakujte postup pro každý seznam funkcí, ve kterém má být plugin dostupný.

Zákazníci s těmito balíčky nyní uvidí Email Spam Tester v cPanel v části Email. Nezapomeňte ho zaškrtnout také v seznamech funkcí, které vytvoříte později.

5. Odeslání prvního testu jako zákazník

Přihlaste se do cPanel jako jeden z těchto zákazníků. Ve WHM můžete použít Account Information » List Accounts a ikonu cPanel vedle účtu.

  1. Otevřete Email » Email Spam Tester. Stránka má tři karty: Test, Historie a Monitorování.
  2. Na kartě Test vyberte e-mailovou schránku. Pokud účet žádnou nemá, vytvořte ji nejprve v části Email » Email Accounts.
  3. Ponechte vybranou možnost Standardní testovací e-mail a zaškrtnutou možnost Zkontrolovat složku u poskytovatelů e-mailu.
  4. Klikněte na Odeslat test.

Stránka ukazuje, co právě probíhá: kontrolu DNS záznamů, odesílání a čekání na doručení e-mailu. Přibližně po minutě se zobrazí zpráva. Obsahuje dvě skóre, technické skóre ze 100 a klasické skóre od 0 do 10, a pod nimi část Co opravit. Tento seznam obsahuje tlačítko, pokud může cPanel opravit záznam na tomto serveru, přesný záznam ke zkopírování, pokud je DNS hostován jinde, a hodnoty reverzního DNS pro vás jako správce serveru. Potom následují všechny kontroly. Část Kam byl e-mail doručen se během následujících 30 minut doplní o složky Inbox, Spam nebo Promotions u jednotlivých poskytovatelů pošty a o odpověď poskytovatele, pokud e-mail odmítl. O několik minut později se zobrazí písemný plán.

Kontrola složek odešle přibližně 30 e-mailů. Pokud pro ně v hodinovém limitu odesílání domény není dostatek místa, stránka vás na to upozorní před odesláním čehokoli.

6. Průběžné monitorování (volitelné)

Když je pro doménu zapnuté monitorování, Exim odešle neviditelnou kopii každého e-mailu odeslaného z domény na soukromou adresu v Email Spam Tester a zákazník uvidí technickou zprávu ke každému e-mailu. Příjemci nic neuvidí. Každá kopie se jednou započítá do hodinového limitu odesílání domény, ve výchozím nastavení nejvýše 20 kopií za hodinu.

  1. V části WHM » Plugins » Email Spam Tester najděte pole Průběžné monitorování a klikněte na Povolit průběžné monitorování na tomto serveru. Plugin zkontroluje konfiguraci Exim, přidá své pravidlo, znovu sestaví a restartuje Exim. Pokud některý krok selže, vrátí vše do původního stavu. Po úspěšném dokončení uvidíte „Constant monitoring is allowed on this server: the Exim rule is in, Exim was rebuilt and restarted.“ a v poli bude pravidlo označeno jako Active.
  2. Zákazník otevře kartu Monitorování v cPanel, klikne na Zapnout vedle domény a volbu potvrdí. E-maily odeslané od tohoto okamžiku se na kartě zobrazí během jedné až dvou minut.

Chcete-li monitorování zastavit pro celý server, klikněte ve stejném poli na Zakázat monitorování na celém serveru.

7. Aktualizace

Stáhněte a rozbalte novou verzi přes starou verzi a potom znovu spusťte instalační program:

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

Výstup by měl končit textem „Updated. The registration, limits and feature settings are unchanged.“ Pokud je monitorování povoleno, instalační program také aktualizuje pravidlo Exim.

8. Odinstalace

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

Tento příkaz odebere pravidlo monitorování z Exim, vypne monitorování pro každou doménu a odstraní plugin z cPanel a WHM. Výstup končí textem „Removed. The key is kept in /var/cpanel/email_spam_tester (use --purge to delete it).“ Pokud chcete odstranit také klíč, spusťte místo toho ./uninstall.sh --purge.

DNS záznamy se nikdy nemění ani neodstraňují, včetně záznamů, které zákazníci vytvořili pomocí tlačítek pluginu.

9. Pokud se něco nepovedlo

Zákazníci nevidí ikonu. Funkce je vypnutá v seznamu funkcí jejich balíčku. Zopakujte krok 4 a zkontrolujte, který seznam funkcí jejich balíček skutečně používá.

Na stránce se zobrazuje „The server administrator has not activated Email Spam Tester in WHM yet“. Server není zaregistrován. Proveďte krok 3.

Registrace selže. Červená zpráva v horní části stránky WHM uvádí důvod. Nejčastěji se server nemůže připojit k email-spam-tester.com přes HTTPS. Spusťte kontrolu pomocí curl z kroku 1, která musí vypsat 200, a zkontrolujte pravidla firewallu pro odchozí provoz.

Test uvádí, že zpráva nebyla doručena do 3 minut. E-mail uvízl ve frontě nebo byl odmítnut. Spusťte kontrolu portu 25 z kroku 1. Pokud nic nevypíše nebo vyprší časový limit, váš poskytovatel blokuje odchozí port 25. Požádejte ho o otevření portu nebo odesílejte poštu přes relay. Chcete-li zjistit, co Exim s e-mailem udělal:

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

Zákazník se může pro danou schránku podívat také do části Email » Track Delivery.

Stránky na cpanel.<domain> někdy selžou s chybou 502. Jde o proxy Apache pro subdomény služeb cPanel a problém se týká všech stránek cPanel, nejen tohoto pluginu. Přímé adresy https://<domain>:2083 se problém netýká. Chcete-li ho opravit, otevřete WHM » Service Configuration » Apache Configuration » Include Editor, vyberte Pre VirtualHost Include pro všechny verze, přidejte následující řádky a uložte změny:

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

Potom je použijte:

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

10. Podpora

Napište na hi@email-spam-tester.com. Pokud instalace selhala, přiložte výstup příkazu ./install.sh. Pokud výsledek testu vypadá nesprávně, přiložte odkaz na zprávu. Další informace o pluginu najdete na https://email-spam-tester.com/cpanel-integration/.