# 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.

> 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.

João Rizzon · 2026-10-01 · Domínios e DNS

---

## 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.1` ou `192.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 grava `casa.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](https://docs.cpanel.net/cpanel/domains/dynamic-dns/) 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.

```bash
#!/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 -eu` faz o script abortar no primeiro erro e reclamar de variável não definida, em vez de seguir adiante gravando lixo.
- `. /etc/ddns.conf` carrega a variável `URL_DE_ATUALIZACAO` do arquivo que você protegeu com `chmod 600`. O segredo fica fora do script, em um lugar só.
- `curl -4 -fsS https://ifconfig.me` pergunta o IP visto de fora. O `-4` força IPv4 (importante, veja o último erro deste artigo), o `-f` faz o curl falhar em erro HTTP, o `-sS` cala 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>&1` no 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.me` com `dig +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.

