Email Spam Tester

Email Spam Tester › Email Spam Tester para Plesk

Email Spam Tester para Plesk

Uma extensão para fornecedores de alojamento que utilizam Plesk. Os clientes abrem-na no separador Mail de um domínio, enviam um email de teste que sai efetivamente do seu servidor e recebem as verificações, veem em que pasta chega nos fornecedores de email e têm botões para corrigir DKIM, SPF e DMARC.

Versão 0.1.0, 1 de outubro de 2026. Descarregar (75 KB), SHA-256 5df918a10cd996799f5d144abcc101970fab31fbb7e2298be78362257c0aaa28. Os passos de instalação estão no final desta página. Dentro do arquivo, o mesmo texto encontra-se em INSTALL.md. O código e o mesmo arquivo, como versão publicada, também estão no GitHub.

A quem se destina

Fornecedores de alojamento cujos servidores executam o Plesk Obsidian 18.0.50 ou uma versão posterior em Linux. Instale a extensão como root e registe o servidor uma única vez. Depois disso, todos os clientes encontram o Email Spam Tester em Websites & Domains › respetivo domínio › Mail, junto a Mail Settings. Os planos de serviço determinam a que partes cada cliente tem acesso.

Um testador Web não consegue analisar o lado do envio, apenas vê o email que recebeu. A extensão envia o teste a partir do seu servidor, através do Postfix, assinado com a chave DKIM do domínio e usando o respetivo IP e nome HELO. Assim, o relatório analisa a configuração que o cliente utiliza realmente. Como o Plesk gere a zona DNS do domínio, muitas vezes basta clicar num botão para adicionar um registo em falta.

O que um cliente vê

Teste

No topo, existe uma verificação executada antes do envio de qualquer email: se este servidor passa no SPF do domínio, se o Plesk assina com DKIM e se a chave no DNS é a utilizada na assinatura, a política DMARC e o MX. Cada problema tem um botão Corrigir, ou Mostrar o registo quando o DNS do domínio está alojado noutro local.

Abaixo, o cliente escolhe uma caixa de correio do domínio e a forma como o teste é enviado. Pode ser enviado como essa caixa de correio ou da mesma forma que o site envia emails, com o utilizador de sistema da própria subscrição, que é como o WordPress, os formulários de contacto e as notificações da loja enviam emails. A segunda opção deteta um problema comum em alojamentos, emails do PHP enviados com um remetente que não está abrangido pelo SPF do domínio. O email pode ser o email de teste padrão (uma mensagem curta em inglês, em texto e HTML) ou o email do próprio cliente, colado nos campos de assunto, HTML e texto opcional.

A opção "Verificar também a pasta nos fornecedores de email" está ativa por predefinição. Em segundo plano, por ordem aleatória e com intervalos de dois a quatro segundos, o servidor envia uma cópia para cada uma das nossas caixas de correio de teste no Gmail, Outlook, Yahoo e noutros fornecedores. Cada cópia tem o seu próprio Message-ID, para que a extensão consiga identificar as respetivas linhas no registo do Postfix. Durante a meia hora seguinte, a tabela é preenchida: Caixa de entrada, Spam ou Promoções para cada fornecedor ou, quando um fornecedor recusa a mensagem, a respetiva resposta com o código SMTP. No Gmail, estas são caixas de correio de teste públicas, e qualquer pessoa com acesso vê o assunto, o nome do remetente e a pasta, pelo que é preferível testar conteúdo confidencial sem a verificação da pasta.

O relatório inclui todas as verificações, a pontuação de 0 a 100 e a pontuação clássica de 0 a 10, o plano de IA e os mesmos botões de correção, desta vez usando o IP de onde o relatório efetivamente detetou que o email foi enviado.

Histórico

Todos os testes do domínio, do mais recente para o mais antigo, com ambas as pontuações e as contagens por pasta, um gráfico da pontuação e, para cada teste, as verificações que mudaram desde o teste anterior. Depois de uma correção do DKIM, a linha indica que o DKIM passou de falha para aprovado.

Monitorização

Se o permitir no servidor, um cliente pode ativar a monitorização para um domínio. A partir desse momento, cada email enviado pelo domínio recebe um relatório técnico com DKIM, SPF e DMARC, o IP de envio e as listas de bloqueio. O separador resume as últimas 24 horas por origem, pelo que os emails enviados pelo PHP do site são contabilizados separadamente dos enviados pelo webmail ou por uma aplicação de email. A seguir aparecem os alertas, por exemplo, quando o DKIM falha nos emails mais recentes ou o SPF falha para emails enviados pelo site. Abaixo estão os emails mais recentes com os respetivos relatórios. Duas confirmações de encomenda com base no mesmo modelo de loja contam como uma única verificação no período de uma hora, para que uma loja com muita atividade não produza mil relatórios idênticos. Está disponível, mediante pedido, um plano de IA para um único email.

O que o administrador obtém

Tools & Settings › Mail › Email Spam Tester inclui o registo e o interruptor para ativar a monitorização em todo o servidor. É aí que são definidos os limites por subscrição para testes, verificações de pastas, planos de AI e domínios monitorizados, bem como o limite de emails por dia para cada domínio monitorizado. Uma tabela apresenta os IP do próprio servidor, o respetivo DNS inverso, se este corresponde ao 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 a monitorização. As quatro estão ativadas por predefinição. Os botões de DNS também requerem a permissão do próprio plano para gerir o DNS, e o interruptor de DKIM requer a permissão para gerir as definições de email.

Preço

Gratuito por enquanto, tal como o próprio tester. Se isso mudar, será anunciado primeiro no registo de alterações. Os limites que definir aplicam-se dentro dos limites que o Email Spam Tester mantém por servidor (verificações de pastas, verificações de domínios e domínios monitorizados por dia), e a página do administrador mostra ambos, juntamente com a utilização de hoje.

Como funciona e que dados saem do servidor

A extensão envia o email de teste a partir do seu servidor e não toma qualquer decisão por si própria. Os resultados das verificações, o histórico, o que mudou, que registo DNS publicar, o fluxo de monitorização, os alertas e os limites são todos determinados pela API do Email Spam Tester, a mesma que o site utiliza. São enviados para a API:

Os relatórios de teste têm ligações, tal como no site, e qualquer pessoa que tenha a ligação pode abrir o respetivo relatório. O fluxo de monitorização é diferente, pois contém emails reais dos seus clientes. Os respetivos relatórios só podem ser abertos com a chave do seu servidor, e o email copiado é eliminado após dois dias e o respetivo relatório após 90 dias. A página de privacidade contém as restantes informações.

Perguntas dos fornecedores de alojamento

Altera o DNS automaticamente?

Não. Um registo só é alterado quando o cliente clica em Fix e confirma o registo tal como está e como ficará, e apenas quando o DNS público do domínio é efetivamente servido pelo seu servidor. Um registo SPF mantém todos os termos existentes. O IP do servidor é adicionado no início e não implica nenhuma consulta DNS adicional. Uma política DMARC existente nunca é substituída. Todas as alterações são registadas no registo de ações do Plesk e podem ser anuladas no separador Test, desde que ninguém tenha editado o registo entretanto. Os resolvedores públicos mantêm em cache a ausência de um registo durante o valor mínimo SOA da zona, três horas no modelo predefinido do Plesk, pelo que um teste efetuado logo após uma correção ainda pode mostrar o resultado anterior.

Como é que a monitorização copia o email?

Um processador de correio do Plesk é executado depois de o Plesk assinar o email com DKIM. Encaminha todas as mensagens sem alterações e, no caso de um domínio com a monitorização ativada, entrega uma cópia a um serviço de escuta do Postfix em 127.0.0.1, que aceita apenas os nossos endereços de monitorização. Em seguida, o Postfix entrega a cópia como qualquer outro email, a partir do mesmo IP e com a mesma assinatura. A identificação do proprietário do email é obtida através do início de sessão SMTP ou do utilizador de sistema da subscrição, nunca apenas através do endereço do remetente, pelo que ninguém pode introduzir os seus emails no fluxo de outro cliente. O processador é instalado em /usr/local/lib/email-spam-tester e a lista de domínios em /etc/email-spam-tester/monitor.json.

Torna o envio de correio mais lento?

O processador lê a mensagem e devolve-a. A cópia é enviada para o serviço de escuta local através de um processo separado, pelo que a mensagem original não espera pela entrega da cópia. Enviei um anexo de 5 MB através de sendmail e SMTP com a monitorização ativada, e tanto a mensagem original como a cópia chegaram ao destino.

O que foi testado num ambiente real?

Plesk Obsidian 18.0.81 no Ubuntu 24.04, num servidor com um IP público e um domínio cujo DNS é servido por esse servidor: instalação, desinstalação e reinstalação, registo, 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 as três verificações aprovadas, o histórico e a monitorização de emails enviados pelo site e por uma aplicação de correio. As páginas Web foram testadas num Plesk local. Ainda não foram testados: outras distribuições Linux e versões do Plesk, um servidor que encaminhe correio através de um smarthost e qmail em vez de Postfix. O Plesk para Windows não é suportado. Escreva-me se o executar num desses ambientes.

Instalação, passo a passo

Este guia pressupõe que tem acesso root a um servidor Plesk. Todos os comandos abaixo destinam-se a ser copiados e colados tal como estão.

1. O que é necessário

Pode verificar ambos antes da instalação. O primeiro comando deve apresentar uma linha que começa por 220 e o segundo deve apresentar 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

Inicie sessão por SSH como root. Descarregue a extensão e a respetiva soma de verificação:

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 ficheiro foi descarregado sem erros. Deve ver latest.zip: OK. Se vir FAILED, volte a descarregar 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. Registo do servidor

No Plesk, aceda a Tools & Settings › Mail › Email Spam Tester e prima Registar este servidor. Pode indicar um endereço de email para receber avisos sobre o serviço, mas é opcional.

O registo envia o nome de anfitrião do servidor, as versões do Plesk e da extensão, o número de subscrições e esse endereço de email. A resposta é uma chave que permanece neste servidor, encriptada nas definições da extensão. Os clientes nunca a veem.

Os clientes encontram o Email Spam Tester em Websites & Domains › um domínio › Mail. Enquanto o servidor não estiver registado, a extensão apenas lhes diz para lhe pedirem ajuda.

4. Escolher quem tem acesso a cada funcionalidade

Em Service Plans › um plano › Permissions (e nas permissões de cada subscrição), a extensão adiciona quatro permissões, todas ativas por predefinição:

Os limites por subscrição (testes, verificações de pastas, planos de IA, domínios monitorizados e emails monitorizados por domínio por dia) encontram-se na mesma página Tools & Settings › Mail › Email Spam Tester.

5. Monitorização contínua (opcional)

Nada é copiado até permitir esta funcionalidade e um cliente a ativar para o respetivo domínio. Na página da extensão em Tools & Settings, prima Permitir a monitorização contínua neste servidor. Isto adiciona:

A mesma página inclui Desativar em todo o servidor, que remove os três elementos e desativa a funcionalidade em todos os domínios.

Para verificar o estado através da linha de comandos:

/usr/local/psa/admin/sbin/modules/email-spam-tester/est-monitor status

"state": "active" significa que está ativa; "off" significa que nunca foi permitida ou que foi removida; "partial" significa que falta um componente (por vezes, o Plesk reescreve o ficheiro master.cf do Postfix durante uma atualização). A opção Reparar, na mesma página, repõe o componente em falta. Uma tarefa diária faz o mesmo automaticamente.

6. Atualização

Descarregue o novo latest.zip e a respetiva soma de verificação como no passo 2, verifique-os e execute:

plesk bin extension --upgrade /root/latest.zip

O registo, os limites e a monitorização mantêm-se inalterados. Se a monitorização estiver ativa, os respetivos ficheiros são atualizados para a nova versão.

7. Desinstalação

plesk bin extension --uninstall email-spam-tester

Este comando remove a monitorização do Postfix e dos processadores de email do Plesk e desativa todos os domínios monitorizados. Nunca altera registos DNS, incluindo os que os clientes criaram com os botões da extensão.

Se a monitorização estiver ativa, recomenda-se removê-la primeiro, para que qualquer falha nesse processo seja visível em vez de aparecer apenas no registo do Plesk:

/usr/local/psa/admin/sbin/modules/email-spam-tester/est-monitor disable

O comando apresenta o estado no final. "state": "off" significa que o processador, o serviço de escuta e a lista foram removidos.

8. Se algo não funcionar