Guia Completo de Zonas DNS no cPanel e WHM: Correção do Erro 'DNS Entry Already Exists', killdns e Templates Avançados
Voltar para blog

Guia Completo de Zonas DNS no cPanel e WHM: Correção do Erro 'DNS Entry Already Exists', killdns e Templates Avançados

03/10/2026 · 6 min · Servidores

1. Por Que o Erro 'DNS Entry Already Exists' Acontece (named.conf e /var/named/)#

O servidor DNS (geralmente BIND ou PowerDNS) mantém uma lista de todas as zonas autoritativas ativas no arquivo /etc/named.conf e os arquivos de registros individuais dentro de /var/named/.

O erro Sorry, a DNS entry already exists surge em três situações clássicas:

  1. A zona já existe e está atrelada como o domínio principal de uma conta no cPanel.
  2. O domínio foi movido de conta ou excluído pela metade, deixando registros residuais órfãos nos arquivos internos do servidor.
  3. Você está tentando adicionar o domínio como addon ou alias em outra conta enquanto a zona antiga ainda consta no índice do servidor.

2. Solução no Nível de Usuário cPanel: Reset da Zona DNS#

Se você não tem acesso administrativo ao WHM ou SSH e opera apenas no cPanel da sua própria conta de hospedagem, o painel não permite deletar a zona do domínio principal. O truque aqui é forçar a redefinição (reset) da zona para o padrão do servidor.

O reset substitui os registros corrompidos ou errados por um arquivo novo com os IPs padrão do servidor web, de e-mail e de FTP:

  1. Acesse o cPanel da sua conta.
  2. Na seção Domínios, clique em Zone Editor (Editor de Zona).
  3. Localize o domínio que está com problemas (meudominio.com.br) e clique em Gerenciar (Manage).
  4. No canto superior direito da lista de registros, clique no botão de engrenagem ou menu de Ações (Actions).
  5. Escolha a opção Redefinir zona DNS (Reset DNS Zone).
  6. Confirme o alerta na tela. Note que apontamentos externos personalizados (como MX do Google Workspace ou CNAME de CDN) precisarão ser reconfigurados depois.

O painel vai regravar o arquivo de zona do zero com o template padrão, destravando os apontamentos sem que você precise mexer na estrutura da conta.


3. Solução no Nível Administrativo do WHM: Reset e Recriação de Zonas#

Se você possui acesso de revenda ou gerência pelo WHM, o processo permite gerenciar zonas diretamente em nível de servidor.

Método 1: Redefinição direta#

Quando você precisa apenas restaurar a zona para o padrão do servidor:

  1. Faça login no WHM.
  2. Na caixa de busca à esquerda, digite Reset a DNS Zone.
  3. Selecione o domínio na lista e clique em Reset.

A zona antiga será imediatamente sobrescrita pelo template padrão do servidor.

Método 2: Exclusão e recriação da zona#

Se o erro ocorreu porque você está transferindo o domínio para outra conta e o painel diz que a entrada já existe:

  1. No WHM, pesquise por Delete a DNS Zone.
  2. Selecione o domínio em conflito e confirme a exclusão. Isso remove o arquivo do diretório de zonas e a diretiva do serviço named.
  3. Em seguida, vá no menu Add a DNS Zone.
  4. Informe o IP da hospedagem e o nome do domínio para recriá-lo limpo e associá-lo à conta de destino.

4. Solução Cirúrgica via SSH: Limpeza de Zonas Órfãs com o Script killdns#

Há casos em que o domínio não aparece na lista do WHM, mas ao tentar adicioná-lo em uma conta nova, o cPanel insiste que a entrada já existe. Isso indica uma zona órfã: o arquivo .db ainda está solto em /var/named/ ou uma linha residual permaneceu gravada no /etc/named.conf.

Tentar editar esses arquivos na mão pode gerar erros de sintaxe no BIND. O cPanel conta com um utilitário nativo projetado exatamente para fazer essa limpeza cirúrgica.

Conecte-se ao servidor via SSH como root e execute:

/usr/local/cpanel/scripts/killdns meudominio.com.br

O que o script killdns faz por baixo dos panos#

Ao rodar esse comando, o script executa uma rotina completa de saneamento:

Após o término da execução, você pode adicionar o domínio ou a zona normalmente através da interface web sem receber mensagens de conflito.


5. Anatomia dos Templates de Zona no cPanel (/var/cpanel/zonetemplates/ e a Variável $ip)#

Quando uma zona é resetada ou criada do zero, o cPanel não gera os registros aleatoriamente: ele aplica os arquivos de modelo localizados no servidor:

cd /var/cpanel/zonetemplates/
ls -lah

Os principais templates são:

No template, a variável $ip é o coração da automação:

@     14400  IN  A   $ip
www   14400  IN  A   $ip
mail  14400  IN  A   $ip

O cPanel substitui $ip com base no endereço definido em WHM → Basic WebHost Manager Setup. Se a conta possuir um IP dedicado, o cPanel substitui $ip pelo IP específico da conta, preservando a reputação de envio e o isolamento.

6. O Triângulo das Bermudas no DNS: Boas Práticas e RFCs para MX, A e CNAME#

Erros na configuração do template de zona frequentemente geram incidentes graves de entrega de e-mail (N2/N3).

❌ Erro 1: MX apontando para IP#

O registro MX sempre deve apontar para um nome totalmente qualificado (FQDN), nunca diretamente para um endereço IP.

❌ Erro 2: MX apontando para CNAME#

Violação direta da RFC 2181. Na prática, grandes provedores como Gmail e Outlook podem penalizar a entrega, atrasar mensagens ou recusar conexões. O destino apontado no registro MX deve possuir registros A/AAAA diretos.

❌ Erro 3: Entrada mail configurada como CNAME#

Configurar mail IN CNAME dominio.com.br até pode resolver na web, mas é uma má prática em produção: adiciona saltos desnecessários de resolução, fragiliza o roteamento se o domínio apex mudar e dificulta o troubleshooting.

7. Template de Zona "Blindado" para Produção (SOP) e Validação com dig#

Recomenda-se utilizar o seguinte modelo baseline em /var/cpanel/zonetemplates/standard:

$TTL 14400
@  86400  IN  SOA  ns1.dominio.com.br. root.dominio.com.br. (
    $serial
    3600
    1800
    1209600
    86400 )

@      14400  IN  NS    ns1.dominio.com.br.
@      14400  IN  NS    ns2.dominio.com.br.

@      14400  IN  A     $ip
www    14400  IN  A     $ip
mail   14400  IN  A     $ip
ftp    14400  IN  A     $ip

; --- Registros de Autodiscover para Facilidade do Cliente ---
autoconfig   14400  IN  A     $ip
autodiscover 14400  IN  A     $ip

; --- Roteamento e Entrega de E-mail ---
@      14400  IN  MX 10 mail.dominio.com.br.

; --- Segurança e Anti-Spoofing Essencial ---
@      14400  IN  TXT "v=spf1 a mx ip4:$ip ~all"
_dmarc 14400  IN  TXT "v=DMARC1; p=none; aspf=r;"

Validação no terminal após aplicação do template#

dig @127.0.0.1 MX dominio.com.br +short
dig @127.0.0.1 A mail.dominio.com.br +short
dig @8.8.8.8 MX dominio.com.br +short
dig @1.1.1.1 MX dominio.com.br +short

8. Propagação de DNS, Ajustes de TTL e Checklist Operacional#

Sempre que você reseta ou recria uma zona DNS, os registros voltam ao TTL (Time to Live) padrão configurado no template do servidor (geralmente entre 14400 e 86400 segundos).

Mesmo que o servidor local responda instantaneamente com os novos apontamentos, provedores de internet e servidores DNS públicos (como 1.1.1.1 e 8.8.8.8) mantêm respostas antigas em cache até que o TTL expire. Recomendo planejar essas intervenções fora do horário de pico e avisar quem utiliza os serviços que a propagação completa pode levar de uma a quatro horas.

Este artigo foi útil?

Deixe uma reação rápida para apoiar o conteúdo:

CC BY-NC

Este post está licenciado sob CC BY-NC.

Comentários

Participe da discussão abaixo.

0 comentários