Apontar um subdomínio para o IP de casa que muda
O teste de CGNAT vem antes de tudo, a URL de atualização substitui a senha do painel e a prova é o nome respondendo o IP novo em dois resolvedores diferentes.

Resposta curta: crie um registro A do subdomínio com TTL de 300 segundos no Zone Editor e deixe um cliente de DNS dinâmico reescrever o IP a cada troca. Antes disso, confirme que a conexão não está atrás de CGNAT: se estiver, nenhum cliente de DDNS resolve.
Neste artigo
- Primeiro o teste de CGNAT, porque ele decide se a tarefa é possível
- Crie o registro A do subdomínio com TTL de 300 no Zone Editor
- O segredo do cliente é a URL de atualização, não a senha do painel
- Três formas de ligar o cliente que reescreve o IP
- Prove que funcionou: force a troca de IP e consulte dois resolvedores
- Os quatro erros que mais travam a tarefa
- Rotina para o registro não morrer em silêncio
Primeiro o teste de CGNAT, porque ele decide se a tarefa é possível
Sua conexão residencial pode ter um IPv4 público só seu, ou pode compartilhar um IPv4 com dezenas de outros assinantes por meio de CGNAT (Carrier-Grade NAT). No segundo caso, o endereço que o seu roteador recebe não é alcançável pela internet e nenhum cliente de DNS dinâmico vai consertar isso. O registro até atualiza, mas aponta para um endereço que não é seu.
O teste leva dois minutos e é o passo zero.
- Abra o painel do roteador no navegador (costuma ser
192.168.0.1ou192.168.1.1) e procure a tela Status, Internet ou WAN. Anote o campo Endereço IP ou IP WAN. - Em um computador ou celular na mesma rede, abra um site do tipo "qual é o meu IP". No terminal, o equivalente é
curl -4 https://ifconfig.me, que devolve só o endereço IPv4 visto de fora. - Compare os dois valores.
Se forem iguais e públicos, siga para o próximo passo. Se forem diferentes, o significado depende da faixa em que o IP do roteador cai, e os dois casos não têm a mesma solução:
- Faixa 100.64.0.0 a 100.127.255.255: é CGNAT, NAT da operadora. Esse é o caso que nenhum ajuste seu resolve.
- Faixas privadas (10.x.x.x, 172.16.x.x a 172.31.x.x, 192.168.x.x): é NAT duplo dentro da sua própria rede. Seu roteador está pendurado em outro roteador ou em um modem que não está em modo bridge. Isso você mesmo resolve: coloque o modem da operadora em bridge, ou ligue o serviço direto no equipamento que recebe o IP público. Depois refaça o teste, porque o IP que aparecer pode ser público (e aí você segue o artigo) ou CGNAT (e aí vale o parágrafo de cima).
| IP que o roteador mostra | Faixa | O que significa |
|---|---|---|
| 100.64.0.0 a 100.127.255.255 | CGNAT (RFC 6598) | NAT da operadora. DNS dinâmico não resolve. |
| 10.0.0.0 a 10.255.255.255 | Privada (RFC 1918) | Modem em bridge mal configurado ou NAT duplo na sua rede. |
| 172.16.0.0 a 172.31.255.255 | Privada (RFC 1918) | Mesmo caso acima. |
| 192.168.0.0 a 192.168.255.255 | Privada (RFC 1918) | O roteador está atrás de outro roteador. |
| Qualquer outro, igual ao do site | Público | Pode seguir. |
Atrás de CGNAT, as saídas reais são três: pedir à operadora um IPv4 público (algumas liberam sem custo mediante solicitação, outras cobram), usar IPv6 se a operadora entregar um prefixo real (aí o registro é AAAA, não A), ou manter um túnel saindo da sua rede para um servidor com IP fixo. Nenhuma delas é "configurar o DDNS".
Um detalhe que atrapalha mesmo com IP público: várias operadoras bloqueiam as portas 80 e 443 de entrada em planos residenciais. O nome vai resolver direitinho e ainda assim o site não abre de fora. Teste a porta que você pretende usar antes de culpar o DNS.
Crie o registro A do subdomínio com TTL de 300 no Zone Editor
O nome só começa a responder depois que existe um registro A para ele. E esse registro tem que ficar com TTL baixo, senão os resolvedores guardam o IP velho por horas depois da troca.
Antes de mexer: no Zone Editor, use a opção de exportar ou pelo menos tire um print da zona inteira. Se você errar um registro do domínio raiz, o print é o caminho de volta.
Este registro A é provisório. Nenhum dos três caminhos da próxima seção escreve nele: quem cria o registro definitivo é a tela de Dynamic DNS do painel, ou o provedor externo no caso do CNAME, e você vai apagar este aqui antes de seguir. Ele serve para o nome já responder enquanto você monta o resto e para você ver na prática onde fica o campo TTL que vai precisar ajustar depois. Se você já sabe que vai pela Opção B, pule direto para ela e deixe a tela de Dynamic DNS criar o registro do zero.
Onde ficam os campos Nome, TTL e Endereço no cPanel
- Entre no cPanel e, na seção Domínios, clique em Zone Editor.
- Localize o domínio na lista e clique em Gerenciar (ou Manage).
- Clique em Adicionar registro e escolha o tipo A.
- Em Nome, escreva só o rótulo do subdomínio, por exemplo
casa. O painel completa com o domínio e gravacasa.exemplo.com.br.. - Em TTL, troque o valor padrão por 300. São 300 segundos, cinco minutos.
- Em Endereço, coloque o IPv4 público que você anotou no teste anterior. É um valor provisório, só para o nome já responder enquanto você monta o resto da configuração.
- Salve e confira na lista que o registro aparece com o TTL de 300.
TTL é o tempo, em segundos, que um resolvedor pode guardar a resposta em cache antes de perguntar de novo. O padrão de muitas zonas é 14400 segundos, quatro horas. Com esse valor, o IP novo pode demorar até quatro horas para aparecer para quem já consultou o nome. Com 300, o pior caso é cinco minutos.
TTL muito baixo também tem custo: mais consultas chegando nos servidores autoritativos e nenhuma tolerância a uma indisponibilidade momentânea deles. Para uma conexão doméstica que troca de IP uma ou duas vezes por dia, 300 segundos é uma escolha confortável. Não desça para 30 só por ansiedade.
O segredo do cliente é a URL de atualização, não a senha do painel
O cliente de atualização precisa de credencial para reescrever a zona, e colocar a senha do cPanel em um arquivo de texto dentro do roteador ou de um Raspberry Pi é trocar "meu subdomínio parou" por "minha hospedagem inteira vazou".
Nenhum dos três caminhos da próxima seção pede a senha. O que eles usam é uma URL de atualização, gerada pela tela de Dynamic DNS do cPanel (a Opção B). A credencial já vai embutida nessa URL: quem tiver a URL consegue reescrever o registro, sem precisar de mais nada. Trate-a com o mesmo cuidado de uma senha.
A ordem, então, é esta: crie a entrada na tela de Dynamic DNS, copie a URL que ela devolve e só depois configure o roteador (Opção A) ou o script (Opção C). Sem essa URL, os dois ficam sem o que chamar.
Guarde a URL em um arquivo único no equipamento que vai atualizar o registro. Use /etc/ddns.conf, com uma linha só, e proteja o arquivo:
URL_DE_ATUALIZACAO="https://COLE_AQUI_A_URL_GERADA_NA_TELA_DE_DYNAMIC_DNS"
chown root:root /etc/ddns.conf
chmod 600 /etc/ddns.conf
O chmod 600 deixa o arquivo legível só pelo dono. É esse arquivo que o script da Opção C vai ler, e é o único lugar do seu sistema onde o segredo aparece.
Se a URL vazar, ou se você trocar o equipamento, volte à tela de Dynamic DNS no painel, remova aquela entrada e crie outra. A URL antiga para de valer, a senha do cPanel continua intacta e nenhum outro serviço cai junto.
Três formas de ligar o cliente que reescreve o IP
Três caminhos, do mais simples ao mais flexível. Escolha um, não os três ao mesmo tempo.
Opção A: o campo DDNS do próprio roteador
Muitos roteadores têm uma tela DDNS ou DNS Dinâmico em Serviços ou Rede. Ela costuma listar provedores prontos (DynDNS, No-IP, provedores do fabricante) e, em alguns modelos, um modo Personalizado ou Custom onde você cola uma URL de atualização.
Se o seu modelo tiver o modo personalizado, é a opção com menos peças móveis: o roteador é quem sabe, em primeira mão, que o IP mudou, e ele dispara a atualização no mesmo instante. A URL que você cola nesse campo é a mesma gerada na tela de Dynamic DNS do cPanel, então faça a Opção B primeiro e volte com a URL na mão. O registro que vai mudar é o que a tela de Dynamic DNS criou: se você já tinha criado o A casa no Zone Editor, apague-o para não ficar com dois registros no mesmo nome, e depois confira o TTL do registro novo.
Se só houver provedores de lista fixa, você tem duas escolhas. A primeira é usar o serviço da lista (No-IP e similares) e apontar o seu subdomínio para o nome que esse serviço entregou. Nesse caso, apague antes o registro A casa no Zone Editor: um mesmo nome não pode ter registro A e CNAME ao mesmo tempo, e o painel vai recusar a criação ou deixar a zona inconsistente. Com o A removido, crie um CNAME casa apontando para seunome.ddns.net. (ou o que o provedor tiver dado). Repare na consequência: o TTL de 300 que você configurou deixa de valer para a resposta final, porque o endereço vem agora do nome do provedor e quem manda no cache do IP é o TTL da zona dele. O TTL do seu CNAME controla só o cache do apontamento.
A segunda escolha é ignorar esse campo do roteador e fazer as opções B e C em sequência: a tela de Dynamic DNS cria o registro e entrega a URL, o script chama essa URL. Assim tudo continua na sua zona.
Opção B: a tela Dynamic DNS do cPanel
A documentação do cPanel descreve uma interface de Dynamic DNS em Domains, na qual você cria uma entrada informando o domínio e o nome do subdomínio. O sistema cria o registro apontando para o endereço de onde você está conectado naquele momento e disponibiliza uma URL de atualização, que é o que o cliente externo chama periodicamente para reescrever o IP. A mesma tela permite atualizar manualmente, editar e remover as entradas.
Atenção à ordem, porque aqui quem cria o registro é o painel, não você. Se já tiver criado o A casa no Zone Editor, apague esse registro antes de criar a entrada de Dynamic DNS, para não terminar com dois registros disputando o mesmo nome. Ou, melhor ainda, se você já sabe que vai por este caminho, pule a seção do Zone Editor e deixe a tela de Dynamic DNS criar o registro do zero.
Quem define o TTL nesse caminho é o cPanel, com o valor que ele aplica ao criar a entrada. Depois que o registro existir, abra o Zone Editor, olhe o campo TTL do registro A recém-criado e, se ele estiver em 14400, edite para 300 ali mesmo. Editar o TTL não muda o endereço nem quebra a URL de atualização.
Dois requisitos práticos: o domínio precisa estar usando os servidores DNS do próprio servidor de hospedagem, e o recurso precisa estar habilitado pelo provedor na sua conta. Se o item não aparecer no painel, pergunte ao provedor se dá para habilitar. Não adianta pular direto para a Opção C: sem esta tela não existe URL de atualização e o script fica sem destino. Enquanto não houver a tela, o caminho que sobra é o do provedor externo com CNAME, descrito na Opção A.
Opção C: um script com curl no cron
Esta opção não substitui a B: ela é o cliente que chama a URL de atualização criada na tela de Dynamic DNS. Faça a Opção B primeiro, copie a URL e só então monte o script.
Serve para Linux, Raspberry Pi, NAS e qualquer máquina que fique ligada na sua rede. O ddclient é a ferramenta clássica para isso, mas ele fala protocolos específicos (dyndns2, Cloudflare e afins) e não tem um protocolo nativo para a API do cPanel. Para esse cenário, um script de cinco linhas com curl é mais honesto e mais fácil de depurar.
#!/bin/sh
set -eu
# Le a URL de atualizacao do arquivo protegido criado na secao anterior.
. /etc/ddns.conf
ARQUIVO_ESTADO="/var/lib/ddns/ultimo_ip"
IP_ATUAL=$(curl -4 -fsS https://ifconfig.me)
IP_ANTERIOR=$(cat "$ARQUIVO_ESTADO" 2>/dev/null || echo "")
[ "$IP_ATUAL" = "$IP_ANTERIOR" ] && exit 0
curl -fsS "$URL_DE_ATUALIZACAO" > /dev/null
mkdir -p "$(dirname "$ARQUIVO_ESTADO")"
printf '%s\n' "$IP_ATUAL" > "$ARQUIVO_ESTADO"
echo "$(date -Is) IP atualizado para $IP_ATUAL"
Linha a linha:
set -eufaz o script abortar no primeiro erro e reclamar de variável não definida, em vez de seguir adiante gravando lixo.. /etc/ddns.confcarrega a variávelURL_DE_ATUALIZACAOdo arquivo que você protegeu comchmod 600. O segredo fica fora do script, em um lugar só.curl -4 -fsS https://ifconfig.mepergunta o IP visto de fora. O-4força IPv4 (importante, veja o último erro deste artigo), o-ffaz o curl falhar em erro HTTP, o-sScala a barra de progresso mas mantém a mensagem de erro.- A comparação com o IP anterior evita bater na API a cada execução. Serviço de DDNS com atualização repetida e desnecessária costuma ser tratado como abuso.
curl -fsS "$URL_DE_ATUALIZACAO"é a atualização em si.- As duas últimas linhas gravam o estado e deixam um rastro com data no log.
Salve o conteúdo em /usr/local/bin/atualiza-ddns.sh e dê a ele dono e permissão corretos:
chown root:root /usr/local/bin/atualiza-ddns.sh
chmod 700 /usr/local/bin/atualiza-ddns.sh
O chmod 700 faz duas coisas: liga o bit de execução (sem ele o cron falha com Permission denied) e impede que outros usuários leiam o arquivo. O script em si não guarda segredo nenhum, o segredo está no /etc/ddns.conf.
Teste à mão antes de agendar:
/usr/local/bin/atualiza-ddns.sh
O resultado esperado na primeira execução é uma linha parecida com 2025-01-14T10:32:07-03:00 IP atualizado para 189.x.x.x. Rode o comando de novo em seguida: agora ele deve sair em silêncio, sem imprimir nada, porque o IP não mudou. Se as duas execuções imprimirem a linha, o arquivo de estado não está sendo gravado. Se a primeira não imprimir nada e o registro não mudar, confira a URL dentro do /etc/ddns.conf. Por último, abra o Zone Editor e confirme que o registro A do subdomínio passou a mostrar esse mesmo IP.
Agende com o cron do usuário root:
*/5 * * * * /usr/local/bin/atualiza-ddns.sh >> /var/log/ddns.log 2>&1
A cada cinco minutos ele verifica. Só chama o painel quando o IP realmente mudou.
Prove que funcionou: force a troca de IP e consulte dois resolvedores
Atualizar a zona e ver o valor certo no painel não é prova. A prova é o nome respondendo o IP novo em resolvedores que não são o seu.
Force a troca de IP e confirme o endereço novo com curl
Derrube a conexão por alguns minutos. Reiniciar o modem costuma bastar; em PPPoE, desconectar e reconectar pela tela do roteador também funciona. Em algumas operadoras o IP volta igual, e aí você precisa deixar desconectado mais tempo. Confirme a troca com curl -4 https://ifconfig.me antes de testar o DNS.
Pergunte ao servidor autoritativo, que é a fonte do registro
O servidor autoritativo é a fonte. Se ele não tem o IP novo, o problema é o cliente de atualização, não a propagação.
dig casa.exemplo.com.br A +noall +answer @ns1.seuservidor.com.br
Pergunte ao 8.8.8.8 e ao 1.1.1.1 para separar cache de falha
dig +short casa.exemplo.com.br @8.8.8.8
dig +short casa.exemplo.com.br @1.1.1.1
No Windows, sem instalar nada. No Prompt de Comando ou no PowerShell:
nslookup casa.exemplo.com.br 1.1.1.1
Apenas no PowerShell (no Prompt de Comando este comando retorna erro de comando não reconhecido):
Resolve-DnsName casa.exemplo.com.br -Server 8.8.8.8
Se o autoritativo já mostra o IP novo e um resolvedor público ainda mostra o antigo, é cache. Repita dig casa.exemplo.com.br A +noall +answer @8.8.8.8 e observe o número do TTL na resposta: ele conta para baixo a cada consulta. Quando chegar a zero, a próxima resposta vem atualizada. Com TTL de 300 segundos, esse é o teto da espera.
| Sintoma | Autoritativo | Resolvedor público | Causa provável |
|---|---|---|---|
| IP novo nos dois | novo | novo | Funcionando. |
| IP velho nos dois | velho | velho | O cliente não atualizou. Veja o log do script ou a URL de atualização. |
| Novo no autoritativo, velho no público | novo | velho | Cache. Espere o TTL zerar. |
| Nenhuma resposta | vazio | vazio | Registro não existe ou o nome está escrito errado. |
| IP que não é o seu | novo | novo | Proxy na frente, ou CGNAT. Volte ao primeiro teste. |
Os quatro erros que mais travam a tarefa
TTL de 14400 segundos herdado do registro padrão
Quem cria o subdomínio pela tela de Subdomínios em vez do Zone Editor costuma receber o TTL padrão da zona. Com 14400 segundos, o IP antigo continua sendo servido por até quatro horas depois da troca, e a pessoa passa a tarde reiniciando o roteador achando que o cliente está quebrado. Abra o Zone Editor, localize o registro A do subdomínio e verifique o campo TTL com os próprios olhos. Se estiver em 14400, troque para 300 e espere as quatro horas antigas passarem uma última vez.
Nuvem laranja do Cloudflare devolvendo o IP do proxy
Se o domínio usa o Cloudflare e o registro está com a nuvem laranja (Proxied), o dig devolve um endereço do Cloudflare, não o seu. O registro até está sendo atualizado corretamente nos bastidores, mas quem consulta nunca vê o IP de casa, e qualquer serviço que não seja HTTP ou HTTPS simplesmente não funciona. Na tela de DNS do Cloudflare, clique na nuvem do registro do subdomínio até ela ficar cinza (DNS only). Faça isso só nesse registro, não nos do domínio raiz.
Cliente atualizando a zona do domínio raiz e derrubando o site
O erro mais caro. Ao configurar o cliente, o campo de nome recebe exemplo.com.br em vez de casa.exemplo.com.br. Na primeira atualização, o registro A do domínio principal passa a apontar para a sua conexão doméstica e o site sai do ar para todo mundo, com um TTL baixo garantindo que a mudança se espalhe rápido. Confira o campo de hostname antes de salvar, e depois da primeira atualização rode dig +short exemplo.com.br para confirmar que o domínio raiz continua no IP do servidor de hospedagem. Se já aconteceu, corrija o registro A do raiz no Zone Editor com o IP do servidor, que aparece na página inicial do cPanel.
Registro AAAA antigo fazendo o IPv6 responder antes do IPv4
Se existir um registro AAAA para o mesmo nome, navegadores e sistemas modernos tendem a tentar o IPv6 primeiro. Dois cenários travam aqui: o AAAA foi deixado para trás apontando para um endereço antigo, ou o seu IPv6 doméstico muda de prefixo e ninguém o atualiza. O sintoma é clássico: dig +short casa.exemplo.com.br mostra o IPv4 certo, o serviço responde no celular com dados móveis e não responde no notebook. Verifique com dig +short casa.exemplo.com.br AAAA. Se vier resposta e você não configurou IPv6 de propósito, apague o AAAA. Se quiser usar IPv6, o cliente precisa atualizar os dois registros, e aí o curl -6 entra no script junto do curl -4.
Rotina para o registro não morrer em silêncio
DNS dinâmico quebra sem avisar. O nome continua resolvendo, só que para o endereço errado, e você só descobre quando precisa acessar de fora.
- Guarde a URL de atualização junto das suas outras senhas. Se ela se perder, ou se alguém remover a entrada de Dynamic DNS no painel, a atualização para em silêncio: o registro continua resolvendo, só que para o IP antigo.
- Deixe o
>> /var/log/ddns.log 2>&1no cron e olhe o arquivo de vez em quando. Cada linha com data é uma troca de IP registrada. - Uma vez por mês, compare
curl -4 https://ifconfig.mecomdig +short casa.exemplo.com.br @1.1.1.1. Os dois valores têm que ser idênticos. Esse é o teste completo em dois comandos. - Se você usa o subdomínio para um serviço exposto, lembre que DNS dinâmico resolve o nome e não resolve segurança. Porta aberta em rede doméstica merece, no mínimo, autenticação forte e firewall no equipamento de destino.
E se o teste do primeiro passo tiver apontado CGNAT, não gaste tempo com cliente, URL de atualização e TTL: nenhum deles ataca o problema. Pedir o IPv4 público à operadora é o caminho mais simples, quando ela libera. As outras duas saídas continuam valendo e dependem só de você: usar IPv6, se a operadora entregar um prefixo real, trocando o registro A por um AAAA, ou manter um túnel da sua rede para um servidor com IP fixo e apontar o subdomínio para esse servidor.
Referências
- Documentação oficial (cpanel) — Dynamic DNS (cPanel). Consultado em 2026-09-25.