Email Spam Tester

Email Spam Tester › Email Spam Tester para cPanel e WHM

Email Spam Tester para cPanel e WHM

Um plugin para provedores de hospedagem. Seus clientes o encontram no cPanel, em Email, enviam um e-mail real de uma das próprias caixas de correio e recebem uma lista do que precisam corrigir, com o registro DNS exato ou o botão do cPanel ao lado de cada problema encontrado.

Versão 0.1.1, 30 de setembro de 2026. Baixar (94 KB), SHA-256 4909ff8402b3244711bc13bac96cfc22810ee33d48f80885f87e44809572cdd0. As etapas de instalação estão no final desta página, e o mesmo texto está no arquivo INSTALL.md incluído no pacote. O código-fonte, os testes e as versões estão no GitHub.

Para quem é

Empresas que operam servidores cPanel & WHM para terceiros. Você instala uma vez como root, e a ferramenta aparece em cPanel » Email nos pacotes que você escolher. Até você ativá-la no Feature Manager, os clientes não veem nenhuma novidade.

Sem ela, um cliente que queira saber por que seus e-mails chegam à pasta de spam precisa encontrar uma ferramenta de teste, abrir um cliente de e-mail e enviar um e-mail manualmente. Com ela, o teste fica disponível em um botão ao lado das caixas de e-mail, e o e-mail realmente sai do seu servidor, com o IP, o nome HELO, a assinatura DKIM e qualquer relay pelo qual passe.

O que os clientes recebem no cPanel

Teste

O cliente escolhe uma caixa de e-mail e envia o e-mail de teste padrão, um e-mail pessoal curto em inglês, com uma parte em texto e outra em HTML, ou uma mensagem própria. Para enviar uma mensagem própria, ele insere o assunto, o HTML e, opcionalmente, uma versão em texto simples. A mensagem é enviada exatamente como foi inserida. O Exim a envia como qualquer outro e-mail dessa conta. Cerca de um minuto depois, o relatório aparece na mesma página com todas as 42 verificações: SPF, DKIM, DMARC e alinhamento, DNS reverso e HELO, TLS, listas de bloqueio de IP, SpamAssassin e Rspamd, os requisitos para remetentes publicados pelo Gmail e Yahoo e o conteúdo. Há duas pontuações, uma técnica de 0 a 100 e a clássica de 0 a 10.

"Verificar a pasta nos provedores de e-mail" vem marcado por padrão. Com essa opção, uma cópia do e-mail também é enviada para cada uma das nossas caixas de teste, cerca de 30 e-mails em 14 provedores, incluindo Gmail, Outlook, Yahoo, GMX e Proton. No Gmail, essas caixas de teste são públicas, e qualquer pessoa pode ver o assunto, o nome do remetente e a pasta. A tabela é preenchida ao longo de até 30 minutos e mostra Caixa de entrada, Spam ou Promoções para cada provedor. Se um provedor tiver recusado o e-mail imediatamente, a tabela informa isso e cita a resposta do servidor, incluindo o código SMTP, com base no log do Exim no seu servidor.

Abaixo das pontuações aparece O que corrigir. Quando o DNS do domínio está no seu servidor, o cPanel pode corrigir DKIM, SPF e DMARC com um botão. O plugin mostra o registro atual e como ele ficará, e pede confirmação antes de alterá-lo. Quando o DNS está hospedado em outro lugar, o cliente recebe o registro exato que deve copiar, com nome, tipo e valor. O DNS reverso e o registro A do próprio servidor ficam em um grupo separado destinado ao administrador do servidor, com os valores já preenchidos. Alguns minutos após as verificações, é apresentado um plano por escrito do Email Spam Tester, e "Verificar novamente" envia um novo e-mail depois que os registros forem configurados.

Histórico

Todos os testes enviados pela conta aparecem do mais recente para o mais antigo, com a data, a caixa de e-mail, qual e-mail foi usado, as duas pontuações e as contagens por pasta. Um gráfico mostra a pontuação de um teste para outro. Cada teste lista as verificações que mudaram desde o teste anterior do mesmo domínio. Assim, se uma verificação de DKIM passou de falha para aprovação após uma correção, a mudança aparece na própria linha. Ao abrir um teste, são exibidos o relatório e, para cada provedor, as respostas dos servidores de recebimento. Os últimos 200 testes de cada conta são mantidos no seu servidor.

Monitoramento contínuo

Um teste feito a partir de uma caixa de e-mail mostra como as mensagens dessa caixa são enviadas. O problema clássico do cPanel está em outro lugar. Um site WordPress ou um formulário de contato envia com o remetente do envelope user@hostname, o alinhamento SPF falha e nenhum teste feito a partir de uma caixa de e-mail mostrará isso. O monitoramento mostra.

A cópia invisível criada pelo monitoramento sai do seu servidor pelo mesmo caminho que o e-mail, usando o mesmo IP, o mesmo HELO e a mesma assinatura DKIM. O Exim cria essa cópia para cada e-mail enviado por um domínio monitorado e a entrega a um endereço privado que pertence ao domínio. Assim, o relatório descreve o caminho real, enquanto o próprio e-mail chega aos destinatários sem alterações.

A aba Monitoramento mostra os e-mails do domínio em um feed. Cada item informa o domínio do destinatário, nunca o endereço, a origem do e-mail e o que falhou. As origens podem ser webmail, um cliente de e-mail, PHP ou WordPress e scripts que chamam sendmail. Acima do feed ficam um resumo de uma linha das últimas 24 horas e os alertas: DKIM deixou de ser aprovado, SPF ou DMARC está falhando para uma origem, o IP de envio entrou em uma lista de bloqueio ou servidores de recebimento estão recusando e-mails. Cada e-mail pode ser aberto como um relatório técnico das verificações, sem incluir os cabeçalhos do e-mail, e o cliente pode solicitar um plano gerado por AI para ele.

O monitoramento permanece desativado até que o administrador o permita no servidor. Depois disso, cada cliente pode ativá-lo para os próprios domínios.

O que você encontra no WHM

WHM » Plugins » Email Spam Tester fica em uma única página.

Preço

Grátis por enquanto, com monitoramento incluído. Não é necessário criar uma conta no email-spam-tester.com nem pagar nada no momento. Se isso mudar algum dia, a informação será publicada primeiro no registro de alterações.

Dados e privacidade

O que sai do seu servidor:

Um relatório de teste funciona como no site: ele permanece disponível em seu link, e qualquer pessoa com o link pode abri-lo, incluindo o assunto e o remetente. O próprio e-mail é excluído uma hora após chegar, depois que as verificações são concluídas. Até lá, qualquer pessoa com o link pode lê-lo por completo. A parte do Gmail na verificação de pasta também é pública, como descrito acima, por isso é melhor testar e-mails confidenciais sem ela.

As cópias de monitoramento são correspondências reais, e seus relatórios são privados. Somente o plugin em seu servidor pode abri-los, usando a chave de instalação, e não há link público. Uma cópia é excluída dois dias após chegar, e seu relatório, após 90 dias. O histórico e o feed de monitoramento permanecem em seu servidor.

A página de privacidade contém a política completa.

Perguntas que os provedores de hospedagem fazem

Ele altera o DNS por conta própria?

Não. Um registro só é alterado quando o cliente pressiona o botão ao lado de um problema encontrado e confirma o antes e o depois, e somente quando seu servidor hospeda o DNS do domínio. Os botões de SPF e DMARC apenas criam um registro que está ausente. Quando já existe um registro, ele é exibido de forma consolidada para o cliente copiar manualmente, e o botão nunca o substitui. O botão de DKIM pode substituir um registro que não corresponde à chave do servidor, mas somente se houver exatamente um. Cada alteração é registrada no log da conta e em outro, em /var/cpanel/email_spam_tester/, que somente o root pode editar, junto com o registro DNS que estava sendo servido antes da alteração.

Meu servidor encaminha os e-mails enviados por um smarthost. Ainda funciona?

Deve funcionar, mas ainda não testei atrás de um smarthost. O e-mail de teste sai da mesma forma que todos os e-mails da conta, portanto o relatório mostra o IP e o nome do relay, porque é isso que os destinatários veem. Corrigir o DNS reverso ou remover esse IP de uma lista de bloqueio passa a ser responsabilidade de quem opera o relay. Uma informação é perdida. Os motivos que um provedor apresenta para recusar um e-mail vêm do log do Exim no seu servidor, e, com um relay, esse log contém apenas a resposta do relay. Um e-mail que o relay aceitou, mas que um provedor recusou depois, pode aparecer como "Não recebido". As cópias de monitoramento também passam pelo relay.

O monitoramento afeta a entregabilidade?

O e-mail do cliente é enviado como antes, sem alterações, e os destinatários não veem nada, pois a cópia é uma entrega separada para o nosso endereço. O monitoramento afeta o limite de envio por hora. Cada cópia é contabilizada uma vez no "max emails per hour" do domínio, portanto um domínio próximo do limite o atinge mais cedo, em no máximo 20 e-mails por hora com a configuração padrão. Depois desse número de cópias em uma hora, os e-mails são enviados sem cópia.

O teste de pastas também conta para o limite por hora?

Sim, ele envia cerca de 30 e-mails. Antes de começar, o plugin verifica quantos e-mails o domínio ainda pode enviar nessa hora e avisa o cliente se esse número não for suficiente.

O que foi testado em um ambiente real?

Há suporte para cPanel & WHM 134 ou mais recente. Até agora, testei em um ambiente real a versão 138 (11.138) no Ubuntu 24.04. Isso inclui a instalação e uma atualização, o registro, o controle de ativação do recurso, testes com e sem o teste de pastas, o histórico e o monitoramento de e-mails das quatro origens. Ainda não foram testados em um ambiente real os outros sistemas operacionais, o CloudLinux com CageFS, os botões de DKIM, SPF e DMARC (o DNS do servidor de teste está hospedado em outro lugar), um servidor que encaminha e-mails por um smarthost e a desativação do monitoramento para todo o servidor, que foi testada apenas em uma simulação. Se você executar o plugin em um desses ambientes, gostaria de saber como foi.

Instalação passo a passo

Este guia pressupõe que você tenha acesso root ao servidor e nunca tenha usado plugins do WHM. Todos os comandos abaixo devem ser copiados e colados exatamente como estão.

1. O que você precisa

Você pode verificar as duas conexões antes da instalação. O primeiro comando deve exibir uma linha que começa com 220, e o segundo deve exibir 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. Instalação

Entre por SSH como root e execute estes comandos, um de cada vez.

Vá para o diretório inicial do root, onde o plugin ficará:

cd /root

Baixe o arquivo compactado e sua soma de verificação. Quando funciona, nada é exibido:

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

Verifique se o download está íntegro. Você deve ver latest.tar.gz: OK. Se vir FAILED, faça o download novamente e não continue:

sha256sum -c latest.tar.gz.sha256

Extraia o conteúdo para /root/email-spam-tester-cpanel. Novamente, nada é exibido:

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

Execute o instalador. Primeiro, ele verifica todos os arquivos e depois os copia para os locais corretos:

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

Você deve ver Checking Perl syntax…, Root module…, cPanel pages…, algumas linhas do próprio instalador de plugins do cPanel, Switching the feature off in all feature lists… e WHM page…. As últimas linhas devem ser:

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.

Mantenha o diretório /root/email-spam-tester-cpanel. As atualizações e o uninstall.sh são executados a partir dele.

3. Registre o servidor no WHM

  1. Entre no WHM como root.
  2. No menu à esquerda, abra Plugins e clique em Email Spam Tester.
  3. A caixa Registro mostra "Não registrado". O campo de e-mail do administrador abaixo dela é opcional.
  4. Clique em Registrar este servidor.

Uma linha verde aparece na parte superior, "Registrado. Instalação nº…", e a caixa passa a mostrar Status: Registrado, com o número da instalação e o início da chave. O registro envia o hostname do servidor, a versão do cPanel, a versão do plugin, o número de contas e o e-mail, caso você tenha informado um. A chave fica armazenada em /var/cpanel/email_spam_tester/config.json, com permissão de leitura apenas para root.

Na mesma página, você pode alterar os limites diários: por padrão, são 20 testes por conta e 500 por servidor.

4. Ative o plugin para os clientes

Depois da instalação, ninguém vê o plugin. Você escolhe quais pacotes terão acesso a ele.

  1. Descubra qual lista de recursos seus pacotes usam: WHM » Packages » Edit a Package, escolha um pacote e verifique o campo Feature List. Em muitos servidores, ele é default.
  2. Abra WHM » Packages » Feature Manager.
  3. Em Manage feature list, selecione essa lista e clique em Edit.
  4. Encontre Email Spam Tester na lista. Se ela for longa, use a função de busca do navegador. Marque a caixa de seleção e clique em Save.
  5. Repita para cada lista de recursos que deve incluir o plugin.

Os clientes desses pacotes agora verão Email Spam Tester no cPanel, na seção Email. Lembre-se de também marcá-lo nas listas de recursos que você criar depois.

5. Envie o primeiro teste como cliente

Entre no cPanel como um desses clientes. No WHM, você pode usar Account Information » List Accounts e o ícone do cPanel ao lado da conta.

  1. Abra Email » Email Spam Tester. A página tem três abas: Teste, Histórico e Monitoramento.
  2. Na aba Teste, escolha uma caixa de e-mail. Se a conta não tiver nenhuma, primeiro crie uma em Email » Email Accounts.
  3. Mantenha E-mail de teste padrão selecionado e Verificar a pasta nos provedores de e-mail marcado.
  4. Clique em Enviar teste.

A página mostra o que está fazendo: verificando os registros DNS, enviando e aguardando a chegada do e-mail. Cerca de um minuto depois, o relatório aparece. Ele tem duas pontuações, uma técnica de até 100 e a clássica de 0 a 10, seguidas por O que corrigir. Essa lista mostra um botão quando o cPanel pode corrigir um registro neste servidor, o registro exato que deve ser copiado quando o DNS está hospedado em outro lugar e os valores de DNS reverso para você, como administrador do servidor. Depois aparecem todas as verificações. Onde o e-mail chegou é preenchido ao longo dos 30 minutos seguintes com Caixa de entrada, Spam ou Promoções para cada provedor de e-mail, além da resposta do provedor quando ele recusa o e-mail. Um plano por escrito aparece alguns minutos depois das verificações.

A verificação de pasta envia cerca de 30 e-mails. Se o limite de envio por hora do domínio não tiver capacidade para eles, a página informa isso antes de enviar qualquer mensagem.

6. Monitoramento contínuo (opcional)

Com o monitoramento ativado para um domínio, o Exim envia uma cópia invisível de cada e-mail enviado pelo domínio para um endereço privado no Email Spam Tester, e o cliente vê um relatório técnico de cada e-mail. Os destinatários não veem nada. Cada cópia conta uma vez no limite de envio por hora do domínio, com um máximo padrão de 20 cópias por hora.

  1. Em WHM » Plugins » Email Spam Tester, encontre a caixa Monitoramento contínuo e clique em Permitir monitoramento contínuo neste servidor. O plugin verifica a configuração do Exim, adiciona a regra, recompila e reinicia o Exim, e desfaz todas as alterações se alguma etapa falhar. Quando funciona, você vê "O monitoramento contínuo está permitido neste servidor: a regra do Exim foi adicionada, e o Exim foi recompilado e reiniciado.", e a caixa mostra a regra como Ativa.
  2. O cliente abre a aba Monitoramento no cPanel, clica em Ativar ao lado de um domínio e confirma. Os e-mails enviados depois disso aparecem na aba em um ou dois minutos.

Para interromper o monitoramento em todo o servidor, clique em Desativar o monitoramento em todo o servidor na mesma caixa.

7. Atualização

Baixe e extraia a nova versão sobre a antiga e execute o instalador novamente:

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

Ele deve terminar com "Atualizado. O registro, os limites e as configurações de recursos permanecem inalterados." Se o monitoramento estiver permitido, o instalador também atualizará a regra do Exim.

8. Desinstalação

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

Esse comando remove a regra de monitoramento do Exim, desativa o monitoramento de todos os domínios e remove o plugin do cPanel e do WHM. Ele termina com "Removido. A chave foi mantida em /var/cpanel/email_spam_tester (use --purge para excluí-la)." Execute ./uninstall.sh --purge para excluir também a chave.

Os registros DNS nunca são alterados, incluindo os que os clientes criaram usando os botões do plugin.

9. Se algo der errado

Os clientes não veem o ícone. O recurso está desativado na lista de recursos do pacote deles. Repita a etapa 4 e verifique qual lista de recursos o pacote realmente usa.

A página informa "O administrador do servidor ainda não ativou o Email Spam Tester no WHM". O servidor não está registrado. Siga a etapa 3.

O registro falha. A mensagem vermelha na parte superior da página do WHM informa o motivo. Na maioria dos casos, o servidor não consegue acessar email-spam-tester.com por HTTPS. Execute a verificação com curl da etapa 1, que deve exibir 200, e verifique as regras do firewall para o tráfego de saída.

O teste informa que a mensagem não chegou em 3 minutos. O e-mail está preso na fila ou foi recusado. Execute a verificação da porta 25 da etapa 1. Se ela não exibir nada ou atingir o tempo limite, seu provedor bloqueia a porta 25 de saída. Peça que ele abra a porta ou envie os e-mails por um relay. Para ver o que o Exim fez com o e-mail:

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

O cliente também pode verificar a caixa de e-mail em Email » Track Delivery.

As páginas em cpanel.<domain> às vezes falham com um erro 502. Isso ocorre no proxy do Apache para os subdomínios de serviço do cPanel e afeta todas as páginas do cPanel, não apenas este plugin. O endereço direto https://<domain>:2083 não é afetado. Para corrigir, abra WHM » Service Configuration » Apache Configuration » Include Editor, escolha Pre VirtualHost Include para todas as versões, adicione estas linhas e salve:

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

Depois, aplique a alteração:

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

10. Suporte

Escreva para hi@email-spam-tester.com. Inclua a saída de ./install.sh se a instalação falhar ou o link do relatório se algum teste parecer incorreto. Mais informações sobre o plugin estão em https://email-spam-tester.com/cpanel-integration/.