Email Spam Tester

Email Spam Tester › Email Spam Tester pentru cPanel & WHM

Email Spam Tester pentru cPanel & WHM

Un plugin pentru furnizorii de găzduire. Clienții tăi îl găsesc în cPanel, în secțiunea Email, trimit un email real dintr-una dintre căsuțele lor poștale și primesc o listă cu ce trebuie corectat, împreună cu înregistrarea DNS exactă sau butonul cPanel corespunzător fiecărei probleme.

Versiunea 0.1.1, 30 septembrie 2026. Descarcă (94 KB), SHA-256 4909ff8402b3244711bc13bac96cfc22810ee33d48f80885f87e44809572cdd0. Pașii de instalare se află la sfârșitul acestei pagini, iar același text este inclus în fișierul INSTALL.md din arhivă. Codul sursă, testele și versiunile sunt disponibile pe GitHub.

Cui i se adresează

Companiilor care administrează servere cPanel & WHM pentru alte persoane. Îl instalezi o singură dată ca root, iar acesta apare în cPanel » Email pentru pachetele pe care le alegi. Până când îl activezi în Feature Manager, clienții nu văd nimic nou.

Fără el, un client care vrea să afle de ce mesajele sale ajung în spam trebuie să găsească un instrument de testare, să deschidă un client de e-mail și să trimită manual un email. Cu el, testul este disponibil printr-un buton lângă căsuțele poștale, iar mesajul pleacă efectiv de pe serverul tău, cu IP-ul, numele HELO, semnătura DKIM și orice serviciu de retransmitere prin care trece.

Ce primesc clienții în cPanel

Testare

Clientul alege o căsuță poștală și trimite fie emailul de test standard (un email personal scurt în limba engleză, cu o parte text și una HTML), fie propriul mesaj. Pentru propriul mesaj, introduce un subiect, conținutul HTML și, opțional, o versiune text simplu, iar mesajul este trimis exact așa cum a fost introdus. Exim îl trimite ca pe orice alt email din acel cont. După aproximativ un minut, raportul apare pe aceeași pagină, cu toate cele 42 verificări: SPF, DKIM, DMARC și alinierea, reverse DNS și HELO, TLS, listele de blocare pentru IP, SpamAssassin și Rspamd, cerințele pentru expeditori publicate de Gmail și Yahoo, precum și conținutul. Există două scoruri, unul tehnic din 100 și cel clasic de la 0 la 10.

„Verifică folderul la furnizorii de email” este bifat implicit. Când opțiunea este activă, câte o copie a emailului este trimisă și către fiecare dintre căsuțele noastre poștale de test, aproximativ 30 de emailuri la 14 furnizori, printre care Gmail, Outlook, Yahoo, GMX și Proton. La Gmail, acestea sunt căsuțe poștale publice de test, unde oricine poate vedea subiectul, numele expeditorului și folderul. Tabelul se completează în decurs de până la 30 de minute și afișează Inbox, Spam sau Promotions pentru fiecare furnizor. Dacă un furnizor a refuzat direct emailul, tabelul indică acest lucru și citează răspunsul serverului său, inclusiv codul SMTP, din jurnalul Exim de pe serverul tău.

Sub scoruri apare secțiunea Ce trebuie corectat. Dacă DNS-ul domeniului se află pe serverul tău, cPanel poate corecta DKIM, SPF și DMARC printr-un buton. Pluginul afișează înregistrarea actuală și cum va arăta după modificare, apoi îți cere confirmarea. Dacă DNS-ul este găzduit în altă parte, clientul primește înregistrarea exactă pe care trebuie să o copieze, cu numele, tipul și valoarea acesteia. Reverse DNS și înregistrarea A a serverului sunt într-un grup separat, adresat administratorului serverului, cu valorile deja completate. Un plan scris de Email Spam Tester apare la câteva minute după verificări, iar „Verifică din nou” trimite un email nou după ce înregistrările au fost adăugate.

Istoric

Sunt afișate toate testele trimise de cont, începând cu cel mai recent, împreună cu data, căsuța poștală, emailul folosit, ambele scoruri și numărul de mesaje din fiecare folder. Un grafic arată evoluția scorului de la un test la altul. Fiecare test enumeră verificările al căror rezultat s-a schimbat față de testul anterior al aceluiași domeniu, astfel încât o verificare DKIM care a trecut de la eșec la reușită după o corectare apare direct în rândul respectiv. Deschiderea unui test afișează raportul acestuia și, pentru fiecare furnizor, răspunsurile serverelor de destinație. Ultimele 200 de teste ale fiecărui cont sunt păstrate pe serverul tău.

Monitorizare continuă

Un test dintr-o căsuță poștală arată cum sunt trimise emailurile din acea căsuță. Problema clasică din cPanel apare în altă parte. Un site WordPress sau un formular de contact trimite cu expeditorul plicului user@hostname, alinierea SPF eșuează, iar un test dintr-o căsuță poștală nu va arăta niciodată acest lucru. Monitorizarea îl detectează.

Copia invizibilă creată de monitorizare părăsește serverul pe aceeași rută ca emailul, de la același IP, cu același HELO și aceeași semnătură DKIM. Exim o creează pentru fiecare email trimis de un domeniu monitorizat și o livrează la o adresă privată care aparține domeniului, astfel încât raportul descrie ruta reală, iar emailul propriu-zis ajunge neschimbat la destinatari.

Fila Monitorizare afișează emailurile domeniului sub forma unui flux. Pentru fiecare este afișat domeniul destinatarului (niciodată adresa), sursa și verificările care au eșuat. Sursele pot fi webmail, un client de email, PHP sau WordPress și scripturi care apelează sendmail. Deasupra fluxului se află un rezumat pe un singur rând al ultimelor 24 de ore și alertele: DKIM nu mai trece verificarea, SPF sau DMARC eșuează pentru o anumită sursă, IP-ul de trimitere se află pe o listă de blocare sau serverele de destinație refuză emailurile. Orice email poate fi deschis ca raport tehnic al verificărilor sale (anteturile emailului sunt omise), iar clientul poate solicita un plan AI pentru acesta.

Monitorizarea rămâne dezactivată până când administratorul o permite pe server. După aceea, fiecare client o activează pentru propriile domenii.

Ce primești în WHM

WHM » Plugins » Email Spam Tester este o singură pagină.

Preț

Gratuit deocamdată, cu monitorizare inclusă. Nu trebuie să-ți creezi un cont pe email-spam-tester.com și momentan nu ai nimic de plătit. Dacă acest lucru se va schimba vreodată, va fi anunțat mai întâi în jurnalul de modificări.

Date și confidențialitate

Ce părăsește serverul tău:

Un raport de test funcționează la fel ca pe site: rămâne disponibil la linkul său și oricine are linkul îl poate deschide, inclusiv subiectul și expeditorul. Emailul propriu-zis este șters la o oră după ce ajunge, după efectuarea verificărilor, iar până atunci oricine are linkul îl poate citi integral. Partea Gmail a verificării folderului este, de asemenea, publică, așa cum este descris mai sus, deci este mai bine să testezi emailurile confidențiale fără aceasta.

Copiile pentru monitorizare sunt corespondență reală, iar rapoartele lor sunt private. Numai pluginul de pe serverul tău le poate deschide, folosind cheia instalării, și nu există niciun link public. O copie este ștearsă la două zile după ce ajunge, iar raportul acesteia după 90 de zile. Istoricul și fluxul de monitorizare rămân pe serverul tău.

Pagina de confidențialitate conține politica integrală.

Întrebări adresate de furnizorii de găzduire

Modifică singur DNS?

Nu. O înregistrare este modificată numai când clientul apasă butonul de lângă o problemă și confirmă valorile de dinainte și de după, și numai dacă serverul tău găzduiește DNS al domeniului. Butoanele SPF și DMARC creează doar o înregistrare care lipsește. Dacă există deja una, aceasta este afișată cu valorile combinate, astfel încât clientul să o poată copia manual, iar butonul nu o înlocuiește niciodată. Butonul DKIM poate înlocui o înregistrare care nu corespunde cheii serverului, dar numai dacă există exact una. Fiecare modificare este înregistrată în jurnalul contului și într-un jurnal din /var/cpanel/email_spam_tester/, pe care numai root îl poate modifica, împreună cu înregistrarea DNS furnizată anterior.

Serverul meu trimite emailurile printr-un smarthost. Mai funcționează?

Ar trebui să funcționeze, dar încă nu l-am testat în spatele unui smarthost. Emailul de test este trimis la fel ca toate emailurile din cont, astfel încât raportul arată IP-ul și numele releului, deoarece acestea sunt cele văzute de destinatari. Corectarea DNS invers sau eliminarea IP-ului dintr-o listă de blocare devine responsabilitatea celui care administrează releul. Totuși, se pierde un lucru. Motivele oferite de un furnizor pentru refuzarea unui email provin din jurnalul Exim de pe serverul tău, iar în cazul unui releu, jurnalul conține doar răspunsul releului. Un email acceptat de releu și refuzat ulterior de un furnizor poate apărea ca „Neprimit”. Și copiile de monitorizare trec prin releu.

Monitorizarea afectează livrabilitatea?

Emailul clientului este trimis ca înainte, fără modificări, iar destinatarii săi nu văd nimic, deoarece copia este o livrare separată către adresa noastră. Monitorizarea influențează însă limita orară de trimitere. Fiecare copie este contorizată o dată în limita „numărului maxim de emailuri pe oră” al domeniului, astfel încât un domeniu apropiat de limită o va atinge mai devreme, cu cel mult 20 de emailuri pe oră folosind setarea implicită. După atingerea acestui număr de copii într-o oră, emailurile sunt trimise fără copie.

Verificarea folderelor se ia și ea în calcul pentru limita orară?

Da, trimite aproximativ 30 de emailuri. Înainte de a începe, pluginul verifică numărul de emailuri pe care domeniul le mai poate trimite în ora respectivă și informează clientul dacă nu sunt suficiente.

Ce a fost testat într-un mediu real?

Este acceptat cPanel & WHM 134 sau o versiune mai nouă. Până acum, l-am testat într-un mediu real pe versiunea 138 (11.138), pe Ubuntu 24.04. Testarea a inclus instalarea și un upgrade, înregistrarea, comutatorul funcției, teste cu și fără verificarea folderelor, istoricul și monitorizarea emailurilor din toate cele patru surse. Nu au fost încă testate într-un mediu real celelalte sisteme de operare, CloudLinux cu CageFS, butoanele DKIM, SPF și DMARC (DNS al serverului de test este găzduit în altă parte), un server care transmite printr-un smarthost și dezactivarea monitorizării pentru întregul server, pentru care a fost efectuată doar o simulare. Dacă rulezi pluginul într-unul dintre aceste cazuri, aș vrea să aflu cum a mers.

Instalare, pas cu pas

Acest ghid presupune că ai acces root la server și că nu ai mai folosit pluginuri WHM. Fiecare comandă de mai jos trebuie copiată și lipită exact așa cum este.

1. De ce ai nevoie

Poți verifica ambele conexiuni înainte de instalare. Prima comandă trebuie să afișeze o linie care începe cu 220, iar a doua trebuie să afișeze 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. Instalare

Autentifică-te prin SSH ca root și rulează aceste comenzi una câte una.

Mergi în directorul personal al utilizatorului root, unde va fi păstrat pluginul:

cd /root

Descarcă arhiva și suma ei de control. Dacă operațiunea reușește, nu se afișează nimic:

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

Verifică dacă descărcarea este intactă. Ar trebui să vezi latest.tar.gz: OK. Dacă vezi FAILED, descarcă din nou și nu continua:

sha256sum -c latest.tar.gz.sha256

Dezarhivează în /root/email-spam-tester-cpanel. Din nou, nu se afișează nimic:

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

Rulează programul de instalare. Acesta verifică mai întâi fiecare fișier, apoi le copiază în locațiile corespunzătoare:

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

Ar trebui să vezi Checking Perl syntax…, Root module…, cPanel pages…, câteva linii de la programul de instalare a pluginurilor din cPanel, Switching the feature off in all feature lists… și WHM page…. Ultimele linii ar trebui să fie:

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.

Păstrează directorul /root/email-spam-tester-cpanel. Actualizările și uninstall.sh se rulează din acesta.

3. Înregistrează serverul în WHM

  1. Autentifică-te în WHM ca root.
  2. În meniul din stânga, deschide Plugins și dă clic pe Email Spam Tester.
  3. Caseta Înregistrare afișează „Neînregistrat”. Câmpul de sub aceasta pentru adresa de email a administratorului este opțional.
  4. Dă clic pe Înregistrează acest server.

În partea de sus apare o linie verde, „Înregistrat. Instalarea nr. …”, iar caseta afișează acum Stare: Înregistrat, împreună cu numărul instalării și începutul cheii. La înregistrare se trimit numele de gazdă al serverului, versiunea cPanel, versiunea pluginului, numărul de conturi și adresa de email, dacă ai furnizat una. Cheia este păstrată în /var/cpanel/email_spam_tester/config.json și poate fi citită numai de root.

Pe aceeași pagină poți modifica limitele zilnice: în mod implicit, 20 de teste per cont și 500 per server.

4. Activează-l pentru clienți

După instalare, nimeni nu vede pluginul. Tu alegi pachetele pentru care va fi disponibil.

  1. Află ce listă de funcții folosesc pachetele tale: WHM » Packages » Edit a Package, alege un pachet și verifică valoarea câmpului Feature List. Pe multe servere aceasta este default.
  2. Deschide WHM » Packages » Feature Manager.
  3. Sub Manage feature list, selectează lista respectivă și dă clic pe Edit.
  4. Găsește Email Spam Tester în listă (funcția Find a browserului este utilă dacă lista este lungă), bifează caseta acestuia și dă clic pe Save.
  5. Repetă pentru fiecare listă de funcții în care vrei să fie disponibil.

Clienții cu pachetele respective văd acum Email Spam Tester în cPanel, în secțiunea Email. Nu uita să-l bifezi și în listele de funcții pe care le creezi ulterior.

5. Trimite primul test în calitate de client

Autentifică-te în cPanel ca unul dintre acești clienți. Din WHM poți folosi Account Information » List Accounts și pictograma cPanel de lângă cont.

  1. Deschide Email » Email Spam Tester. Pagina are trei file: Test, Istoric și Monitorizare.
  2. În fila Test, alege o căsuță poștală. Dacă acel cont nu are niciuna, creează mai întâi una în Email » Email Accounts.
  3. Lasă selectată opțiunea Email de test standard și lasă bifată opțiunea Verifică dosarul la furnizorii de email.
  4. Dă clic pe Trimite testul.

Pagina arată ce face: verifică înregistrările DNS, trimite mesajul și așteaptă sosirea acestuia. După aproximativ un minut apare raportul. Acesta are două scoruri, unul tehnic din 100 și cel clasic de la 0 la 10, iar sub ele secțiunea Ce trebuie remediat. Lista respectivă oferă un buton atunci când cPanel poate remedia o înregistrare pe acest server, înregistrarea exactă care trebuie copiată atunci când DNS este găzduit în altă parte și valorile reverse DNS pentru tine, ca administrator al serverului. Mai jos urmează toate verificările. Secțiunea Unde a ajuns emailul se completează în următoarele 30 de minute cu Inbox, Spam sau Promotions pentru fiecare furnizor de email și cu răspunsul furnizorului atunci când acesta a refuzat mesajul. Câteva minute după verificări apare și un plan scris.

Verificarea dosarului trimite aproximativ 30 de emailuri. Dacă limita orară de trimitere a domeniului nu permite trimiterea lor, pagina te anunță înainte să trimită ceva.

6. Monitorizare constantă (opțional)

Când monitorizarea este activată pentru un domeniu, Exim trimite o copie invizibilă a fiecărui email expediat de domeniu către o adresă privată de la Email Spam Tester, iar clientul vede un raport tehnic pentru fiecare email. Destinatarii nu văd nimic. Fiecare copie este luată în calcul o dată în limita orară de trimitere a domeniului, cu maximum 20 de copii pe oră în mod implicit.

  1. În WHM » Plugins » Email Spam Tester, găsește caseta Monitorizare constantă și dă clic pe Permite monitorizarea constantă pe acest server. Pluginul verifică configurația Exim, adaugă regula proprie, reconstruiește și repornește Exim și readuce totul la starea inițială dacă unul dintre pași eșuează. Când operațiunea reușește, vezi mesajul „Monitorizarea constantă este permisă pe acest server: regula Exim a fost adăugată, iar Exim a fost reconstruit și repornit.”, iar caseta afișează regula ca Activă.
  2. Clientul deschide fila Monitorizare în cPanel, dă clic pe Activează lângă un domeniu și confirmă. Emailurile trimise după aceea apar în filă în unul sau două minute.

Pentru a opri monitorizarea pe întregul server, dă clic pe Dezactivează monitorizarea pe întregul server în aceeași casetă.

7. Actualizare

Descarcă și dezarhivează noua versiune peste cea veche, apoi rulează din nou programul de instalare:

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

La final ar trebui să apară mesajul „Actualizat. Înregistrarea, limitele și setările funcțiilor au rămas neschimbate.” Dacă monitorizarea este permisă, programul de instalare actualizează și regula Exim.

8. Dezinstalare

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

Această operațiune elimină regula de monitorizare din Exim, dezactivează monitorizarea pentru fiecare domeniu și elimină pluginul din cPanel și WHM. La final apare mesajul „Eliminat. Cheia este păstrată în /var/cpanel/email_spam_tester (folosește --purge pentru a o șterge).” Rulează în schimb ./uninstall.sh --purge pentru a șterge și cheia.

Înregistrările DNS nu sunt modificate niciodată, inclusiv cele create de clienți cu butoanele pluginului.

9. Dacă ceva nu a funcționat

Clienții nu văd pictograma. Funcția este dezactivată în lista de funcții a pachetului lor. Repetă pasul 4 și verifică ce listă de funcții folosește de fapt pachetul lor.

Pagina afișează „Administratorul serverului nu a activat încă Email Spam Tester în WHM”. Serverul nu este înregistrat. Urmează pasul 3.

Înregistrarea eșuează. Mesajul roșu din partea de sus a paginii WHM explică motivul. Cel mai adesea, serverul nu poate accesa email-spam-tester.com prin HTTPS. Rulează verificarea curl de la pasul 1, care trebuie să afișeze 200, și verifică regulile firewallului pentru traficul de ieșire.

Testul spune că mesajul nu a sosit în 3 minute. Emailul este blocat în coadă sau a fost refuzat. Rulează verificarea portului 25 de la pasul 1. Dacă nu afișează nimic sau expiră, furnizorul tău blochează portul 25 pentru conexiuni de ieșire. Cere-i să-l deschidă sau trimite mesajele printr-un releu. Pentru a vedea ce a făcut Exim cu emailul:

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

Clientul poate verifica și Email » Track Delivery pentru căsuța poștală.

Paginile de la cpanel.<domain> eșuează uneori cu o eroare 502. Problema este cauzată de proxy-ul Apache pentru subdomeniile de servicii cPanel și afectează fiecare pagină cPanel, nu doar acest plugin. Adresa directă https://<domain>:2083 nu este afectată. Pentru remediere, deschide WHM » Service Configuration » Apache Configuration » Include Editor, alege Pre VirtualHost Include pentru toate versiunile, adaugă liniile următoare și salvează:

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

Apoi aplică modificarea:

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

10. Asistență

Scrie la hi@email-spam-tester.com. Include rezultatul comenzii ./install.sh dacă instalarea a eșuat sau linkul raportului dacă un test pare incorect. Mai multe informații despre plugin sunt disponibile la https://email-spam-tester.com/cpanel-integration/.