Email Spam Tester

Email Spam Tester › Email Spam Tester for cPanel & WHM

Email Spam Tester for cPanel & WHM

En plugin for hostingleverandører. Kundene finner den under Email i cPanel, sender en ekte e-post fra en av postboksene sine og får en liste over hva som må rettes, med den nøyaktige DNS-oppføringen eller den aktuelle cPanel-knappen ved siden av hvert funn.

Versjon 0.1.1, 30. september 2026. Last ned (94 KB), SHA-256 4909ff8402b3244711bc13bac96cfc22810ee33d48f80885f87e44809572cdd0. Installasjonstrinnene står på slutten av denne siden, og den samme teksten finnes som INSTALL.md i arkivet. Kildekode, tester og utgivelser finnes på GitHub.

Hvem det er for

Selskaper som drifter cPanel & WHM-servere for andre. Du installerer det én gang som root, og det vises under cPanel » Email for pakkene du velger. Frem til du aktiverer det i Feature Manager, ser kundene ikke noe nytt.

Uten dette må en kunde som vil finne ut hvorfor e-posten deres havner i spam, finne et testverktøy, åpne en e-postklient og sende en e-post manuelt. Med dette er testen en knapp ved siden av postkassene deres, og e-posten sendes faktisk fra serveren din, med serverens IP, HELO-navn, DKIM-signatur og eventuelle relétjenester den går gjennom.

Hva kundene får i cPanel

Test

Kunden velger en postkasse og sender enten standardtestmeldingen (en kort personlig e-post på engelsk, med en tekstdel og en HTML-del) eller sin egen melding. For en egen melding limer kunden inn et emne, HTML-innholdet og eventuelt en ren tekstversjon, og meldingen sendes nøyaktig slik den ble limt inn. Exim sender den som enhver annen e-post fra kontoen. Omtrent ett minutt senere vises rapporten på samme side med alle de 42 kontrollene: SPF, DKIM, DMARC og justering, omvendt DNS og HELO, TLS, IP-blokkeringslister, SpamAssassin og Rspamd, avsenderkravene som Gmail og Yahoo publiserer, samt innholdet. Det er to poengsummer, en teknisk poengsum av 100 og den klassiske fra 0 til 10.

«Kontroller mappen hos e-postleverandørene» er valgt som standard. Når dette er aktivert, sendes også én kopi av e-posten til hver av testpostkassene våre, omtrent 30 e-poster hos 14 leverandører, blant annet Gmail, Outlook, Yahoo, GMX og Proton. Hos Gmail er dette offentlige testpostkasser der alle kan se emnet, avsendernavnet og mappen. Tabellen fylles ut i løpet av opptil 30 minutter og viser Innboks, Søppelpost eller Kampanjer for hver leverandør. Hvis en leverandør avviste e-posten direkte, står dette i tabellen sammen med svaret fra serveren, inkludert SMTP-koden, hentet fra Exim-loggen på serveren din.

Under poengsummene står Dette må rettes. Når domenets DNS ligger på serveren din, kan cPanel rette DKIM, SPF og DMARC med en knapp. Programtillegget viser oppføringen slik den er nå og slik den vil bli, og ber om bekreftelse først. Når DNS driftes et annet sted, får kunden den nøyaktige oppføringen som skal kopieres, med navn, type og verdi. Omvendt DNS og serverens egen A-oppføring er samlet i en egen gruppe for serveradministratoren, med utfylte verdier. En skriftlig plan fra Email Spam Tester kommer noen minutter etter kontrollene, og «Kontroller på nytt» sender en ny e-post når oppføringene er lagt inn.

Historikk

Alle testene kontoen har sendt, med den nyeste først, samt dato, postkasse, hvilken e-post som ble brukt, begge poengsummene og antall for hver mappe. Et diagram viser poengsummen fra test til test. Hver test viser kontrollene som har endret seg siden forrige test av samme domene. Hvis en DKIM-kontroll gikk fra underkjent til godkjent etter en rettelse, vises dette direkte i raden. Når kunden åpner en test, vises rapporten og svaret fra mottakerserverne for hver leverandør. De siste 200 testene for hver konto lagres på serveren din.

Kontinuerlig overvåking

En test fra en postkasse viser hvordan e-post fra denne postkassen sendes. Det klassiske cPanel-problemet ligger et annet sted. Et WordPress-nettsted eller et kontaktskjema sender med konvoluttavsenderen user@hostname, SPF-justeringen brytes, og ingen test fra en postkasse vil noen gang vise det. Overvåking gjør det.

Den usynlige kopien som overvåkingen lager, forlater serveren din via samme rute som e-posten, fra samme IP, med samme HELO og samme DKIM-signatur. Exim lager denne kopien for hver e-post som sendes fra et overvåket domene, og leverer den til en privat adresse som tilhører domenet. Rapporten beskriver derfor den faktiske ruten, mens selve e-posten når mottakerne uten endringer.

Fanen Overvåking viser domenets e-poster som en strøm. Hver e-post viser mottakerens domene (aldri adressen), hvor den kom fra, og hva som mislyktes. Kildene er webmail, en e-postklient, PHP eller WordPress og skript som kaller sendmail. Over strømmen står et sammendrag av de siste 24 timene på én linje og varslene: DKIM blir ikke lenger godkjent, SPF eller DMARC mislykkes for én kilde, avsenderens IP står på en blokkeringsliste, eller mottakerservere avviser e-poster. Kunden kan åpne en e-post for å se en teknisk rapport over kontrollene (e-posthodene er utelatt) og be om en AI-plan for den.

Overvåking er deaktivert frem til administratoren tillater det på serveren. Deretter aktiverer hver kunde det for sine egne domener.

Dette får du i WHM

WHM » Plugins » Email Spam Tester består av én side.

Pris

Gratis foreløpig, inkludert overvåking. Du trenger ikke å opprette en konto på email-spam-tester.com, og det er ingenting å betale for øyeblikket. Hvis dette noen gang endres, blir det først opplyst i endringsloggen.

Data og personvern

Dette sendes fra serveren din:

En testrapport fungerer på samme måte som på nettstedet: Den forblir tilgjengelig via lenken, og alle som har lenken, kan åpne den, inkludert emne og avsender. Selve e-posten slettes én time etter at den er mottatt, når kontrollene er kjørt. Frem til da kan alle som har lenken, lese hele e-posten. Gmail-delen av mappekontrollen er også offentlig, som beskrevet ovenfor, så det er bedre å teste konfidensielle e-poster uten den.

Overvåkingskopier er faktisk korrespondanse, og rapportene deres er private. Bare programtillegget på serveren din kan åpne dem ved hjelp av installasjonsnøkkelen, og det finnes ingen offentlig lenke. En kopi slettes to dager etter at den er mottatt, og rapporten slettes etter 90 dager. Historikken og overvåkingsstrømmen blir værende på serveren din.

Personvernsiden inneholder hele retningslinjene.

Spørsmål fra hostingleverandører

Endrer det DNS av seg selv?

Nei. En oppføring endres bare når kunden trykker på knappen ved siden av et funn og bekrefter før- og etterverdien, og bare når serveren din er vert for domenets DNS. Knappene for SPF og DMARC oppretter bare en oppføring som mangler. Hvis det allerede finnes en oppføring, vises den sammenslått slik at kunden kan kopiere den manuelt, og en knapp erstatter den aldri. Knappen for DKIM kan erstatte en oppføring som ikke samsvarer med serverens nøkkel, men bare hvis det finnes nøyaktig én. Hver endring registreres i kontoens logg og i en logg under /var/cpanel/email_spam_tester/ som bare root kan redigere, sammen med oppføringen DNS leverte før endringen.

Serveren min videresender utgående e-post gjennom en smarthost. Fungerer det fortsatt?

Det bør fungere, men jeg har ennå ikke testet det bak en smarthost. Test-e-posten sendes på samme måte som all annen e-post fra kontoen, så rapporten viser releets IP og navn, fordi det er dette mottakerne ser. Å rette opp omvendt DNS eller få IP-adressen fjernet fra en blokkeringsliste er da oppgaven til den som driver releet. Én ting går tapt. Årsakene en leverandør oppgir for å avvise en e-post, hentes fra Exim-loggen på serveren din, og med et relé inneholder denne loggen bare svaret fra releet. En e-post som releet godtok, men som en leverandør senere avviste, kan bli vist som «Ikke mottatt». Kopier for overvåking går også gjennom releet.

Påvirker overvåking leveringen?

Kundens e-post sendes som før, uten endringer, og mottakerne ser ingenting, siden kopien leveres separat til adressen vår. Det som påvirkes, er den timebaserte sendegrensen. Hver kopi teller én gang mot domenets «maksimalt antall e-poster per time», så et domene som ligger nær grensen, når den tidligere, med maksimalt 20 e-poster i timen med standardinnstillingen. Når dette antallet kopier er nådd i løpet av en time, sendes e-postene uten kopi.

Teller mappesjekken også mot timegrensen?

Ja, den sender omtrent 30 e-poster. Før den starter, kontrollerer plugin-modulen hvor mange e-poster domenet kan sende resten av timen, og varsler kunden hvis det ikke er nok.

Hva er testet i et reelt miljø?

cPanel & WHM 134 eller nyere støttes. Så langt har jeg testet det i et reelt miljø på 138 (11.138) på Ubuntu 24.04. Dette dekker installasjon og oppgradering, registrering, funksjonsbryteren, tester med og uten mappesjekk, historikken og overvåking av e-poster fra alle fire kilder. Det som ennå ikke er testet i et reelt miljø, er de andre operativsystemene, CloudLinux med CageFS, knappene for DKIM, SPF og DMARC (testserverens DNS driftes et annet sted), en server som videresender gjennom en smarthost, og deaktivering av overvåking for hele serveren, som bare er tørrkjørt. Hvis du kjører plugin-modulen på en av disse konfigurasjonene, vil jeg gjerne høre hvordan det gikk.

Installer, trinn for trinn

Denne veiledningen forutsetter at du har root-tilgang på serveren og ikke har brukt WHM-utvidelser før. Alle kommandoene nedenfor skal kopieres og limes inn som de er.

1. Dette trenger du

Du kan kontrollere begge tilkoblingene før du installerer. Den første kommandoen skal skrive ut en linje som begynner med 220, den andre skal skrive 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. Installer

Logg inn via SSH som root, og kjør disse kommandoene én etter én.

Gå til root-brukerens hjemmekatalog, der utvidelsen skal ligge:

cd /root

Last ned arkivet og kontrollsummen. Ingenting skrives ut når det fungerer:

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

Kontroller at nedlastingen er intakt. Du skal se latest.tar.gz: OK. Hvis du ser FAILED, laster du ned på nytt og fortsetter ikke:

sha256sum -c latest.tar.gz.sha256

Pakk det ut i /root/email-spam-tester-cpanel. Heller ikke nå skrives det ut noe:

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

Kjør installasjonsprogrammet. Det kontrollerer først alle filene og kopierer dem deretter på plass:

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

Du skal se Checking Perl syntax…, Root module…, cPanel pages…, noen linjer fra cPanels eget installasjonsprogram for utvidelser, Switching the feature off in all feature lists… og WHM page…. De siste linjene skal være:

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.

Behold katalogen /root/email-spam-tester-cpanel. Oppgraderinger og uninstall.sh kjøres derfra.

3. Registrer serveren i WHM

  1. Logg inn i WHM som root.
  2. Åpne Plugins i menyen til venstre, og klikk på Email Spam Tester.
  3. Boksen Registration viser "Not registered". Feltet for administratorens e-postadresse nedenfor er valgfritt.
  4. Klikk på Register this server.

En grønn linje vises øverst, "Registered. Installation #…", og boksen viser nå Status: Registered sammen med installasjonsnummeret og begynnelsen av nøkkelen. Ved registrering sendes serverens vertsnavn, cPanel-versjonen, versjonen av utvidelsen, antall kontoer og e-postadressen hvis du oppga en. Nøkkelen lagres i /var/cpanel/email_spam_tester/config.json og kan bare leses av root.

På samme side kan du endre de daglige grensene. Standardverdiene er 20 tester per konto og 500 per server.

4. Slå den på for kunder

Etter installasjonen er utvidelsen ikke synlig for noen. Du velger hvilke pakker som skal ha den.

  1. Finn ut hvilken funksjonsliste pakkene dine bruker: WHM » Packages » Edit a Package, velg en pakke og se på feltet Feature List. På mange servere er det default.
  2. Åpne WHM » Packages » Feature Manager.
  3. Under Manage feature list velger du denne listen og klikker på Edit.
  4. Finn Email Spam Tester i listen (nettleserens søkefunksjon er nyttig hvis listen er lang), merk av i boksen og klikk på Save.
  5. Gjenta dette for alle funksjonslistene som skal ha utvidelsen.

Kunder med disse pakkene ser nå Email Spam Tester under Email i cPanel. Husk også å merke den i funksjonslister du oppretter senere.

5. Send den første testen som kunde

Logg inn i cPanel som en av disse kundene. Fra WHM kan du bruke Account Information » List Accounts og cPanel-ikonet ved siden av kontoen.

  1. Åpne Email » Email Spam Tester. Siden har tre faner: Test, History og Monitoring.
  2. Velg en postkasse i fanen Test. Hvis kontoen ikke har noen postkasser, oppretter du først en under Email » Email Accounts.
  3. La Standard test email være valgt, og la Check the folder at email providers være merket.
  4. Klikk på Send test.

Siden viser hva som skjer: kontroll av DNS-oppføringer, sending og venting på at e-posten skal komme frem. Rapporten vises etter omtrent ett minutt. Den har to poengsummer, en teknisk poengsum av 100 og den klassiske fra 0 til 10, og under dem What to fix. Denne listen inneholder en knapp der cPanel kan rette en oppføring på denne serveren, den nøyaktige oppføringen som skal kopieres når DNS driftes et annet sted, og verdier for omvendt DNS for deg som serveradministrator. Deretter vises alle kontrollene. Where the email landed fylles ut i løpet av de neste 30 minuttene med Inbox, Spam eller Promotions for hver e-postleverandør, samt leverandørens svar hvis e-posten ble avvist. En skriftlig plan vises noen minutter etter kontrollene.

Mappekontrollen sender omtrent 30 e-poster. Hvis domenets timegrense for sending ikke har plass til dem, gir siden beskjed før noe sendes.

6. Kontinuerlig overvåking (valgfritt)

Når overvåking er slått på for et domene, sender Exim en usynlig kopi av hver e-post domenet sender, til en privat adresse hos Email Spam Tester. Kunden ser en teknisk rapport for hver e-post. Mottakerne ser ingenting. Hver kopi teller én gang mot domenets timegrense for sending, som standard maksimalt 20 kopier i timen.

  1. Finn boksen Constant monitoring under WHM » Plugins » Email Spam Tester, og klikk på Allow constant monitoring on this server. Utvidelsen kontrollerer Exim-konfigurasjonen, legger til regelen, bygger Exim på nytt og starter den på nytt. Hvis et trinn mislykkes, tilbakestilles alt. Når det fungerer, ser du "Constant monitoring is allowed on this server: the Exim rule is in, Exim was rebuilt and restarted.", og boksen viser regelen som Active.
  2. Kunden åpner fanen Monitoring i cPanel, klikker på Turn on ved siden av et domene og bekrefter. E-poster som sendes etter dette, vises i fanen i løpet av ett til to minutter.

Hvis du vil stoppe overvåkingen for hele serveren, klikker du på Disable monitoring on the whole server i den samme boksen.

7. Oppgrader

Last ned og pakk ut den nye versjonen over den gamle, og kjør deretter installasjonsprogrammet på nytt:

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 skal avsluttes med "Updated. The registration, limits and feature settings are unchanged." Hvis overvåking er tillatt, oppdaterer installasjonsprogrammet også Exim-regelen.

8. Avinstaller

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

Dette fjerner overvåkingsregelen fra Exim, slår av overvåking for alle domener og fjerner utvidelsen fra cPanel og WHM. Det avsluttes med "Removed. The key is kept in /var/cpanel/email_spam_tester (use --purge to delete it)." Kjør ./uninstall.sh --purge i stedet hvis du også vil slette nøkkelen.

DNS-oppføringer endres aldri, inkludert oppføringer som kunder har opprettet med knappene i utvidelsen.

9. Hvis noe gikk galt

Kundene ser ikke ikonet. Funksjonen er slått av i pakkens funksjonsliste. Gå gjennom trinn 4 på nytt, og kontroller hvilken funksjonsliste pakken faktisk bruker.

Siden viser "The server administrator has not activated Email Spam Tester in WHM yet". Serveren er ikke registrert. Utfør trinn 3.

Registreringen mislykkes. Den røde meldingen øverst på WHM-siden forklarer hvorfor. Den vanligste årsaken er at serveren ikke kan nå email-spam-tester.com via HTTPS. Kjør curl-kontrollen fra trinn 1, som må skrive ut 200, og kontroller brannmurreglene for utgående trafikk.

Testen sier at meldingen ikke har kommet frem innen 3 minutter. E-posten sitter fast i køen eller ble avvist. Kjør kontrollen av port 25 fra trinn 1. Hvis den ikke skriver ut noe eller blir tidsavbrutt, blokkerer leverandøren din utgående port 25. Be leverandøren åpne den, eller send e-post via et relé. Slik ser du hva Exim gjorde med e-posten:

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

Kunden kan også se under Email » Track Delivery for postkassen.

Sider på cpanel.<domain> mislykkes noen ganger med en 502-feil. Dette skyldes Apaches proxy for cPanels tjenesteunderdomener, og det påvirker alle cPanel-sider, ikke bare denne utvidelsen. Den direkte adressen https://<domain>:2083 påvirkes ikke. For å rette dette åpner du WHM » Service Configuration » Apache Configuration » Include Editor, velger Pre VirtualHost Include for alle versjoner, legger til disse linjene og lagrer:

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

Bruk deretter endringen:

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

10. Brukerstøtte

Skriv til hi@email-spam-tester.com. Ta med utdataene fra ./install.sh hvis installasjonen mislyktes, eller lenken til rapporten hvis en test ser feil ut. Du finner mer informasjon om utvidelsen på https://email-spam-tester.com/cpanel-integration/.