# Configurar SPF e DKIM da hospedagem no Cloudflare sem duplicar

Como levar os registros gerados pelo cPanel para a zona do Cloudflare sem quebrar o SPF que já existe, e como provar que funcionou com consulta pública e cabeçalho do Gmail.

> no cPanel, copie SPF e DKIM em Email Deliverability; no Cloudflare, edite o TXT v=spf1 existente em vez de criar outro (só pode haver 1 por nome), crie o DKIM e, se for CNAME, deixe em DNS only. Prove com dig e com spf=pass e dkim=pass no Gmail.

João Rizzon · 2026-11-13 · Domínios e DNS

---

## Onde o cPanel mostra os valores de SPF e DKIM

No cPanel, os registros prontos ficam em **Email > Email Deliverability**. A [documentação oficial do cPanel](https://docs.cpanel.net/cpanel/email/email-deliverability-in-cpanel/) descreve a interface: ela lista cada domínio, mostra o estado de DKIM, SPF e PTR e, no botão **Manage**, exibe o registro sugerido para cada um.

O detalhe que importa quando a zona está no Cloudflare: o servidor da hospedagem não é o DNS autoritativo do domínio. A interface percebe isso e não consegue instalar os registros sozinha. A documentação orienta, nesse caso, a copiar os valores sugeridos e criá-los no provedor que de fato responde pelo DNS. É esse o trabalho deste guia.

Abra o **Manage** do domínio e anote duas coisas:

- O **nome** e o **valor** do registro DKIM (normalmente um TXT em `default._domainkey`).
- O **valor sugerido de SPF** (uma linha que começa com `v=spf1`).

O cPanel entrega o DKIM em TXT. DKIM em CNAME aparece em serviços de envio de terceiros (newsletter, e-mail transacional), que apontam para uma chave mantida por eles. Esse é um cenário separado, tratado mais abaixo.

Copie o valor pelo botão de copiar da própria interface. Digitar uma chave DKIM à mão é a forma mais rápida de perder meia hora.

## O que checar na zona do Cloudflare antes de criar qualquer registro

Em **DNS > Records**, filtre por tipo TXT e olhe o nome `@` (a raiz do domínio). Três situações aparecem com frequência em sites de clientes:

- **Nenhum TXT com `v=spf1`.** Caminho livre: você cria um registro novo.
- **Já existe um `v=spf1`.** Quase sempre colocado por Google Workspace, Microsoft 365, ferramenta de newsletter ou pela hospedagem anterior. Você **edita** esse registro. Não cria outro.
- **Existem TXT de verificação** (`google-site-verification=`, `MS=`, chaves de outras ferramentas). Esses ficam como estão. Vários TXT no mesmo nome são normais; o problema é só ter dois que começam com `v=spf1`.

Verifique também se `_domainkey` já tem algo. Se o cliente usa outro serviço de envio, pode existir `google._domainkey`, `selector1._domainkey` ou similar. Seletores diferentes convivem sem conflito: cada remetente assina com o seu.

Antes de editar, tire um print ou exporte a zona (**DNS > Records > Import and Export**). Em zona de cliente, o registro de como estava antes é o que permite desfazer em um minuto.

## Por que dois registros SPF no mesmo nome quebram a autenticação

A regra do SPF: um nome pode ter **um só** registro `v=spf1`. Com dois, o receptor trata a consulta como erro permanente (`permerror`) e o SPF simplesmente não vale, para nenhum dos dois remetentes.

Por isso, juntar é obrigatório. Pegue os mecanismos do registro existente e acrescente os que a hospedagem sugeriu, mantendo um único `v=spf1` no início e um único `all` no fim.

Exemplo (valores fictícios): o cliente já usa Google Workspace e passa a enviar também pelo servidor da hospedagem, cujo IP de exemplo é `203.0.113.10`.

```
Antes (existente):
v=spf1 include:_spf.google.com ~all

Sugerido pelo cPanel (exemplo):
v=spf1 +a +mx +ip4:203.0.113.10 ~all

Depois (registro único, editado no lugar do antigo):
v=spf1 +a +mx +ip4:203.0.113.10 include:_spf.google.com ~all
```

Dois cuidados ao juntar:

- **Limite de 10 consultas DNS.** O SPF admite no máximo 10 termos que geram consulta: os mecanismos `include`, `a`, `mx`, `ptr` e `exists` e o modificador `redirect`. Cada `include` de provedor pode consumir várias por dentro. Se o registro já tem muitos `include`, troque `a` e `mx` por `ip4` explícito quando souber o IP.
- **Não troque o `all` sem combinar.** Se o registro existente termina em `-all`, quem decidiu isso talvez tenha motivo. Mantenha o qualificador que já estava, a menos que você seja o responsável pela política.

No Cloudflare, o TXT não tem opção de proxy, então aqui não há nuvem laranja para se preocupar.

## Como saber se o DKIM vem em TXT ou em CNAME

### Como criar o DKIM em TXT quando o cPanel entrega a chave

Crie um registro **TXT** com o nome que o cPanel mostrou. No Cloudflare, digitar `default._domainkey` ou `default._domainkey.exemplo.com.br` na zona `exemplo.com.br` gera o mesmo registro. Depois de salvar, confira o nome exibido na lista **DNS > Records**. Cole o valor inteiro, que começa com `v=DKIM1; k=rsa; p=`.

Se o valor vier quebrado em vários trechos entre aspas, é a forma como alguns painéis exibem chaves longas. Junte os trechos em uma linha, sem as aspas internas, e confirme o resultado na consulta pública da próxima seção. A chave tem que chegar inteira: um caractere a menos e a assinatura falha.

### Como criar o DKIM em CNAME sem o proxy do Cloudflare

Crie o **CNAME** com o nome e o destino informados e deixe o **Proxy status em DNS only** (nuvem cinza). Isso não é opcional. Com o proxy ligado, o Cloudflare responde com os próprios endereços em vez de entregar o destino, e o receptor não encontra o TXT com a chave pública na ponta da cadeia. Resultado: `dkim=fail` ou `dkim=temperror` sem nenhum erro aparente no painel.

Aproveite para conferir os outros registros de e-mail: o hostname que o MX aponta (`mail.exemplo.com.br`, por exemplo) também precisa estar em DNS only. E-mail não passa pelo proxy HTTP do Cloudflare.

| Registro | Tipo | Nome (exemplo) | Valor (exemplo) | Proxy |
|---|---|---|---|---||
| SPF | TXT | `@` | `v=spf1 +a +mx +ip4:203.0.113.10 ~all` | não se aplica |
| DKIM em TXT | TXT | `default._domainkey` | `v=DKIM1; k=rsa; p=MIIB...` | não se aplica |
| DKIM em CNAME | CNAME | `s1._domainkey` | `s1.dkim.provedor-exemplo.net` | DNS only |
| Host do MX | A | `mail` | `203.0.113.10` | DNS only |

Todos os valores da tabela são fictícios. Use os que o seu painel gerou.

## Como provar que o SPF e o DKIM estão valendo

Registro criado não é registro funcionando. A prova tem duas partes, e as duas são necessárias: a primeira mostra que o mundo enxerga o registro, a segunda mostra que um receptor real aceitou a mensagem.

### Como consultar cada registro em um resolvedor público

Consulte um resolvedor público, não o DNS da sua máquina. Troque `exemplo.com.br` e o seletor pelos reais.

```
dig TXT exemplo.com.br @1.1.1.1 +short
dig TXT default._domainkey.exemplo.com.br @1.1.1.1 +short
dig CNAME s1._domainkey.exemplo.com.br @1.1.1.1 +short
```

O que validar em cada saída:

- **SPF:** exatamente **uma** linha começando com `"v=spf1`. Duas linhas `v=spf1` significam que o antigo não foi editado.
- **DKIM TXT:** a chave aparece completa, igual à do cPanel. Pode vir dividida em trechos entre aspas na saída do `dig`, o que é normal para chaves longas.
- **DKIM CNAME:** a resposta é o destino do provedor. Se a consulta CNAME voltar vazia, desconfie do proxy: com a nuvem laranja ligada, o Cloudflare achata o CNAME e não o entrega como CNAME. Para confirmar, rode `dig A s1._domainkey.exemplo.com.br @1.1.1.1 +short`. Se aparecerem IPs (do Cloudflare), o proxy está ligado.

Depois volte ao **Email Deliverability** do cPanel. Segundo a documentação, a interface verifica os registros publicados; com tudo certo, o domínio deixa de exibir problemas em DKIM e SPF. O aviso sobre o servidor não ser autoritativo pode continuar, e é esperado nesse cenário.

### Como ler a linha Authentication-Results no Gmail

Envie uma mensagem de uma conta do domínio (pelo webmail ou cliente configurado no servidor da hospedagem) para uma conta Gmail. No Gmail, abra a mensagem, menu de três pontos, **Mostrar original**. O topo da página resume SPF, DKIM e DMARC. Mais abaixo, procure a linha do cabeçalho:

```
Authentication-Results: mx.google.com;
       dkim=pass header.i=@exemplo.com.br header.s=default ...
       spf=pass (google.com: domain of contato@exemplo.com.br designates 203.0.113.10 as permitted sender) ...
```

(Exemplo ilustrativo; o texto exato varia.) O que conferir: `spf=pass`, `dkim=pass`, e `header.i` com o **domínio do cliente**. Se o `dkim=pass` vier com outro domínio, a mensagem foi assinada por um serviço intermediário, não pela chave que você publicou.

## O que cada resultado de SPF e DKIM indica sobre o erro

| Sintoma | Causa provável | Correção |
|---|---|---||
| `spf=permerror` | Dois TXT `v=spf1` no mesmo nome, ou mais de 10 consultas | Unificar em um registro; reduzir `include` |
| `spf=softfail` ou `fail` | IP de envio fora do registro | Incluir o IP ou o `include` do remetente real |
| `dkim=fail` com TXT | Chave truncada ou com aspas sobrando | Recolar o valor do cPanel e conferir no `dig` |
| `dkim=temperror` ou sem resultado com CNAME | Proxy ligado no CNAME | Trocar para DNS only |
| `dig` vazio logo após criar | Nome digitado errado (seletor trocado, `_domainkey` sem o sublinhado) ou cache negativo de uma consulta feita antes de criar | Conferir o nome em **DNS > Records**; consultar outro resolvedor público ou esperar o cache negativo expirar |
| `dkim=pass` com domínio de terceiro | Envio por outro serviço | Publicar o DKIM desse serviço também |

O erro de nome é discreto: o registro existe, só que no lugar errado. A consulta pública pelo nome correto é o que denuncia.

## Checklist para repetir a configuração em vários sites

Para repetir o processo em vários sites sem reinventar a cada vez:

- Exportar a zona do Cloudflare antes de mexer.
- Copiar SPF e DKIM do **Email Deliverability** do cPanel do cliente.
- Listar os TXT em `@`: editar o `v=spf1` existente, nunca criar o segundo.
- Juntar mecanismos, manter o `all` original, contar as consultas.
- Criar o DKIM com o nome exato; se for CNAME, DNS only.
- Conferir que o host do MX está em DNS only.
- `dig` em resolvedor público para cada registro.
- Mensagem de teste para Gmail e print da linha `Authentication-Results` com `spf=pass` e `dkim=pass`.
- Guardar o print no registro do cliente, junto da exportação da zona.

Guardar o print parece burocracia até o dia em que outra ferramenta sobrescreve o SPF e você precisa mostrar como estava funcionando.

Para explicar ao cliente, uma frase que costuma bastar: "Publiquei no DNS a identificação oficial do servidor que envia os seus e-mails e uma assinatura digital que prova que as mensagens saíram de você; sem isso, Gmail e Outlook tendem a mandar para spam ou recusar."

Próximo passo natural, depois de SPF e DKIM passando: um registro DMARC em modo de monitoramento, que fica para outro guia.

