Automatiza DNS dinámico de Cloudflare con GhostlyDDns
Herramienta CLI .NET 10 centrada en privacidad que sincroniza registros DNS de Cloudflare con tu IP dinámica. Sin telemetría, configuración YAML, multiplataforma.
GhostlyDDns es un agente de línea de comandos dotnet ocho centrado en la privacidad que mantiene sincronizados los registros A y AAAA existentes de Cloudflare con la IP pública de tu red. Forma parte de la suite Ghostly Tools y ofrece a desarrolladores, creadores y autoalojadores una solución fiable de automatización DNS dinámica en Cloudflare sin servicios gestionados.
El runtime supervisa tu dirección WAN, detecta cambios en IPv4 e IPv6 mediante múltiples puntos y solo llama a la API de Cloudflare cuando es necesario actualizar. Diagnósticos con Serilog, retroceso exponencial disciplinado y códigos de salida consistentes ofrecen la observabilidad necesaria para operaciones sin supervisión.
GhostlyDDns de Ghostly Tools, software centrado en la privacidad de GhostlyInc, ofrece una capa ligera de automatización para redes autoalojadas que requieren precisión constante en Cloudflare sin exponer credenciales a servicios SaaS externos.

Índice
Ediciones y licencias
Elige la versión de GhostlyDDns que se adapte a tu sistema operativo. Cada licencia de Gumroad incluye actualizaciones de por vida para todas las versiones 1.x y la misma configuración YAML funciona en todas las ediciones.
Cada licencia incluye actualizaciones de por vida para todas las versiones 1.x de GhostlyDDns.
Características principales
Operaciones con privacidad prioritaria
Ejecuta GhostlyDDns íntegramente en tu infraestructura sin telemetría, vinculación de cuentas ni control externo.
Actualizaciones sensibles a cambios
Detección de IP en múltiples puntos, caché en memoria y retroceso disciplinado eliminan llamadas redundantes a la API de Cloudflare.
Despliegue multiplataforma
Se publican binarios .NET 8 de un solo archivo para Windows, Linux y ARM64, permitiendo reutilizar la misma configuración en todas partes.
Ejemplos de uso
GhostlyDDns ayuda a equipos autoalojados, agencias y trabajadores remotos a mantener la disponibilidad eliminando actualizaciones DNS manuales al cambiar la dirección WAN.
- Mantén accesibles las puertas VPN de tu homelab tras cada renovación de ISP sin exponer routers a gestión remota.
- Mantén portales de clientes con marca blanca en Cloudflare mientras ejecutas la pila de aplicaciones desde conexiones dinámicas de oficina.
- Protege equipos de emisión o estudios creativos manteniendo actualizados los dominios de ingestión de streaming incluso con conmutación móvil.
- Soporta proveedores de servicios gestionados que operan múltiples zonas de clientes con un solo agente ligero de automatización.
Comandos CLI
La CLI de GhostlyDDns ofrece comandos específicos para configuración, pruebas, ejecuciones puntuales y monitorización continua. La ayuda integrada está disponible mediante varios 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 configuración
Todas las configuraciones de runtime están en un único archivo YAML. Proporciona el token API de Cloudflare, intervalo de sondeo, preferencias de detección IP, retención de logs y registros a mantener. GhostlyDDns valida el esquema al iniciar y genera avisos útiles si faltan valores.
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: autoLas reglas de validación garantizan que haya un token API, al menos un registro definido, valores TTL automáticos o superiores a 60, y que cada detector activo tenga al menos un endpoint.
Registro y diagnóstico
Serilog genera salida estructurada en consola junto con logs rotativos almacenados en el directorio logs. La retención por defecto es de 30 archivos diarios y puede personalizarse vía YAML.
Las líneas de log documentan IPs detectadas, actualizaciones omitidas sin cambios, códigos de estado Cloudflare y reintentos por política de retroceso exponencial. Estos diagnósticos mantienen GhostlyDDns listo para producción sin supervisión.
Guías de despliegue
GhostlyDDns incluye guías para timers systemd en Linux y plantillas para el Programador de tareas de Windows, facilitando la estandarización de la automatización en minutos.
Servicio systemd en Linux
Instala el binario en usr local bin, coloca la configuración en etc GhostlyDDns y ejecuta el agente con una cuenta de servicio 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 systemd en Linux
Asocia el timer con el servicio para programar ejecuciones repetidas y usa retroceso exponencial ante caídas de conexión con Cloudflare.
[Unit]
Description=GhostlyDDns schedule
[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetProgramador de tareas de Windows
Importa la plantilla XML oficial o crea una tarea con privilegios máximos que ejecute el comando run cada pocos minutos y reinicie en caso de fallo.
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\\GhostlyDDns\\ghostly-ddns.exe run --config C:\\GhostlyDDns\\config.yaml" ^
/RL HIGHEST ^
/F- Ruta del programa C GhostlyDDns ghostly dash ddns.exe
- Argumentos run --config C GhostlyDDns config.yaml
- Los logs se escriben junto al ejecutable en el directorio logs
Preguntas frecuentes
Consulta respuestas rápidas sobre capacidades de GhostlyDDns, requisitos de Cloudflare y prácticas operativas antes de desplegar en producción.
Información de soporte de GhostlyDDns
Próximos pasos
Selecciona tu edición preferida de GhostlyDDns, descarga el binario en Gumroad y despliega junto a otras utilidades centradas en privacidad de GhostlyInc.
Recursos relacionados
Consulta estas guías para mejorar tu infraestructura y gestión DNS centradas en privacidad