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

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

João Rizzon · 2026-11-08 · Domínios e DNS

---

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:

```bash
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 |

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

A [documentação oficial do cPanel](https://docs.cpanel.net/cpanel/domains/dynamic-dns/) descreve a interface **Dynamic DNS**, em Domains. O fluxo é:

- Escolha o domínio e digite o rótulo do subdomínio (por exemplo `nas`, `erp`, `staging`).
- Adicione uma descrição. Use uma que o próximo técnico entenda: `NAS matriz - roteador MikroTik - atualiza via script`.
- 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:

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

```bash
# 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:

```bash
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:

```bash
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:

- Confirme o valor autoritativo com `dig @nameserver-do-dominio`. Se ali está certo, o DNS está certo.
- Observe o TTL restante nos recursivos públicos e espere.
- Planeje: ao preparar um host que vai virar dinâmico, baixe o TTL **antes** da migração, com antecedência maior que o TTL vigente.

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.

- Testar o link: `curl -s https://ifconfig.me` comparado com a WAN do roteador. Documentar se é IP público, CGNAT ou duplo NAT.
- Definir a convenção de nomes e usá-la em todos os clientes: `nas.`, `erp.`, `staging.`, `vpn.`. Nada de `servidor2`.
- Criar a entrada de Dynamic DNS no cPanel com descrição que identifique equipamento e método de atualização.
- Guardar a URL de atualização no gerenciador de segredos da agência, com o nome do cliente no título.
- Registrar o TTL aplicado pelo painel, verificado por `dig`, na ficha do cliente.
- Instalar o atualizador, de preferência no roteador. Se for cron ou Agendador, usar conta de serviço e intervalo de 5 minutos.
- Direcionar a saída do atualizador para um log e saber onde ele fica.
- Validar com `dig @8.8.8.8` e `dig @1.1.1.1`, comparando com o IP público da rede.
- 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.
- Anotar na documentação do cliente qual é o plano B se o link virar CGNAT (muda com troca de plano, sem aviso).
- 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.

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

