Versão 0.1.0, 1º de outubro de 2026. Baixar (75 KB), SHA-256 5df918a10cd996799f5d144abcc101970fab31fbb7e2298be78362257c0aaa28. As etapas de instalação estão no final desta página. Dentro do arquivo, o mesmo texto está em INSTALL.md. O código e o mesmo arquivo, como uma versão, também estão no GitHub.
Para quem é
Provedores de hospedagem cujos servidores executam o Plesk Obsidian 18.0.50 ou mais recente no Linux. Você instala a extensão como root e registra o servidor uma vez. Depois disso, cada cliente encontra o Email Spam Tester em Websites & Domains › seu domínio › Mail, ao lado de Mail Settings. Os planos de serviço determinam quais partes ficam disponíveis para cada cliente.
Um testador web não consegue analisar o lado do envio, ele vê apenas o e-mail que chegou até ele. A extensão envia o teste pelo seu servidor, por meio do Postfix, assinado com a chave DKIM do domínio e usando o IP e o nome HELO do servidor. Assim, o relatório avalia a configuração que o cliente realmente tem. E, como o Plesk gerencia a zona DNS do domínio, muitas vezes basta clicar em um botão para adicionar um registro ausente.
O que o cliente vê
Teste
Na parte superior, há uma verificação executada antes do envio de qualquer e-mail: se este servidor passa no SPF do domínio, se o Plesk assina com DKIM e se a chave no DNS corresponde à usada na assinatura, além da política DMARC e do MX. Cada problema tem um botão Corrigir ou Mostrar o registro quando o DNS do domínio é gerenciado em outro lugar.
Abaixo, o cliente escolhe uma caixa de e-mail do domínio e como o teste será enviado. O envio pode ser feito como essa caixa de e-mail ou da mesma forma que o site envia e-mails, usando o usuário de sistema da própria assinatura, que é como o WordPress, os formulários de contato e as notificações da loja enviam. A segunda opção detecta um problema comum de hospedagem: e-mails do PHP enviados com um remetente não coberto pelo SPF do domínio. O e-mail pode ser a mensagem de teste padrão, uma mensagem curta em inglês, com texto e HTML, ou a mensagem do próprio cliente, colada nos campos de assunto, HTML e texto opcional.
"Verificar também a pasta nos provedores de e-mail" vem ativado por padrão. Em segundo plano, em ordem aleatória e com intervalos de dois a quatro segundos, o servidor envia uma cópia para cada uma das nossas caixas de e-mail de teste no Gmail, Outlook, Yahoo e em outros provedores. Cada cópia tem seu próprio Message-ID, para que a extensão possa identificar as linhas correspondentes no log do Postfix. Ao longo da meia hora seguinte, a tabela é preenchida com o resultado por provedor: Caixa de entrada, Spam ou Promoções. Quando um provedor recusa a mensagem, é exibida a resposta dele com o código SMTP. No Gmail, essas são caixas de e-mail de teste públicas, e qualquer pessoa com acesso a elas vê o assunto, o nome do remetente e a pasta. Portanto, é melhor testar conteúdo confidencial sem a verificação de pasta.
O relatório contém todas as verificações, a pontuação de 0 a 100 e a pontuação clássica de 0 a 10, o plano da IA e os mesmos botões de correção. Dessa vez, eles usam o IP do qual o relatório realmente detectou que o e-mail foi enviado.
Histórico
Todos os testes do domínio, do mais recente para o mais antigo, com as duas pontuações e as contagens por pasta, um gráfico da pontuação e, para cada teste, as verificações que mudaram desde o anterior. Depois de corrigir o DKIM, a linha informa que o DKIM passou de falha para aprovação.
Monitoramento
Se você permitir isso no servidor, o cliente poderá ativar o monitoramento de um domínio. A partir desse momento, cada e-mail enviado pelo domínio recebe um relatório técnico com DKIM, SPF e DMARC, o IP de envio e as listas de bloqueio. A aba resume as últimas 24 horas por origem, então os e-mails enviados pelo PHP do site são contabilizados separadamente dos enviados pelo webmail ou por um aplicativo de e-mail. Em seguida, aparecem os alertas, por exemplo, quando o DKIM falha nos e-mails mais recentes ou quando o SPF falha nos e-mails enviados pelo site. Abaixo deles ficam os e-mails mais recentes com seus relatórios. Duas confirmações de pedido geradas pelo mesmo modelo de uma loja contam como uma única verificação dentro de uma hora, para que uma loja movimentada não produza mil relatórios idênticos. Um plano da IA para um único e-mail está disponível mediante solicitação.
O que o administrador recebe
Tools & Settings › Mail › Email Spam Tester contém o cadastro e a opção para ativar o monitoramento em todo o servidor. Nessa área, os limites são definidos por assinatura para testes, verificações de pastas, planos de IA e domínios monitorados, e por domínio monitorado para a quantidade de e-mails por dia. Uma tabela lista os IPs do próprio servidor, com o DNS reverso, a indicação de correspondência com o nome HELO e as listas de bloqueio.
A extensão adiciona quatro permissões aos planos de serviço: para a própria extensão, os botões de correção, a verificação de pastas e o monitoramento. As quatro ficam ativadas por padrão. Os botões de DNS também exigem a permissão do próprio plano para gerenciar o DNS, e a opção de DKIM exige a permissão para gerenciar as configurações de e-mail.
Preço
Grátis por enquanto, assim como o próprio tester. Se isso mudar, a informação aparecerá primeiro no registro de alterações. Os limites que você definir se aplicam dentro dos limites que o Email Spam Tester mantém por servidor (verificações de pastas, verificações de domínios e domínios monitorados por dia), e a página do administrador mostra ambos com o uso de hoje.
Como funciona e o que sai do seu servidor
A extensão envia o e-mail de teste a partir do seu servidor e não toma nenhuma decisão por conta própria. Os resultados das verificações, o histórico, as alterações, qual registro DNS publicar, o feed de monitoramento, os alertas e os limites são todos processados pela API do Email Spam Tester, a mesma usada pelo site. Estes dados são enviados à API:
- o hostname do servidor, as versões do Plesk e da extensão, o número de domínios e, caso você o forneça, o e-mail do administrador, uma única vez, durante o cadastro;
- os e-mails de teste;
- cada assinatura como um hash com chave, nunca o nome dela;
- para a verificação de DNS, os registros TXT que o Plesk mantém para o domínio, a chave DKIM, os IPs e o nome HELO do servidor, além de uma caixa de e-mail do domínio para relatórios DMARC;
- as linhas do log de e-mail referentes aos nossos próprios e-mails de teste;
- com o monitoramento, cópias dos e-mails enviados pelo domínio.
Os relatórios de teste têm links, assim como no site, e qualquer pessoa que tenha o link pode abrir o relatório. O feed de monitoramento é diferente, pois contém e-mails reais dos seus clientes. Os relatórios dele só podem ser abertos com a chave do seu servidor, e a cópia do e-mail é excluída após dois dias e o relatório após 90 dias. A página de privacidade contém as demais informações.
Perguntas dos provedores de hospedagem
Ele altera o DNS sozinho?
Não. Um registro só é alterado quando o cliente pressiona Corrigir e confirma como o registro está agora e como ficará, e somente quando o DNS do domínio realmente é consultado no seu servidor. Um registro SPF mantém todos os termos existentes. O IP do servidor é adicionado primeiro e não gera nenhuma consulta DNS adicional. Uma política DMARC existente nunca é substituída. Cada alteração é registrada no log de ações do Plesk e pode ser desfeita na aba Test, desde que ninguém tenha editado o registro depois disso. Os resolvedores públicos armazenam em cache a ausência de um registro durante o período mínimo do SOA da zona, que é de três horas no modelo padrão do Plesk. Por isso, um teste feito logo após uma correção ainda pode mostrar o resultado anterior.
Como o monitoramento copia os e-mails?
Um manipulador de e-mail do Plesk é executado depois que o Plesk assina o e-mail com DKIM. Ele encaminha todas as mensagens sem alterações e, para um domínio com o monitoramento ativado, entrega uma cópia a um listener do Postfix em 127.0.0.1 que aceita apenas nossos endereços de monitoramento. Em seguida, o Postfix entrega a cópia como qualquer outro e-mail, a partir do mesmo IP e com a mesma assinatura. A identificação do proprietário do e-mail vem do login SMTP ou do usuário de sistema da assinatura, nunca apenas do endereço do remetente. Assim, ninguém pode inserir seus e-mails no feed de outro cliente. O manipulador é instalado em /usr/local/lib/email-spam-tester, e a lista de domínios, em /etc/email-spam-tester/monitor.json.
Isso deixa o envio de e-mails mais lento?
O manipulador lê a mensagem e a devolve. A cópia é enviada ao listener local por um processo separado, portanto a mensagem original não espera pela entrega da cópia. Enviei um anexo de 5 MB por sendmail e SMTP com o monitoramento ativado, e tanto a mensagem original quanto a cópia chegaram.
O que foi testado em um ambiente real?
Plesk Obsidian 18.0.81 no Ubuntu 24.04, em um servidor com IP público e um domínio cujo DNS é hospedado pelo servidor: instalação, desinstalação e reinstalação, registro, um teste com verificação da pasta a partir de um domínio sem DKIM, SPF ou DMARC, os três botões de correção, um segundo teste com aprovação nos três itens, o histórico e o monitoramento de e-mails enviados pelo site e por um aplicativo de e-mail. As páginas web foram testadas em uma instalação local do Plesk. Ainda não foram testados: outras distribuições Linux e versões do Plesk, um servidor que encaminha e-mails por um smarthost e qmail em vez de Postfix. O Plesk para Windows não é compatível. Escreva para mim se você executar a extensão em um desses ambientes.
Instalação passo a passo
Este guia pressupõe que você tenha acesso root a um servidor Plesk. Todos os comandos abaixo devem ser copiados e colados exatamente como estão.
1. Requisitos
- Acesso SSH root ao servidor.
- Plesk Obsidian 18.0.50 ou mais recente no Linux, com Postfix como servidor de e-mail, que é o padrão do Plesk. Testado em produção no Plesk Obsidian 18.0.81 com Ubuntu 24.04.
- Porta de saída 25 aberta, para que os e-mails do servidor possam chegar a
t.email-spam-tester.com. Muitos provedores de VPS bloqueiam essa porta por padrão. - HTTPS de saída para
email-spam-tester.com.
Você pode verificar os dois 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
Acesse o servidor via SSH como root. Baixe a extensão e seu checksum:
cd /root
curl -fsSLO https://email-spam-tester.com/plesk/latest.zip
curl -fsSLO https://email-spam-tester.com/plesk/latest.zip.sha256
Verifique se o download está íntegro. Você deve ver latest.zip: OK. Se aparecer FAILED, faça o download novamente e não continue:
sha256sum -c latest.zip.sha256
Instale a extensão:
plesk bin extension --install /root/latest.zip
A última linha deve ser The extension was successfully installed.
3. Registro do servidor
No Plesk, acesse Tools & Settings › Mail › Email Spam Tester e clique em Register this server. Você pode informar um endereço de e-mail para receber avisos sobre o serviço, mas isso é opcional.
O registro envia o hostname do servidor, as versões do Plesk e da extensão, o número de assinaturas e esse endereço de e-mail. A resposta é uma chave que permanece neste servidor, criptografada nas configurações da extensão. Os clientes nunca têm acesso a ela.
Os clientes encontram o Email Spam Tester em Websites & Domains › a domain › Mail. Enquanto o servidor não estiver registrado, a extensão apenas informa que eles devem entrar em contato com você.
4. Definição de quem recebe cada recurso
Em Service Plans › a plan › Permissions, e também nas permissões de cada assinatura, a extensão adiciona quatro permissões, todas ativadas por padrão:
- Email Spam Tester: a própria extensão;
- fix DNS and mail settings: os botões de DKIM, SPF e DMARC. Os botões de DNS também exigem a permissão do próprio plano para gerenciar o DNS, e a opção de DKIM exige a permissão para gerenciar as configurações de e-mail;
- folder check: envio de uma cópia para caixas de correio de teste em provedores de e-mail;
- constant monitoring: ativação do monitoramento para um domínio.
Os limites por assinatura, incluindo testes, verificações de pasta, planos de IA, domínios monitorados e e-mails monitorados por domínio por dia, ficam na mesma página Tools & Settings › Mail › Email Spam Tester.
5. Monitoramento contínuo (opcional)
Nada é copiado até que você permita e um cliente ative o recurso para o domínio dele. Na página da extensão em Tools & Settings, clique em Allow constant monitoring on this server. Isso adiciona:
- um handler de e-mail do Plesk que é executado após a assinatura DKIM dos e-mails enviados, encaminha todas as mensagens sem alterações e, para os domínios com o recurso ativado, entrega uma cópia a
- um listener do Postfix em
127.0.0.1:10597que aceita apenas os endereços de monitoramento do Email Spam Tester, para que a cópia saia com o mesmo IP e HELO da mensagem original; - a lista de domínios monitorados em
/etc/email-spam-tester/monitor.json.
A mesma página contém a opção Disable on the whole server, que remove os três itens e desativa o recurso para todos os domínios.
Para verificar o estado pela linha de comando:
/usr/local/psa/admin/sbin/modules/email-spam-tester/est-monitor status
"state": "active" significa que o recurso está ativado; "off" significa que ele nunca foi permitido ou foi removido; "partial" significa que está faltando algum componente, pois o Plesk às vezes regrava o arquivo master.cf do Postfix durante uma atualização. A opção Repair, na mesma página, restaura o componente. Uma tarefa diária também faz isso automaticamente.
6. Atualização
Baixe o novo latest.zip e seu checksum como na etapa 2, verifique-os e execute:
plesk bin extension --upgrade /root/latest.zip
O registro, os limites e o monitoramento permanecem como estavam. Se o monitoramento estiver ativado, os arquivos dele serão atualizados para a nova versão.
7. Desinstalação
plesk bin extension --uninstall email-spam-tester
Isso remove o monitoramento do Postfix e dos handlers de e-mail do Plesk, além de desativar todos os domínios monitorados. Os registros DNS nunca são alterados, incluindo os que os clientes criaram usando os botões da extensão.
Se o monitoramento estiver ativado, é recomendável removê-lo primeiro. Assim, qualquer falha nessa etapa ficará visível, em vez de aparecer apenas no log do Plesk:
/usr/local/psa/admin/sbin/modules/email-spam-tester/est-monitor disable
O estado é exibido no final. "state": "off" significa que o handler, o listener e a lista foram removidos.
8. Se algo não funcionar
- "The mail server did not accept the email" durante um teste: o Postfix local recusou a mensagem, e o texto após os dois-pontos é a resposta dele. Verifique se o Postfix está em execução (
systemctl status postfix). - Um teste fica aguardando e nada chega: após 30 segundos, a página do teste mostra o que o log de e-mail do servidor informa sobre a mensagem. Se uma conexão com a porta 25 expirar, isso significa que seu provedor bloqueia a porta de saída 25. Execute a primeira verificação da etapa 1 para confirmar.
- Uma correção mostra um registro para copiar em vez de um botão: o DNS do domínio é fornecido por outro servidor, como um registrador ou Cloudflare. Adicione o registro nesse serviço.
- Logo após uma correção de DNS, um teste ainda mostra o resultado antigo: os resolvedores DNS públicos podem manter em cache que um registro não existia pelo período definido no TTL mínimo do SOA da zona, que é de três horas no modelo de zona padrão do Plesk. Faça outro teste mais tarde.