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.

Resposta curta: 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.
Neste artigo
- Onde o cPanel mostra os valores de SPF e DKIM
- O que checar na zona do Cloudflare antes de criar qualquer registro
- Por que dois registros SPF no mesmo nome quebram a autenticação
- Como saber se o DKIM vem em TXT ou em CNAME
- Como provar que o SPF e o DKIM estão valendo
- O que cada resultado de SPF e DKIM indica sobre o erro
- Checklist para repetir a configuração em vários sites
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 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 comv=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,ptreexistse o modificadorredirect. Cadaincludede provedor pode consumir várias por dentro. Se o registro já tem muitosinclude, troqueaemxporip4explícito quando souber o IP. - Não troque o
allsem 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 linhasv=spf1significam 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 [email protected] header.s=default ...
spf=pass (google.com: domain of [email protected] 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 ov=spf1existente, nunca criar o segundo. - Juntar mecanismos, manter o
alloriginal, 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.
digem resolvedor público para cada registro.- Mensagem de teste para Gmail e print da linha
Authentication-Resultscomspf=passedkim=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.
Referências
- Documentação oficial (cpanel) — cPanel - Email Deliverability. Consultado em 2026-11-12.