> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Proteção Contra Spam e Vírus de E-mail

> Ajusta o filtro de spam do servidor, as regras que recusam e-mail de entrada, o treinamento do filtro e a verificação de vírus.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Configurações de
Recursos** > **Proteção Contra Spam e Vírus de E-mail**

**Quem filtra é o Rspamd**, e a tela o chama pelo nome. As mudanças valem no minuto
seguinte: o painel responde *"As configurações foram atualizadas. As alterações
terão efeito em alguns instantes."*

## Proteção contra spam

![Registros do Rspamd, lista cinza, recusa por SPF com lista branca de IPs, recusa por DKIM e recusa de Google Groups](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/recursos-spam-1.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=a98b012c9697ee29200127c896e18349)

| Campo | Vem com | O que faz |
| - | - | - |
| **Registros históricos na interface web do Rspamd** | 1000 | quantas mensagens ficam guardadas na aba **History** da interface do Rspamd |
| **Lista cinza** | ligada | recusa temporariamente, na primeira tentativa, o e-mail cuja pontuação de spam passa do limite, como diz a tela. Servidor legítimo tenta de novo e passa, com alguns minutos de atraso; quem manda spam costuma não tentar de novo |
| **Rejeitar os e-mails que não passam nas verificações SPF** | ligada | recusa quem não tem autorização para enviar em nome do domínio |
| **Lista branca IPs** | vazia | endereços que pulam a checagem de SPF |
| **Rejeitar e-mails que não passam nas verificações DKIM** | desligada | ver o aviso abaixo |
| **Rejeitar e-mails das listas de discussão do Google Groups** | desligada | recusa tudo que vem dessas listas |

**Conferido no servidor:** cada opção vira regra na configuração do Rspamd. Ligar a
recusa de Google Groups criou a regra `REJECT_KH_GOOGLE_GROUPS`, e a de SPF
corresponde à regra `REJECT_SPF_FAIL`, com a mensagem de recusa que o remetente
recebe.

> [!WARNING]
>
> **A recusa por DKIM também barra quem não tem assinatura nenhuma**
>
> A própria tela diz isso, e a regra criada confirma: a condição inclui o caso
> *"sem assinatura DKIM"*. Como muito remetente legítimo ainda não assina, ligar
> esta opção recusa e-mail bom. Ligue sabendo disso.

> [!NOTE]
>
> **A tela pode mostrar a lista cinza ligada com o servidor sem ela**
>
> Nesta instalação, a tela marcava **Lista cinza** ligada desde a instalação, e a
> configuração do Rspamd estava no estado desligado. **Salvar a tela uma vez alinhou
> os dois.** Depois disso o comportamento é o esperado: ligada, o módulo fica ativo;
> desligada, o painel desliga o módulo **e** anula a pontuação que dispara a lista
> cinza, porque desligar só o módulo não é suficiente, como o próprio arquivo do
> painel comenta.
>
> Se o filtro não se comporta como a tela diz, salvar a tela uma vez é o primeiro
> teste.

## Listas de endereços e listas de DNS

![Listas negra e branca de endereços, a opção de rejeitar, e as listas negras e brancas de DNS](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/recursos-spam-2.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=d38c46ba0decfeb90e3dc53e4ff839e2)

| Campo | O que faz |
| - | - |
| **Lista negra Endereços de e-mail** | endereços sempre marcados como spam |
| **Rejeitar e-mails** | com ela ligada, o e-mail da lista negra é recusado, e não só marcado |
| **Lista branca Endereços de e-mail** | endereços que nunca são marcados como spam |
| **Lista negra Provedor de domínios** (DNSBL) | listas de reputação consultadas por DNS. O e-mail classificado por elas é recusado |
| **Lista branca Provedor de domínios** (DNSWL) | listas que evitam o falso positivo das anteriores |

Nas listas de endereços valem os curingas `*` e `?`, e a tela dá os exemplos
`*@domain.com`, `user-?@*.com`, `*domain.com` e `user*`.

> [!WARNING]
>
> **Lista de DNS com resolvedor público pode não funcionar**
>
> A tela avisa: provedores de DNSBL e DNSWL costumam bloquear consultas vindas de
> resolvedores públicos, como os do Google e da Cloudflare. Num servidor que use
> esses resolvedores, o recurso fica pouco confiável.

## Treinamento e vírus

![Treinamento manual e automático do filtro, e a opção de verificação de vírus](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/recursos-spam-3.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=fa1963bbfdca84b71baaf2ed7806996b)

O filtro aprende com exemplos. A tela diz o tamanho da amostra: **pelo menos 200
mensagens de spam e 200 de ham** (o e-mail legítimo) antes de o aprendizado valer
na classificação.

| Campo | Vem com | O que faz |
| - | - | - |
| **Treinamento manual** | dois comandos | `rspamc learn_spam` e `rspamc learn_ham`, apontados para a pasta da caixa, para ensinar em lote |
| **Treinamento automático da pasta de lixo eletrônico/spam** | ligado | uma tarefa periódica lê as pastas de spam das caixas e aprende com o que está lá |
| **Treinamento automático de spam a partir de e-mails recebidos** | ligado, limite 10 | aprende como spam o que passar da pontuação |
| **Treinamento automático de ham a partir de e-mails recebidos** | ligado, limite -2 | aprende como legítimo o que ficar abaixo da pontuação |

A tela manda olhar o **History** da
[interface do Rspamd](/keyhelp-admin/interface-da-web-do-rspamd)
para escolher limites que façam sentido com as pontuações reais do servidor.

### Verificação de vírus

**Vem desligada.** A tela explica o motivo de existir esse cuidado: o sistema
precisa de **pelo menos 2 GB de memória**, e com pouca memória as mensagens podem
ficar presas na fila.

**Nesta instalação a opção está desligada, e o antivírus do servidor está parado.**
A máquina de teste tem menos memória que o mínimo que a tela pede, o que combina
com a recomendação da própria tela de deixar a opção desligada em servidor apertado.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **E-mail legítimo está sendo recusado** | a recusa por DKIM barra quem não assina, ou uma lista de DNS muito restritiva está classificando errado | desligar a recusa por DKIM, e usar a lista branca de DNS |
| Um e-mail de fora chegou com minutos de atraso | a lista cinza segurou a primeira tentativa, o que ela faz com o e-mail de pontuação alta. E-mail limpo não espera: uma mensagem do Gmail, com pontuação -2,00, chegou em 14 segundos com a lista cinza ligada | é o comportamento esperado. Para tirar o atraso, desligar a lista cinza |
| O filtro não parece obedecer à tela | a configuração do servidor pode estar fora de sintonia com o que a tela mostra | salvar a tela uma vez e conferir de novo |
| O filtro erra muito, mesmo com treinamento ligado | ainda não juntou as 200 mensagens de cada tipo que a tela cita | esperar o volume, ou treinar em lote com os comandos da tela |
| **As mensagens estão presas na fila depois de eu ligar o antivírus** | memória insuficiente, como a tela avisa | desligar a verificação de vírus, ou aumentar a memória do servidor |
| As listas de DNS não parecem ter efeito | o servidor usa resolvedor de DNS público | usar um resolvedor próprio |

## Ver também

* [Servidor de E-mail](/keyhelp-admin/servidor-de-email), os limites de tamanho, conexões e fila
* [Editor de DNS](/keyhelp-admin/editor-de-dns), onde ficam os registros SPF, DKIM e DMARC de cada domínio


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.