Email Spam Tester

Email Spam Tester › Email Spam Tester per cPanel & WHM

Email Spam Tester per cPanel & WHM

Un plugin per i provider di hosting. I tuoi clienti lo trovano in cPanel, nella sezione Email, inviano un'email reale da una delle proprie caselle e ricevono un elenco degli elementi da correggere, con il record DNS esatto o il pulsante di cPanel accanto a ogni problema rilevato.

Versione 0.1.1, 30 settembre 2026. Scarica (94 KB), SHA-256 4909ff8402b3244711bc13bac96cfc22810ee33d48f80885f87e44809572cdd0. Le istruzioni di installazione si trovano alla fine di questa pagina e lo stesso testo è disponibile nel file INSTALL.md incluso nell'archivio. Il codice sorgente, i test e le release sono disponibili su GitHub.

A chi è rivolto

Alle aziende che gestiscono server cPanel & WHM per conto di altri. Lo installi una sola volta come root e viene visualizzato in cPanel » Email per i pacchetti che scegli. Finché non lo attivi in Feature Manager, i clienti non vedono nulla di nuovo.

Senza questo strumento, un cliente che vuole capire perché le sue email finiscono nello spam deve trovare un servizio di test, aprire un client di posta e inviare manualmente un'email. Con questo strumento, il test si avvia da un pulsante accanto alle caselle di posta e l'email parte davvero dal tuo server, con il suo IP, il suo nome HELO, la sua firma DKIM e qualsiasi relay attraverso cui viene inoltrata.

Cosa ottengono i clienti in cPanel

Test

Il cliente sceglie una casella di posta e invia l'email di test standard (una breve email personale in inglese, con una parte di testo e una parte HTML) oppure un proprio messaggio. Per un messaggio personalizzato, incolla l'oggetto, il codice HTML e, facoltativamente, una versione in testo semplice. Il messaggio viene inviato esattamente come è stato incollato. Exim lo invia come qualsiasi altra email di quell'account. Circa un minuto dopo, il report appare sulla stessa pagina con tutti i 42 controlli: SPF, DKIM, DMARC e allineamento, DNS inverso e HELO, TLS, liste di blocco IP, SpamAssassin e Rspamd, i requisiti per i mittenti pubblicati da Gmail e Yahoo e il contenuto. Vengono mostrati due punteggi, uno tecnico su 100 e quello classico da 0 a 10.

"Controlla la cartella presso i provider email" è selezionato per impostazione predefinita. Con questa opzione, una copia dell'email viene inviata anche a ciascuna delle nostre caselle di posta di test, circa 30 email presso 14 provider, tra cui Gmail, Outlook, Yahoo, GMX e Proton. Per Gmail si tratta di caselle di posta di test pubbliche, dove chiunque può vedere l'oggetto, il nome del mittente e la cartella. La tabella si compila nell'arco di massimo 30 minuti e mostra Posta in arrivo, Spam o Promozioni per ciascun provider. Se un provider ha rifiutato direttamente l'email, la tabella lo indica e riporta la risposta del suo server, incluso il codice SMTP, presa dal log di Exim sul server.

Sotto i punteggi appare Cosa correggere. Se il DNS del dominio si trova sul server, cPanel può correggere DKIM, SPF e DMARC con un pulsante. Il plugin mostra il record attuale e come verrà modificato, quindi chiede conferma. Se il DNS è ospitato altrove, il cliente riceve il record esatto da copiare, con nome, tipo e valore. Il DNS inverso e il record A del server sono raccolti in un gruppo separato destinato all'amministratore del server, con i valori già compilati. Alcuni minuti dopo i controlli viene mostrato un piano scritto da Email Spam Tester, mentre "Controlla di nuovo" invia una nuova email dopo l'inserimento dei record.

Cronologia

Tutti i test inviati dall'account, dal più recente, con la data, la casella di posta, l'email utilizzata, entrambi i punteggi e il conteggio delle cartelle. Un grafico mostra il punteggio da un test all'altro. Ogni test elenca i controlli il cui risultato è cambiato rispetto al test precedente dello stesso dominio. Per esempio, un controllo DKIM passato da non superato a superato dopo una correzione appare direttamente nella riga. Aprendo un test vengono mostrati il relativo report e, per ciascun provider, le risposte dei server di ricezione. Gli ultimi 200 test di ogni account vengono conservati sul server.

Monitoraggio continuo

Un test eseguito da una casella di posta mostra come vengono inviate le email da quella casella. Il classico problema di cPanel si trova altrove. Un sito WordPress o un modulo di contatto invia usando come mittente della busta user@hostname, l'allineamento SPF non riesce e nessun test eseguito da una casella di posta potrà rilevarlo. Il monitoraggio sì.

La copia invisibile creata dal monitoraggio lascia il server seguendo lo stesso percorso dell'email, dallo stesso IP, con lo stesso HELO e la stessa firma DKIM. Exim la crea per ogni email inviata da un dominio monitorato e la consegna a un indirizzo privato appartenente al dominio. In questo modo il report descrive il percorso reale, mentre l'email raggiunge i destinatari senza modifiche.

La scheda Monitoraggio mostra le email del dominio come un flusso. Per ciascuna vengono indicati il dominio del destinatario (mai l'indirizzo), la provenienza e i controlli non superati. Le origini possono essere webmail, un client di posta, PHP o WordPress e gli script che chiamano sendmail. Sopra il flusso sono presenti un riepilogo su una riga delle ultime 24 ore e gli avvisi: DKIM ha smesso di essere superato, SPF o DMARC non riescono per una determinata origine, l'IP di invio è in una lista di blocco oppure i server di ricezione rifiutano le email. Ogni email può essere aperta come report tecnico dei relativi controlli (le intestazioni dell'email vengono escluse) e il cliente può richiedere un piano generato dall'AI.

Il monitoraggio resta disattivato finché l'amministratore non lo abilita sul server. Successivamente, ogni cliente lo attiva per i propri domini.

Cosa trovi in WHM

WHM » Plugins » Email Spam Tester è una singola pagina.

Prezzo

Per ora è gratuito, monitoraggio incluso. Su email-spam-tester.com non è necessario creare un account e al momento non c'è nulla da pagare. Se la situazione dovesse cambiare, verrà comunicato prima nel registro delle modifiche.

Dati e privacy

Cosa lascia il server:

Un report di test funziona come sul sito: rimane disponibile al proprio link e chiunque disponga del link può aprirlo, inclusi l'oggetto e il mittente. L'email viene eliminata un'ora dopo l'arrivo, una volta completati i controlli. Fino ad allora, chiunque disponga del link può leggerla per intero. Anche la parte relativa a Gmail del controllo delle cartelle è pubblica, come descritto sopra, quindi è preferibile testare le email riservate senza includerla.

Le copie di monitoraggio sono corrispondenza reale e i relativi report sono privati. Solo il plugin sul server può aprirli, utilizzando la chiave di installazione, e non esiste alcun link pubblico. Una copia viene eliminata due giorni dopo l'arrivo e il relativo report dopo 90 giorni. La cronologia e il feed di monitoraggio rimangono sul server.

La pagina sulla privacy contiene l'informativa completa.

Domande frequenti dei provider di hosting

Modifica automaticamente il DNS?

No. Un record viene modificato solo quando il cliente preme il pulsante accanto a un problema rilevato e conferma i valori precedenti e successivi, e solo se il server ospita il DNS del dominio. I pulsanti SPF e DMARC creano solo un record mancante. Se ne esiste già uno, viene mostrata una versione unificata che il cliente deve copiare manualmente, e il pulsante non lo sostituisce mai. Il pulsante DKIM può sostituire un record che non corrisponde alla chiave del server, ma solo se ne esiste esattamente uno. Ogni modifica viene registrata nel log dell'account e in un log nella directory /var/cpanel/email_spam_tester/, che può essere modificato solo da root, insieme al record DNS fornito in precedenza.

Il mio server inoltra la posta in uscita tramite uno smarthost. Funziona comunque?

Dovrebbe funzionare, ma non l'ho ancora testato con uno smarthost. L'email di prova viene inviata nello stesso modo di tutta la posta dell'account, quindi il report mostra l'IP e il nome del relay, perché sono quelli che vedono i destinatari. Correggere il reverse DNS del relay o rimuoverlo da una lista di blocco spetta quindi a chi lo gestisce. Un'informazione però va persa. I motivi forniti da un provider per il rifiuto di un'email provengono dal log di Exim sul server e, in presenza di un relay, quel log contiene solo la risposta del relay. Un'email accettata dal relay e rifiutata successivamente da un provider potrebbe risultare come "Non ricevuta". Anche le copie di monitoraggio passano attraverso il relay.

Il monitoraggio influisce sulla recapitabilità?

L'email del cliente viene inviata come prima, senza modifiche, e i destinatari non vedono nulla, perché la copia è un invio separato al nostro indirizzo. Il monitoraggio incide però sul limite orario di invio. Ogni copia viene conteggiata una volta nel limite "max emails per hour" del dominio, quindi un dominio vicino al limite lo raggiunge prima, con un massimo di 20 email in più all'ora usando l'impostazione predefinita. Una volta superato questo numero di copie in un'ora, le email vengono inviate senza copia.

Anche il controllo delle cartelle viene conteggiato nel limite orario?

Sì, invia circa 30 email. Prima di iniziare, il plugin controlla quante email il dominio può ancora inviare nell'ora corrente e informa il cliente se non sono sufficienti.

Cosa è stato testato in un ambiente reale?

È supportato cPanel & WHM 134 o versioni successive. Finora l'ho testato in un ambiente reale sulla versione 138 (11.138) con Ubuntu 24.04. Il test comprende l'installazione e un aggiornamento, la registrazione, l'attivazione e la disattivazione della funzionalità, i test con e senza il controllo delle cartelle, la cronologia e il monitoraggio delle email provenienti da tutte e quattro le fonti. Non sono ancora stati testati in un ambiente reale gli altri sistemi operativi, CloudLinux con CageFS, i pulsanti DKIM, SPF e DMARC (il DNS del server di test è ospitato altrove), un server che inoltra la posta tramite uno smarthost e la disattivazione del monitoraggio per l'intero server, per la quale è stata eseguita solo una simulazione. Se esegui il plugin in una di queste configurazioni, vorrei sapere com'è andata.

Installazione, passo dopo passo

Questa guida presuppone che tu abbia accesso root al server e non abbia mai usato plugin WHM. Ogni comando riportato di seguito deve essere copiato e incollato così com'è.

1. Requisiti

Puoi controllare entrambe le connessioni prima dell'installazione. Il primo comando dovrebbe stampare una riga che inizia con 220, il secondo dovrebbe stampare 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. Installazione

Accedi tramite SSH come root ed esegui questi comandi uno alla volta.

Vai alla directory home di root, dove verrà installato il plugin:

cd /root

Scarica l'archivio e il relativo checksum. Se tutto funziona, non viene stampato nulla:

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

Controlla che il download sia integro. Dovresti vedere latest.tar.gz: OK. Se vedi FAILED, scarica di nuovo il file e non continuare:

sha256sum -c latest.tar.gz.sha256

Estrai l'archivio in /root/email-spam-tester-cpanel. Anche in questo caso non viene stampato nulla:

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

Esegui il programma di installazione. Prima controlla tutti i file, poi li copia nelle posizioni corrette:

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

Dovresti vedere Checking Perl syntax…, Root module…, cPanel pages…, alcune righe del programma di installazione dei plugin di cPanel, Switching the feature off in all feature lists… e WHM page…. Le ultime righe dovrebbero essere:

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.

Conserva la directory /root/email-spam-tester-cpanel. Gli aggiornamenti e uninstall.sh vengono eseguiti da questa directory.

3. Registrazione del server in WHM

  1. Accedi a WHM come root.
  2. Nel menu a sinistra, apri Plugins e fai clic su Email Spam Tester.
  3. Nel riquadro Registration compare "Not registered". Il campo sottostante per l'indirizzo email dell'amministratore è facoltativo.
  4. Fai clic su Register this server.

In alto compare una riga verde, "Registered. Installation #…", e il riquadro ora mostra Status: Registered, con il numero dell'installazione e l'inizio della chiave. La registrazione invia il nome host del server, la versione di cPanel, la versione del plugin, il numero di account e l'indirizzo email, se lo hai fornito. La chiave viene conservata in /var/cpanel/email_spam_tester/config.json ed è leggibile solo da root.

Nella stessa pagina puoi modificare i limiti giornalieri: per impostazione predefinita, 20 test per account e 500 per server.

4. Attivazione per i clienti

Dopo l'installazione, nessuno vede il plugin. Devi scegliere per quali pacchetti renderlo disponibile.

  1. Verifica quale elenco di funzionalità usano i tuoi pacchetti: WHM » Packages » Edit a Package, scegli un pacchetto e controlla il campo Feature List. Su molti server è default.
  2. Apri WHM » Packages » Feature Manager.
  3. In Manage feature list, seleziona quell'elenco e fai clic su Edit.
  4. Trova Email Spam Tester nell'elenco (se l'elenco è lungo, usa la funzione Trova del browser), seleziona la relativa casella e fai clic su Save.
  5. Ripeti la procedura per ogni elenco di funzionalità in cui vuoi renderlo disponibile.

I clienti che usano questi pacchetti ora vedono Email Spam Tester in cPanel, nella sezione Email. Ricorda di selezionarlo anche negli elenchi di funzionalità che creerai in seguito.

5. Invio del primo test come cliente

Accedi a cPanel come uno di questi clienti. Da WHM puoi usare Account Information » List Accounts e l'icona cPanel accanto all'account.

  1. Apri Email » Email Spam Tester. La pagina ha tre schede: Test, History e Monitoring.
  2. Nella scheda Test, scegli una casella di posta. Se l'account non ne ha nessuna, creane prima una in Email » Email Accounts.
  3. Lascia selezionato Standard test email e lascia selezionata la casella Check the folder at email providers.
  4. Fai clic su Send test.

La pagina mostra le operazioni in corso: controllo dei record DNS, invio e attesa dell'arrivo dell'email. Dopo circa un minuto compare il report. Contiene due punteggi, uno tecnico su 100 e quello classico da 0 a 10, seguiti da What to fix. Questo elenco include un pulsante quando cPanel può correggere un record su questo server, il record esatto da copiare quando il DNS è gestito altrove e i valori DNS inversi destinati a te, in qualità di amministratore del server. Seguono tutti i controlli. Where the email landed si completa nei 30 minuti successivi indicando Inbox, Spam o Promotions per ciascun provider di posta, oltre alla risposta del provider quando ha rifiutato l'email. Alcuni minuti dopo i controlli viene aggiunto un piano scritto.

Il controllo delle cartelle invia circa 30 email. Se il limite orario di invio del dominio non consente di inviarle, la pagina lo segnala prima di qualsiasi invio.

6. Monitoraggio continuo (facoltativo)

Quando il monitoraggio è attivo per un dominio, Exim invia una copia invisibile di ogni email spedita dal dominio a un indirizzo privato di Email Spam Tester, e il cliente vede un report tecnico per ogni email. I destinatari non vedono nulla. Ogni copia viene conteggiata una volta nel limite orario di invio del dominio, con un massimo predefinito di 20 copie all'ora.

  1. In WHM » Plugins » Email Spam Tester, trova il riquadro Constant monitoring e fai clic su Allow constant monitoring on this server. Il plugin controlla la configurazione di Exim, aggiunge la propria regola, ricompila e riavvia Exim. Se uno dei passaggi non riesce, ripristina tutto. Quando l'operazione riesce, compare "Constant monitoring is allowed on this server: the Exim rule is in, Exim was rebuilt and restarted." e il riquadro mostra la regola come Active.
  2. Il cliente apre la scheda Monitoring in cPanel, fa clic su Turn on accanto a un dominio e conferma. Le email inviate da quel momento compaiono nella scheda entro uno o due minuti.

Per interrompere il monitoraggio su tutto il server, fai clic su Disable monitoring on the whole server nello stesso riquadro.

7. Aggiornamento

Scarica ed estrai la nuova versione sopra quella precedente, quindi esegui di nuovo il programma di installazione:

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

L'operazione dovrebbe terminare con "Updated. The registration, limits and feature settings are unchanged.". Se il monitoraggio è consentito, il programma di installazione aggiorna anche la regola di Exim.

8. Disinstallazione

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

Questa operazione rimuove la regola di monitoraggio da Exim, disattiva il monitoraggio per ogni dominio e rimuove il plugin da cPanel e WHM. Termina con "Removed. The key is kept in /var/cpanel/email_spam_tester (use --purge to delete it).". Esegui invece ./uninstall.sh --purge per eliminare anche la chiave.

I record DNS non vengono mai modificati, inclusi quelli creati dai clienti tramite i pulsanti del plugin.

9. In caso di problemi

I clienti non vedono l'icona. La funzionalità è disattivata nell'elenco di funzionalità del loro pacchetto. Ripeti il passaggio 4 e controlla quale elenco di funzionalità usa effettivamente il loro pacchetto.

La pagina mostra "The server administrator has not activated Email Spam Tester in WHM yet". Il server non è registrato. Completa il passaggio 3.

La registrazione non riesce. Il messaggio rosso nella parte superiore della pagina WHM ne indica il motivo. Nella maggior parte dei casi il server non riesce a raggiungere email-spam-tester.com tramite HTTPS: esegui il controllo con curl del passaggio 1, che deve stampare 200, e verifica le regole del firewall per il traffico in uscita.

Il test indica che il messaggio non è arrivato entro 3 minuti. L'email è bloccata nella coda oppure è stata rifiutata. Esegui il controllo della porta 25 indicato nel passaggio 1. Se non stampa nulla o va in timeout, il tuo provider blocca la porta 25 in uscita: chiedi di aprirla oppure invia la posta tramite un relay. Per vedere come Exim ha gestito l'email:

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

Il cliente può anche controllare Email » Track Delivery per la casella di posta.

Le pagine su cpanel.<domain> a volte restituiscono un errore 502. Si tratta del proxy Apache per i sottodomini di servizio di cPanel e il problema interessa tutte le pagine cPanel, non solo questo plugin. L'indirizzo diretto https://<domain>:2083 non è interessato. Per correggere il problema, apri WHM » Service Configuration » Apache Configuration » Include Editor, scegli Pre VirtualHost Include per tutte le versioni, aggiungi le righe seguenti e salva:

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

Quindi applica la modifica:

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

10. Assistenza

Scrivi a hi@email-spam-tester.com. Includi l'output di ./install.sh se l'installazione non è riuscita, oppure il link al report se un test sembra errato. Ulteriori informazioni sul plugin sono disponibili all'indirizzo https://email-spam-tester.com/cpanel-integration/.