GhostlyDDns para DNS dinâmico Cloudflare
GhostlyDDns mantém DNS dinâmico Cloudflare sob controle
GhostlyDDns é um CLI .NET leve que roda na sua máquina e atualiza registros A e AAAA do Cloudflare quando seu IP público muda. Ideal para servidores domésticos, redes de escritório, laboratórios e serviços auto-hospedados que precisam de domínio estável sem depender de SaaS.
Visão geral
DNS dinâmico resolve o problema do IP variável, não todos os problemas de hospedagem
Muitas conexões domésticas e de pequenos escritórios recebem IP público novo ocasionalmente. DNS dinâmico mantém o domínio apontado para o IP atual, garantindo acesso a VPN, painel, site de teste ou app auto-hospedado. GhostlyDDns foca em zonas Cloudflare e atualiza registros já criados.
Verificação de adequação
Use GhostlyDDns quando o Cloudflare for sua fonte confiável de DNS
A melhor opção é uma rede onde o endereço público pode mudar, mas o domínio deve continuar funcionando. Se seu roteador ou provedor já atualiza o Cloudflare como precisa, talvez não precise de outro agente.
Onde o GhostlyDDns ajuda
- Você usa DNS Cloudflare e já tem os registros A ou AAAA que deseja manter.
- Sua rede doméstica, escritório, laboratório ou reserva recebe um IP público variável.
- Você quer o token API do Cloudflare armazenado localmente, não em um serviço DDNS de terceiros.
- Você precisa do mesmo estilo de configuração no Windows, Linux ou Linux ARM.
Quando outro caminho DDNS é mais simples
- Seu provedor de internet fornece um IP público estático e o DNS raramente muda.
- Seu roteador já atualiza o Cloudflare com segurança, usando credenciais limitadas e logs úteis.
- Você precisa de um painel hospedado, controles de acesso em equipe, alertas e suporte gerenciado.
- Você espera que a ferramenta crie registros Cloudflare do zero na versão um.
Sumário
Atualizações Cloudflare
GhostlyDDns atualiza apenas quando seu IP público realmente muda
O agente verifica seus endereços públicos IPv4 e IPv6, compara com o último valor conhecido e chama a API Cloudflare só quando um registro A ou AAAA precisa de novo alvo. Isso mantém o ciclo de atualização silencioso e evita tráfego API desnecessário.
Registros A acompanham o endereço IPv4 atual
Use registros A para serviços IPv4 como VPN doméstica, painel pequeno, proxy reverso ou site de teste.
Registros AAAA podem acompanhar o IPv6 quando seu host o possui
Ative IPv6 apenas se a máquina tiver rota IPv6 estável. Caso contrário, mantenha o detector IPv6 desativado.
Chamadas Cloudflare mantêm consciência de mudanças
GhostlyDDns compara valores antes e atualiza Cloudflare só quando o alvo DNS precisa mudar.
Privacidade e segurança
Execução local mantém partes sensíveis próximas à sua rede
GhostlyDDns não precisa de painel hospedado. Seu token Cloudflare fica na máquina que executa o agente, os logs ficam locais e o ciclo de atualização roda atrás do seu firewall, agendador ou serviço systemd.
Use o menor token API Cloudflare útil
Limite o token à zona e permissões DNS que o GhostlyDDns realmente precisa. Não reutilize um token de conta inteira para uma tarefa simples de DDNS.
Proteja o arquivo YAML como um segredo
A configuração pode conter o token API do Cloudflare. Mantenha permissões restritas e evite colar em capturas, tickets ou logs públicos.
O ciclo de atualização roda onde você configurar
GhostlyDDns não exige painel externo. Seu agendador, firewall, logs e política de tentativas continuam sob seu controle.
Monitore falhas, não cada execução normal
Espera-se uma execução silenciosa e bem-sucedida. Fique atento a códigos de saída diferentes de zero, falhas repetidas no Cloudflare e pontos de detecção que param de responder.
Fluxo de configuração
O caminho confiável é: zona primeiro, token segundo, agendador terceiro
Uma configuração limpa de DDNS é principalmente preparação. Crie o registro, limite o token Cloudflare à zona, faça um teste seco e depois configure o agente no agendador adequado ao seu sistema operacional.
Criar o registro
Adicione primeiro o registro A ou AAAA no Cloudflare, escolha o modo proxy e use um hostname temporário durante os testes.
Limitar token
Crie um token API do Cloudflare que edite DNS apenas na zona desejada, nada além disso.
Executar teste seco
Use o comando dry para confirmar configuração, nomes de registro, detectores e acesso Cloudflare antes da atualização ao vivo.
Agendar agente
Execute uma vez via timer ou continuamente como serviço, depois verifique logs e códigos de saída nas primeiras mudanças de IP.
Configuração
Um arquivo YAML descreve token, registros, intervalo, detecção de IP e logs
Mantenha a configuração simples e revisável. Armazene o token com segurança, defina o intervalo de verificação conforme sua necessidade, ative IPv6 só se o host tiver rota real, e liste todos os registros Cloudflare que devem acompanhar o IP público.
Comandos principais do CLI
Use execuções de teste antes de ativar um trabalho repetitivo. Elas mostram o que o GhostlyDDns atualizaria sem transformar a primeira configuração em uma mudança cega em produção.
ghostly-ddns init-config --path ./config.yaml
ghostly-ddns dry --config ./config.yaml
ghostly-ddns once --config ./config.yaml
ghostly-ddns run --config ./config.yaml
ghostly-ddns --help
ghostly-ddns --versionExemplo de configuração YAML
Os valores exatos dependem da sua zona e nomes de registro no Cloudflare, mas o formato é compacto para revisão normal de código.
cloudflare:
api_token: CF_API_TOKEN
update:
interval_seconds: 120
ip_detection:
detect_ipv4: true
detect_ipv6: false
v4_endpoints:
- https://api.ipify.org
- https://ipv4.icanhazip.com
v6_endpoints:
- https://api6.ipify.org
logging:
retention_days: 30
records:
- name: home.example.com
type: A
proxied: true
ttl: autoImplantação
Execute o GhostlyDDns como um serviço de infraestrutura leve
No Linux, um serviço systemd e timer facilitam reiniciar e auditar o agente. No Windows, o Agendador de Tarefas executa o comando em intervalos fixos. Em ambos, os logs devem ser acessíveis e o arquivo de configuração protegido.
Timer Linux systemd
Use uma conta de serviço dedicada quando possível e mantenha a configuração em diretório protegido.
[Unit]
Description=Run GhostlyDDns
[Service]
Type=oneshot
ExecStart=/usr/local/bin/ghostly-ddns once --config /etc/GhostlyDDns/config.yaml
[Timer]
OnBootSec=60
OnUnitActiveSec=120
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetAgendador de Tarefas do Windows
Execute o mesmo comando CLI a cada poucos minutos e monitore códigos de saída diferentes de zero no seu fluxo operacional.
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\GhostlyDDns\ghostly-ddns.exe once --config C:\GhostlyDDns\config.yaml" ^
/RL HIGHEST ^
/FEdições
Escolha a versão que corresponde ao local onde o agente DDNS será executado
Cada licença cobre atualizações GhostlyDDns 1.x para a edição escolhida. Escolha Windows para máquinas de escritório, Linux para VPS ou servidor doméstico, ou Linux ARM para dispositivos de baixo consumo que mantenham o DNS atualizado o dia todo.
Windows
Use quando uma máquina Windows fica online e deve manter um registro Cloudflare atualizado para uma rede pequena.
Abrir edição WindowsLinux
Use para VPS, servidor doméstico, laboratório ou host proxy reverso que já roda serviços sem supervisão.
Abrir edição LinuxLinux ARM
Use para dispositivos ARM64 sempre ligados que podem rodar um agente DDNS leve com baixo consumo.
Abrir edição Linux ARMComece agora
Comece com um registro de teste antes de automatizar o DNS de produção
Crie um subdomínio temporário, execute o GhostlyDDns em modo teste, confirme que o token Cloudflare edita só a zona desejada e depois aplique a mesma configuração ao registro principal.
Perguntas frequentes
Perguntas frequentes GhostlyDDns
Respostas rápidas sobre registros Cloudflare, tokens API, IPv6, agendamentos, logs e quando DDNS do provedor pode bastar.
O que o GhostlyDDns automatiza?
GhostlyDDns atualiza registros A e AAAA existentes no Cloudflare quando seu IP público IPv4 ou IPv6 muda. Não substitui o DNS Cloudflare nem cria plataforma de hospedagem.
GhostlyDDns cria novos registros no Cloudflare?
A versão um destina-se a atualizar registros já existentes. Crie os registros DNS no Cloudflare primeiro, depois deixe o GhostlyDDns manter os alvos atualizados.
Onde devo armazenar o token API do Cloudflare?
Armazene o token na máquina que executa o GhostlyDDns e proteja o arquivo YAML com permissões restritas. O token deve editar DNS apenas na zona desejada.
GhostlyDDns pode atualizar registros IPv6?
Sim. Ative a detecção IPv6 quando o host tiver um endereço IPv6 roteado real. GhostlyDDns pode atualizar registros AAAA quando o IPv6 detectado mudar.
Quando o DDNS do provedor é suficiente?
DDNS do provedor pode ser suficiente quando seu roteador ou provedor já atualiza o Cloudflare com segurança, suporta os registros necessários e oferece logs confiáveis.
Com que frequência o agente deve rodar?
Intervalos curtos, como de dois a cinco minutos, são comuns em redes domésticas e de escritório. Use intervalos maiores quando a troca rápida não for essencial.