Automatize DNS Dinâmico do Cloudflare com GhostlyDDns
Ferramenta CLI .NET 10 focada em privacidade que mantém registros DNS do Cloudflare sincronizados com seu IP dinâmico. Sem telemetria, configuração YAML, suporte multiplataforma.
GhostlyDDns é um agente de linha de comando dotnet oito focado em privacidade que mantém os registros A e AAAA existentes do Cloudflare sincronizados com o IP público da sua rede de borda. Faz parte do conjunto Ghostly Tools e oferece a desenvolvedores, criadores e autogerenciadores uma solução confiável de automação de DNS dinâmico no Cloudflare, sem serviços gerenciados.
O runtime monitora seu endereço WAN, detecta mudanças em IPv4 e IPv6 por múltiplos pontos e só chama a API do Cloudflare quando necessário. Diagnósticos com Serilog, recuo exponencial disciplinado e códigos de saída consistentes garantem visibilidade para operação sem supervisão.
GhostlyDDns, software focado em privacidade da Ghostly Tools by GhostlyInc, oferece uma camada leve de automação para redes autogerenciadas que precisam de precisão constante no Cloudflare sem expor credenciais a serviços SaaS externos.

Sumário
Edições e licenciamento
Escolha a versão do GhostlyDDns compatível com seu sistema operacional. Cada licença Gumroad inclui atualizações vitalícias para todas as versões 1.x do GhostlyDDns e a mesma configuração YAML funciona em todas as edições.
Atualizações vitalícias para todas as versões 1.x do GhostlyDDns estão incluídas em cada licença.
Principais recursos
Operações com foco em privacidade
Execute o GhostlyDDns totalmente na sua infraestrutura, sem telemetria, vinculação de conta ou planos de controle externos.
Atualizações conscientes de mudanças
Descoberta de IP por múltiplos pontos, cache em memória e recuo disciplinado eliminam chamadas redundantes à API do Cloudflare.
Implantação multiplataforma
Binários .NET 8 em arquivo único são publicados para Windows, Linux e ARM64, permitindo usar a mesma configuração em qualquer lugar.
Exemplos de uso
GhostlyDDns ajuda equipes autogerenciadas, agências e trabalhadores remotos a manterem uptime eliminando atualizações manuais de DNS quando endereços WAN mudam.
- Mantenha gateways VPN de homelab acessíveis após cada renovação de IP do provedor, sem expor roteadores ao gerenciamento remoto.
- Mantenha portais de clientes white label no Cloudflare enquanto executa a aplicação em conexões dinâmicas de escritório.
- Proteja estúdios e equipamentos de transmissão mantendo domínios de ingestão de streaming atualizados mesmo com failover móvel.
- Apoie provedores de serviços gerenciados que operam múltiplas zonas de clientes com um único agente leve de automação.
Comandos CLI
A CLI do GhostlyDDns oferece comandos específicos para scaffolding de configuração, execuções de teste, execuções únicas e monitoramento contínuo. Ajuda integrada disponível via flags.
ghostly-ddns init-config [--path|--p|-p <path>]
ghostly-ddns dry --config|--c|-c <path>
ghostly-ddns once --config|--c|-c <path>
ghostly-ddns run --config|--c|-c <path>
ghostly-ddns --help | --h | -h
ghostly-ddns --version | --v | -vEsquema de configuração
Todas as configurações de runtime ficam em um único arquivo YAML. Informe o token da API do Cloudflare, intervalo de verificação, preferências de detecção de IP, retenção de logs e registros a manter. GhostlyDDns valida o esquema na inicialização e gera avisos úteis se faltar algum valor.
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: autoRegras de validação garantem token API presente, pelo menos um registro definido, valores TTL automáticos ou acima de 60, e cada detector ativado com pelo menos um endpoint.
Logs e diagnósticos
Serilog gera saída estruturada no console e logs rotativos em arquivos no diretório logs. Retenção padrão é de 30 arquivos diários, personalizável via YAML.
Linhas de log registram IPs detectados, atualizações puladas sem mudanças, códigos de status do Cloudflare e tentativas de retry pela política de recuo exponencial. Diagnósticos garantem prontidão para operação sem supervisão.
Guias de implantação
GhostlyDDns inclui orientações para timers systemd no Linux e templates do Agendador de Tarefas do Windows para padronizar automação rapidamente.
Serviço Linux systemd
Instale o binário em usr local bin, coloque a configuração em etc GhostlyDDns e execute o agente com uma conta de serviço dedicada.
[Unit]
Description=GhostlyDDns updater
After=network-online.target
[Service]
Type=simple
ExecStart=/usr/local/bin/ghostly-ddns run --config /etc/GhostlyDDns/config.yaml
Restart=on-failure
RestartSec=15
[Install]
WantedBy=multi-user.targetTimer Linux systemd
Associe o timer ao serviço para agendar execuções repetidas e use recuo exponencial em quedas de conexão com o Cloudflare.
[Unit]
Description=GhostlyDDns schedule
[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetAgendador de Tarefas do Windows
Importe o template XML oficial ou crie uma tarefa com privilégios máximos que execute o comando run a cada poucos minutos e reinicie em falhas.
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\\GhostlyDDns\\ghostly-ddns.exe run --config C:\\GhostlyDDns\\config.yaml" ^
/RL HIGHEST ^
/F- Caminho do programa C GhostlyDDns ghostly-ddns.exe
- Argumentos run --config C GhostlyDDns config.yaml
- Logs são gravados ao lado do executável no diretório logs
Perguntas frequentes
Encontre respostas rápidas sobre recursos do GhostlyDDns, requisitos do Cloudflare e práticas operacionais antes da implantação em produção.
Informações de suporte do GhostlyDDns
Próximos passos
Escolha sua edição preferida do GhostlyDDns, baixe o binário no Gumroad e implemente junto com outras ferramentas focadas em privacidade da GhostlyInc.
Recursos relacionados
Explore estes guias para aprimorar sua infraestrutura focada em privacidade e gestão de DNS