blog
Domínios e DNS

DNS dinâmico no cPanel: subdomínio sem IP fixo

Como montar DNS dinâmico no cPanel para NAS, ERP ou staging atrás de PPPoE, escolher o TTL certo e provar por dig que o nome já responde o IP novo.

JR · · 9 min de leitura · 2 tabelas · 8 blocos de código

Resposta curta: use um subdomínio com registro A dedicado criado na interface Dynamic DNS do cPanel, mais um cliente atualizador no roteador ou em cron chamando a URL de atualização gerada pelo painel. O TTL da entrada é definido pelo painel: verifique o valor por dig e, se precisar dele entre 60 e 300 segundos, ajuste no Zone Editor.

Neste artigo
  1. O que o DNS dinâmico resolve, e o que ele não resolve
  2. Criar a entrada de Dynamic DNS no cPanel e proteger a URL de atualização
  3. O que o TTL controla de fato: o tamanho da janela sem acesso
  4. Escolher onde roda o cliente atualizador
  5. Provar por dig que o nome já responde o IP novo
  6. Os dois erros que mais travam a entrega
  7. Checklist de implantação para padronizar em vários clientes
  8. Quando a resposta honesta não é DNS dinâmico

Servidor de escritório atrás de link PPPoE residencial ou empresarial barato não tem IP fixo. O IP muda na renovação da sessão, na queda de energia, no reboot do roteador. Quem mantém sites de clientes acaba sendo chamado para resolver o acesso ao NAS, ao ERP interno, ao Bitrix ou ao ambiente de staging que ninguém mais alcança de fora.

A solução é um subdomínio com DNS dinâmico: um registro A com TTL curto, atualizado automaticamente por um cliente que roda na rede do cliente. O painel faz a parte do DNS. Você faz a parte da operação, que é onde a tarefa trava.

O que o DNS dinâmico resolve, e o que ele não resolve

DNS dinâmico resolve um problema: o nome continua apontando para o IP certo depois que o IP muda. Ele não abre porta, não fura NAT e não cria rota.

Antes de criar qualquer registro, descubra se o link tem IP público de verdade. Rode isto na rede do escritório:

curl -s https://ifconfig.me; echo

Compare o resultado com o IP da WAN no roteador. Se o roteador mostra algo em 100.64.0.0/10 e o ifconfig.me mostra outro IP, o link está em CGNAT: a operadora compartilha um IP público entre vários assinantes. Nesse caso o DNS dinâmico publica um IP que não é só do seu cliente, e conexões de entrada não chegam. Não adianta insistir: peça IP público à operadora (algumas cobram), use IPv6 nativo se houver, ou monte um túnel (WireGuard, Tailscale, VPS de salto). Diagnóstico na mesa economiza duas horas de suporte depois.

Faixas que nunca devem aparecer no registro A publicado:

Faixa O que é Por que aparece por engano
10.0.0.0/8 privada cliente leu a interface LAN
172.16.0.0/12 privada rede de container ou Docker
192.168.0.0/16 privada IP do roteador doméstico
100.64.0.0/10 CGNAT WAN do roteador sob NAT da operadora
169.254.0.0/16 link-local DHCP falhou
Diagnóstico do link antes de criar o registroMedir IP públicocurl ifconfig.me na rede do clienteComparar com a WANIP do roteador igual ao medidoFaixa privada ou CGNAT100.64/10, 10/8, 192.168/16IP público válidosegue para o DNS dinâmicoSem IP públicoIPv6, túnel ou VPS de salto
Triagem do link antes de criar qualquer registro A. Só IP público roteável justifica DNS dinâmico; CGNAT exige outro caminho.

Criar a entrada de Dynamic DNS no cPanel e proteger a URL de atualização

A documentação oficial do cPanel descreve a interface Dynamic DNS, em Domains. O fluxo é:

  1. Escolha o domínio e digite o rótulo do subdomínio (por exemplo nas, erp, staging).
  2. Adicione uma descrição. Use uma que o próximo técnico entenda: NAS matriz - roteador MikroTik - atualiza via script.
  3. Crie a entrada. O cPanel gera o registro A correspondente e uma URL de atualização exclusiva, com um token, para aquela entrada.

Essa URL é a credencial. Quem tem a URL muda o IP do subdomínio. Trate como senha: guarde no gerenciador de segredos do escritório, não no Trello do cliente, não em e-mail. Se vazar, confira na sua versão do painel se existe opção de regenerar a URL daquela entrada: a documentação citada não descreve esse caminho. Não havendo, remova a entrada e crie outra, já que cada entrada nova recebe URL própria, e lembre de reapontar o cliente atualizador para a URL nova antes de validar por dig.

Na própria interface o cPanel exibe as entradas existentes com o IP atual e permite atualizar manualmente, útil para o primeiro teste.

O que o TTL controla de fato: o tamanho da janela sem acesso

TTL é o tempo, em segundos, que um resolvedor recursivo pode guardar a resposta em cache antes de perguntar de novo. Ele não tem relação com velocidade de carregamento de site. Nenhuma.

O que o TTL controla é o tamanho do buraco: o intervalo entre o IP mudar e o mundo enxergar o IP novo. Com TTL de 3600, um resolvedor que consultou um minuto antes da troca vai servir o IP velho por mais 59 minutos. Com TTL de 60, o pior caso é um minuto.

TTL Pior caso de indisponibilidade após troca de IP Uso típico
60 s ~1 minuto host dinâmico (NAS, ERP, staging)
300 s ~5 minutos host dinâmico com IP que muda pouco
3600 s ~1 hora registro estático comum
86400 s ~24 horas nunca para host dinâmico

O cPanel aplica um TTL próprio às entradas de DNS dinâmico, pensado para esse cenário. Confira qual é, no seu servidor, com o comando da seção de verificação, e documente o valor por cliente. Não presuma. Se o valor aplicado não servir, o lugar de mexer é o Zone Editor, editando o registro A daquele subdomínio e colocando o TTL na faixa de 60 a 300 segundos. Depois de editar, confirme por dig que o valor publicado é o que você escolheu.

TTL curto tem custo: mais consultas chegando aos nameservers. Para um subdomínio interno de escritório isso é irrelevante. Para o www de uma loja com tráfego alto, não é, então mantenha o TTL curto apenas no host dinâmico e deixe o resto do zone file em paz.

Escolher onde roda o cliente atualizador

O cliente é qualquer coisa que chame a URL de atualização periodicamente. Não precisa de software proprietário.

Linux: cron a cada 5 minutos com log em arquivo

No servidor que fica dentro da rede, com curl instalado:

crontab -e
*/5 * * * * curl -fsS "https://URL-DE-ATUALIZACAO-DO-CPANEL" >> /var/log/ddns.log 2>&1

O -f faz o curl retornar erro em HTTP 4xx/5xx; o log em arquivo dá o que olhar quando o cliente reclamar. Cinco minutos é um intervalo razoável: somado ao TTL, define o buraco real.

Windows: tarefa ao iniciar o sistema, com conta de serviço

Crie uma tarefa com gatilho ao iniciar o sistema, configurada para repetir a cada 5 minutos por tempo indefinido, com ação:

powershell -NoProfile -Command "Invoke-WebRequest -UseBasicParsing 'https://URL-DE-ATUALIZACAO-DO-CPANEL'"

Marque "executar estando o usuário conectado ou não" e use uma conta de serviço. Gatilho de logon não serve aqui: a máquina que reinicia sozinha de madrugada, depois de atualização ou queda de energia, fica na tela de login e a tarefa nunca dispara, então o IP para de ser atualizado sem ninguém perceber. Conta de serviço pelo mesmo motivo: tarefa amarrada ao usuário do dono da empresa morre no dia em que ele troca de máquina.

No roteador: atualização no evento de troca de IP

É a melhor opção quando o equipamento permite. MikroTik, pfSense, OPNsense e vários roteadores de prateleira aceitam um cliente de DNS dinâmico com URL customizada. A vantagem é decisiva: o roteador sabe o IP da WAN e dispara a atualização no evento de troca de IP, não a cada cinco minutos. O buraco cai para perto do TTL.

Se o equipamento só aceita provedores de uma lista fechada, sem campo de URL livre, volte para o cron em uma máquina ligada 24 horas.

Provar por dig que o nome já responde o IP novo

Testar pelo navegador não prova nada: o sistema operacional e o browser têm cache próprio. Use dig apontando o resolvedor explicitamente.

# resposta autoritativa (ignora cache de recursivo)
dig +short nas.exemplo.com.br @ns1.seuservidor.com.br

# o que o mundo enxerga agora, com o TTL restante
dig nas.exemplo.com.br @8.8.8.8 +noall +answer
dig nas.exemplo.com.br @1.1.1.1 +noall +answer

A saída do segundo bloco traz três informações que importam:

nas.exemplo.com.br.  47  IN  A  203.0.113.45

O 47 é o TTL restante naquele resolvedor, contando para baixo. Se ele está em 47 e o IP exibido é o antigo, não há erro de configuração: há cache. Espere o contador chegar a zero e consulte de novo. Se o valor volta alto e o IP continua velho, aí sim o cliente atualizador não rodou.

Para ver o IP que o cliente está publicando versus o IP real da saída:

dig +short nas.exemplo.com.br @8.8.8.8
curl -s https://ifconfig.me; echo

Os dois valores iguais, com o comando rodado de dentro da rede do escritório, é o teste de aceitação. 203.0.113.45 acima é endereço de documentação, só exemplo.

Os dois erros que mais travam a entrega

Registro publicado com IP privado ou de CGNAT

Sintoma: o nome resolve, mas só funciona de dentro do escritório, ou não funciona de lugar nenhum. Causa: o cliente atualizador leu o endereço da interface local em vez de perguntar qual é o IP visto pela internet. Acontece com script caseiro que usa hostname -I, com máquina atrás de segundo roteador e com link em CGNAT.

Conferência rápida, de dentro da rede:

dig +short myip.opendns.com @resolver1.opendns.com

Se esse valor cair em 100.64.0.0/10, é CGNAT e o caminho é outro (IPv6 ou túnel). Se for uma faixa privada, o script está lendo a interface errada: troque por uma chamada à URL de atualização do cPanel feita de dentro da rede, que resolve o IP pela origem da requisição.

Nome respondendo o IP velho por cache de TTL antigo

Sintoma: você atualizou, o painel mostra o IP novo, e metade das pessoas ainda cai no antigo. Causa quase sempre é cache com TTL antigo. Se o registro ficou horas com TTL de 3600 antes de virar dinâmico, resolvedores que leram naquela janela mantêm o valor antigo até expirar, e não há como forçar a limpeza de cache de terceiros.

O que fazer:

Frase pronta para o cliente final: "o endereço novo já está publicado no nosso servidor de DNS; alguns provedores de internet guardam o endereço antigo em memória por até X minutos e vão atualizar sozinhos nesse prazo". Substitua X pelo TTL que estava em vigor. Isso encerra a conversa sem transformar cache em suspeita de falha.

Checklist de implantação para padronizar em vários clientes

Use como template de implantação. Uma linha por item no seu sistema de tarefas.

  1. Testar o link: curl -s https://ifconfig.me comparado com a WAN do roteador. Documentar se é IP público, CGNAT ou duplo NAT.
  2. Definir a convenção de nomes e usá-la em todos os clientes: nas., erp., staging., vpn.. Nada de servidor2.
  3. Criar a entrada de Dynamic DNS no cPanel com descrição que identifique equipamento e método de atualização.
  4. Guardar a URL de atualização no gerenciador de segredos da agência, com o nome do cliente no título.
  5. Registrar o TTL aplicado pelo painel, verificado por dig, na ficha do cliente.
  6. Instalar o atualizador, de preferência no roteador. Se for cron ou Agendador, usar conta de serviço e intervalo de 5 minutos.
  7. Direcionar a saída do atualizador para um log e saber onde ele fica.
  8. Validar com dig @8.8.8.8 e dig @1.1.1.1, comparando com o IP público da rede.
  9. Teste de regressão: reiniciar o roteador, esperar o IP mudar e repetir a validação com dig. Se não passar nesse teste, não foi entregue.
  10. Anotar na documentação do cliente qual é o plano B se o link virar CGNAT (muda com troca de plano, sem aviso).
  11. Monitorar o nome, não o IP: um check externo que resolve o host e bate em uma porta avisa antes do cliente.

O teste de regressão é o que separa a entrega feita da entrega que parece feita. Validar no dia da instalação só prova que o registro foi criado; validar depois de uma troca de IP prova que a automação funciona.

Implantação padronizada em vários clientesDiagnosticarIP público, CGNAT ou duplo NATCriar entradasubdomínio e URL no cofreInstalar atualizadorroteador, cron ou tarefa agendadaValidardig em dois resolvedores públicosRegressãoreiniciar link e revalidar
Sequência reutilizável de implantação. Sem a etapa de regressão, a entrega só prova que o registro foi criado.

Quando a resposta honesta não é DNS dinâmico

Dois casos em que a resposta honesta é outra.

Se o serviço exposto é administrativo (painel do NAS, ERP, RDP), publicar um nome na internet é ampliar superfície de ataque. Prefira VPN: o nome dinâmico aponta para o endpoint da VPN, e só ela fica exposta. O DNS dinâmico vira infraestrutura da VPN, não do ERP.

Se o serviço precisa de disponibilidade contratual, link PPPoE com IP variável não é a base certa, por mais curto que seja o TTL. Mesmo com atualização instantânea, há a janela de reconexão do link. Nesse caso, hospedar a aplicação em servidor com IP fixo custa menos que o tempo gasto explicando quedas.

Referências

  1. Documentação oficial (cpanel) — Dynamic DNS (cPanel). Consultado em 2026-09-25.
Leia também