Email Spam Tester

Email Spam Tester › Email Spam Tester för cPanel & WHM

Email Spam Tester för cPanel & WHM

Ett tillägg för webbhotell. Dina kunder hittar det i cPanel under Email, skickar ett riktigt e-postmeddelande från en av sina brevlådor och får en lista över vad som behöver åtgärdas, med den exakta DNS-posten eller cPanel-knappen bredvid varje resultat.

Version 0.1.1, 30 september 2026. Ladda ner (94 KB), SHA-256 4909ff8402b3244711bc13bac96cfc22810ee33d48f80885f87e44809572cdd0. Installationsstegen finns i slutet av den här sidan, och samma text finns som INSTALL.md i arkivet. Källkod, tester och versioner finns på GitHub.

Vem det är till för

Företag som driver cPanel & WHM-servrar åt andra. Du installerar det en gång som root, sedan visas det under cPanel » Email för de paket du väljer. Tills du aktiverar det i Feature Manager ser kunderna inget nytt.

Utan det måste en kund som vill veta varför deras e-post hamnar i skräpposten hitta ett testverktyg, öppna en e-postklient och skicka ett meddelande manuellt. Med det finns testet som en knapp bredvid kundens e-postlådor, och meddelandet skickas faktiskt från din server, med dess IP, HELO-namn, DKIM-signatur och den relätjänst det går genom.

Vad kunderna får i cPanel

Test

Kunden väljer en brevlåda och skickar antingen standardtestmeddelandet (ett kort personligt meddelande på engelska, med en textdel och en HTML-del) eller ett eget meddelande. För ett eget meddelande klistrar kunden in ett ämne, HTML-innehållet och en valfri version i klartext. Meddelandet skickas exakt som det klistrades in. Exim skickar det som vilket annat meddelande som helst från kontot. Ungefär en minut senare visas rapporten på samma sida med alla 42 kontroller: SPF, DKIM, DMARC och alignment, omvänd DNS och HELO, TLS, IP-blockeringslistor, SpamAssassin och Rspamd, de avsändarkrav som Gmail och Yahoo publicerar samt innehållet. Det finns två poäng: en teknisk poäng av 100 och den klassiska poängen från 0 till 10.

"Kontrollera mappen hos e-postleverantörer" är markerat som standard. När alternativet är markerat skickas även en kopia av meddelandet till var och en av våra testbrevlådor, omkring 30 meddelanden hos 14 leverantörer, däribland Gmail, Outlook, Yahoo, GMX och Proton. Hos Gmail är dessa offentliga testbrevlådor där vem som helst kan se ämnet, avsändarnamnet och mappen. Tabellen fylls i under upp till 30 minuter och visar Inkorgen, Skräppost eller Kampanjer för varje leverantör. Om en leverantör avvisade meddelandet direkt anges detta i tabellen tillsammans med det exakta svaret från leverantörens server, inklusive SMTP-koden, hämtat från Exims logg på din server.

Under poängen visas Vad som behöver åtgärdas. Om domänens DNS finns på din server kan cPanel åtgärda DKIM, SPF och DMARC med en knapp. Insticksprogrammet visar posten som den ser ut nu och hur den kommer att se ut samt ber först om bekräftelse. Om DNS finns hos en annan leverantör får kunden den exakta posten att kopiera, inklusive namn, typ och värde. Omvänd DNS och serverns egen A-post finns i en separat grupp riktad till serveradministratören, med förifyllda värden. Några minuter efter kontrollerna följer en skriftlig plan från Email Spam Tester. "Kontrollera igen" skickar ett nytt meddelande när posterna är på plats.

Historik

Här visas alla test som kontot har skickat, med de senaste först, inklusive datum, brevlåda, vilket meddelande det var, båda poängen och antalet för varje mapp. Ett diagram visar poängen från test till test. För varje test visas de kontroller som har ändrats sedan föregående test av samma domän. Om en DKIM-kontroll till exempel gick från underkänd till godkänd efter en åtgärd syns det direkt på raden. När du öppnar ett test visas rapporten och, för varje leverantör, vad de mottagande servrarna svarade. De senaste 200 testen för varje konto sparas på din server.

Kontinuerlig övervakning

Ett test från en brevlåda visar hur e-post från den brevlådan skickas. Det klassiska cPanel-problemet finns någon annanstans. En WordPress-webbplats eller ett kontaktformulär skickar med kuvertavsändaren user@hostname, SPF-alignment bryts och inget test från en brevlåda kommer någonsin att visa det. Övervakningen gör det.

Den osynliga kopia som övervakningen skapar lämnar din server via samma väg som meddelandet, från samma IP, med samma HELO och samma DKIM-signatur. Exim skapar kopian för varje meddelande som skickas av en övervakad domän och levererar den till en privat adress som tillhör domänen. Rapporten beskriver därför den faktiska vägen, medan själva meddelandet når mottagarna utan ändringar.

Fliken Övervakning visar domänens e-postmeddelanden som ett flöde. För varje meddelande visas mottagarens domän (aldrig adressen), varifrån det kom och vad som misslyckades. Källorna är webbmail, en e-postklient, PHP eller WordPress samt skript som anropar sendmail. Ovanför flödet finns en sammanfattning av det senaste dygnet på en rad och varningarna: DKIM har slutat godkännas, SPF eller DMARC misslyckas för en källa, avsändarens IP finns på en blockeringslista eller mottagande servrar avvisar meddelanden. Du kan öppna vilket meddelande som helst som en teknisk rapport över dess kontroller (meddelandets rubriker utelämnas), och kunden kan begära en AI-plan för det.

Övervakningen är avstängd tills administratören tillåter den på servern. Därefter aktiverar varje kund den för sina egna domäner.

Vad du får i WHM

WHM » Plugins » Email Spam Tester är en enda sida.

Pris

Gratis tills vidare, övervakning ingår. Du behöver inte skapa något konto på email-spam-tester.com och det finns inget att betala för tillfället. Om det någon gång ändras kommer det först att meddelas i ändringsloggen.

Data och integritet

Det här lämnar din server:

En testrapport fungerar på samma sätt som på webbplatsen: den ligger kvar på sin länk och alla som har länken kan öppna den, inklusive ämnesrad och avsändare. Själva e-postmeddelandet raderas en timme efter att det har kommit fram, när kontrollerna har körts. Fram till dess kan alla som har länken läsa det i sin helhet. Gmail-delen av mappkontrollen är också offentlig, enligt beskrivningen ovan, så det är bättre att testa konfidentiella e-postmeddelanden utan den.

Övervakningskopior är riktig korrespondens och rapporterna för dem är privata. Endast pluginprogrammet på din server kan öppna dem med hjälp av installationsnyckeln, och det finns ingen offentlig länk. En kopia raderas två dagar efter att den har kommit fram och dess rapport efter 90 dagar. Historiken och övervakningsflödet finns kvar på din server.

På integritetssidan finns den fullständiga policyn.

Frågor som webbhotell ställer

Ändrar det DNS automatiskt?

Nej. En post ändras bara när kunden trycker på knappen bredvid ett identifierat problem och bekräftar före- och eftervärdet, och bara när din server hanterar domänens DNS. Knapparna för SPF och DMARC skapar bara en post som saknas. Om det redan finns en post visas en sammanslagen version som kunden kan kopiera manuellt, och knappen ersätter den aldrig. Knappen för DKIM kan ersätta en post som inte matchar serverns nyckel, men bara om det finns exakt en sådan post. Varje ändring registreras i kontots logg och i en logg under /var/cpanel/email_spam_tester/ som bara root kan redigera, tillsammans med den post som DNS returnerade före ändringen.

Min server vidarebefordrar utgående e-post via en smarthost. Fungerar det ändå?

Det bör fungera, men jag har ännu inte testat det bakom en smarthost. Testmeddelandet skickas på samma sätt som all annan e-post från kontot, så rapporten visar reläets IP och namn, eftersom det är vad mottagarna ser. Att korrigera dess omvända DNS eller få bort det från en blockeringslista blir då en uppgift för den som driver reläet. En sak går förlorad. Orsakerna som en leverantör anger när ett meddelande avvisas hämtas från Exims logg på din server, och med ett relä innehåller den loggen bara reläets svar. Ett meddelande som reläet accepterade men som en leverantör senare avvisade kan visas som "Inte mottaget". Övervakningskopior skickas också via reläet.

Påverkar övervakningen leveransbarheten?

Kundens e-post skickas som tidigare, utan ändringar, och mottagarna ser ingenting eftersom kopian är en separat leverans till vår adress. Det som påverkas är gränsen för antal skickade meddelanden per timme. Varje kopia räknas en gång mot domänens "maximalt antal e-postmeddelanden per timme", så en domän som ligger nära gränsen når den tidigare, med högst 20 e-postmeddelanden per timme med standardinställningen. När det antalet kopior har skickats under en timme skickas resterande meddelanden utan någon kopia.

Räknas även mappkontrollen mot timgränsen?

Ja, den skickar cirka 30 e-postmeddelanden. Innan den startar kontrollerar pluginet hur många e-postmeddelanden domänen har kvar att skicka under den aktuella timmen och meddelar kunden om det inte är tillräckligt.

Vad har testats i drift?

cPanel & WHM 134 eller senare stöds. Hittills har jag testat det i drift med 138 (11.138) på Ubuntu 24.04. Det omfattar installation och uppgradering, registrering, funktionsväxeln, tester med och utan mappkontroll, historiken samt övervakning av e-post från alla fyra källorna. Det som ännu inte har testats i drift är de andra operativsystemen, CloudLinux med CageFS, knapparna för DKIM, SPF och DMARC (testserverns DNS hanteras på annat håll), en server som vidarebefordrar via en smarthost samt avstängning av övervakningen för hela servern, vilket bara har testkörts utan att några ändringar utförts. Om du kör pluginet i någon av dessa miljöer vill jag gärna höra hur det gick.

Installera, steg för steg

Den här guiden förutsätter att du har root-åtkomst till servern och inte har använt WHM-plugins tidigare. Alla kommandon nedan är avsedda att kopieras och klistras in precis som de är.

1. Det här behöver du

Du kan kontrollera båda anslutningarna före installationen. Det första kommandot ska skriva ut en rad som börjar med 220, det andra ska skriva ut 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. Installera

Logga in via SSH som root och kör dessa kommandon ett i taget.

Gå till roots hemkatalog, där pluginet ska finnas:

cd /root

Ladda ner arkivet och dess kontrollsumma. Inget skrivs ut när det fungerar:

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

Kontrollera att nedladdningen är intakt. Du ska se latest.tar.gz: OK. Om du ser FAILED, ladda ner igen och fortsätt inte:

sha256sum -c latest.tar.gz.sha256

Packa upp det i /root/email-spam-tester-cpanel. Inte heller här skrivs något ut:

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

Kör installationsprogrammet. Det kontrollerar först varje fil och kopierar sedan filerna till rätt plats:

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

Du ska se Checking Perl syntax…, Root module…, cPanel pages…, några rader från cPanels eget installationsprogram för plugins, Switching the feature off in all feature lists… och WHM page…. De sista raderna ska vara:

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.

Behåll katalogen /root/email-spam-tester-cpanel. Uppgraderingar och uninstall.sh körs därifrån.

3. Registrera servern i WHM

  1. Logga in i WHM som root.
  2. Öppna Plugins i menyn till vänster och klicka på Email Spam Tester.
  3. Rutan Registration visar "Not registered". Fältet för administratörens e-postadress under den är valfritt.
  4. Klicka på Register this server.

En grön rad visas högst upp, "Registered. Installation #…", och rutan visar nu Status: Registered, tillsammans med installationsnumret och början av nyckeln. Vid registreringen skickas serverns värdnamn, cPanel-versionen, pluginversionen, antalet konton och e-postadressen om du angav en. Nyckeln sparas i /var/cpanel/email_spam_tester/config.json och kan endast läsas av root.

På samma sida kan du ändra de dagliga gränserna: som standard 20 tester per konto och 500 per server.

4. Aktivera det för kunder

Efter installationen kan ingen se pluginet. Du väljer vilka paket som ska ha tillgång till det.

  1. Ta reda på vilken funktionslista dina paket använder: WHM » Packages » Edit a Package, välj ett paket och titta på fältet Feature List. På många servrar är det default.
  2. Öppna WHM » Packages » Feature Manager.
  3. Under Manage feature list väljer du listan och klickar på Edit.
  4. Leta upp Email Spam Tester i listan (webbläsarens sökfunktion hjälper om listan är lång), markera kryssrutan och klicka på Save.
  5. Upprepa detta för varje funktionslista som ska ha tillgång till det.

Kunder med dessa paket ser nu Email Spam Tester i avsnittet Email i cPanel. Kom ihåg att även markera det i funktionslistor som du skapar senare.

5. Skicka det första testet som kund

Logga in i cPanel som en av dessa kunder. Från WHM kan du använda Account Information » List Accounts och cPanel-ikonen bredvid kontot.

  1. Öppna Email » Email Spam Tester. Sidan har tre flikar: Test, History och Monitoring.
  2. Välj en brevlåda på fliken Test. Om kontot inte har någon skapar du först en under Email » Email Accounts.
  3. Låt Standard test email vara valt och låt Check the folder at email providers vara markerat.
  4. Klicka på Send test.

Sidan visar vad som händer: DNS-poster kontrolleras, meddelandet skickas och systemet väntar på att e-postmeddelandet ska komma fram. Efter ungefär en minut visas rapporten. Den innehåller två poäng, en teknisk poäng av 100 och den klassiska poängen från 0 till 10, och under dem What to fix. Den listan innehåller en knapp när cPanel kan korrigera en post på den här servern, den exakta posten som ska kopieras när DNS finns någon annanstans samt värden för omvänd DNS för dig som serveradministratör. Därefter visas alla kontroller. Where the email landed fylls i under de följande 30 minuterna med Inbox, Spam eller Promotions för varje e-postleverantör, samt leverantörens svar om e-postmeddelandet avvisades. En skriftlig plan visas några minuter efter kontrollerna.

Mappkontrollen skickar omkring 30 e-postmeddelanden. Om domänens sändningsgräns per timme inte har utrymme för dem meddelar sidan detta innan något skickas.

6. Kontinuerlig övervakning (valfritt)

När övervakning är aktiverad för en domän skickar Exim en osynlig kopia av varje e-postmeddelande som domänen skickar till en privat adress hos Email Spam Tester, och kunden ser en teknisk rapport för varje meddelande. Mottagarna ser ingenting. Varje kopia räknas en gång mot domänens sändningsgräns per timme, som standard högst 20 kopior i timmen.

  1. Leta upp rutan Constant monitoring under WHM » Plugins » Email Spam Tester och klicka på Allow constant monitoring on this server. Pluginet kontrollerar din Exim-konfiguration, lägger till sin regel, bygger om och startar om Exim samt återställer allt om något steg misslyckas. När det fungerar ser du "Constant monitoring is allowed on this server: the Exim rule is in, Exim was rebuilt and restarted." och rutan visar regeln som Active.
  2. Kunden öppnar fliken Monitoring i cPanel, klickar på Turn on bredvid en domän och bekräftar. E-postmeddelanden som skickas därefter visas på fliken inom en eller två minuter.

Om du vill stoppa övervakningen för hela servern klickar du på Disable monitoring on the whole server i samma ruta.

7. Uppgradera

Ladda ner och packa upp den nya versionen över den gamla och kör sedan installationsprogrammet igen:

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

Det ska avslutas med "Updated. The registration, limits and feature settings are unchanged." Om övervakning är tillåten uppdaterar installationsprogrammet även Exim-regeln.

8. Avinstallera

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

Detta tar bort övervakningsregeln från Exim, stänger av övervakningen för alla domäner och tar bort pluginet från cPanel och WHM. Det avslutas med "Removed. The key is kept in /var/cpanel/email_spam_tester (use --purge to delete it)." Kör i stället ./uninstall.sh --purge om du även vill ta bort nyckeln.

DNS-poster ändras aldrig, inte heller de som kunder har skapat med pluginets knappar.

9. Om något gick fel

Kunderna ser inte ikonen. Funktionen är avstängd i paketets funktionslista. Gå igenom steg 4 igen och kontrollera vilken funktionslista paketet faktiskt använder.

Sidan visar "The server administrator has not activated Email Spam Tester in WHM yet". Servern är inte registrerad. Utför steg 3.

Registreringen misslyckas. Det röda meddelandet högst upp på WHM-sidan anger orsaken. Vanligast är att servern inte kan nå email-spam-tester.com via HTTPS. Kör curl-kontrollen från steg 1, som måste skriva ut 200, och kontrollera brandväggsreglerna för utgående trafik.

Testet säger att meddelandet inte har kommit fram inom 3 minuter. E-postmeddelandet har fastnat i kön eller avvisats. Kör kontrollen av port 25 från steg 1. Om den inte skriver ut något eller får timeout blockerar din leverantör utgående port 25. Be leverantören att öppna den eller skicka e-post via ett relä. Så här ser du vad Exim gjorde med e-postmeddelandet:

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

Kunden kan även titta under Email » Track Delivery för brevlådan.

Sidor på cpanel.<domain> misslyckas ibland med ett 502-fel. Det beror på Apaches proxy för cPanels tjänsteunderdomäner och påverkar alla cPanel-sidor, inte bara det här pluginet. Direktadressen https://<domain>:2083 påverkas inte. Åtgärda det genom att öppna WHM » Service Configuration » Apache Configuration » Include Editor, välja Pre VirtualHost Include för alla versioner, lägga till dessa rader och spara:

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

Tillämpa sedan ändringen:

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

10. Support

Skriv till hi@email-spam-tester.com. Inkludera utdata från ./install.sh om installationen misslyckades eller länken till rapporten om ett test ser felaktigt ut. Mer information om pluginet finns på https://email-spam-tester.com/cpanel-integration/.