GhostlyDDns para DNS dinámico Cloudflare
GhostlyDDns deja bajo tu control el DNS dinámico Cloudflare
GhostlyDDns es una pequeña CLI .NET que se ejecuta en tu máquina y actualiza registros A y AAAA existentes en Cloudflare cuando cambia tu IP pública. Ideal para servidores domésticos, oficinas, laboratorios y servicios autoalojados que necesitan un dominio estable sin ceder control DNS a terceros.
Resumen
El DNS dinámico soluciona el cambio de IP, no todos los problemas de hosting
Muchas conexiones domésticas y de oficina cambian su IP pública ocasionalmente. El DNS dinámico mantiene el dominio apuntando a la IP actual para que VPN, panel, sitio de prueba o app autoalojada sigan accesibles. GhostlyDDns se centra en zonas Cloudflare y actualiza los registros que ya creaste.
Comprobación de ajuste
Usa GhostlyDDns cuando Cloudflare sea tu fuente DNS principal
La mejor opción es una red donde la dirección pública puede cambiar, pero el dominio debe seguir funcionando. Si tu router o proveedor ya gestiona la actualización exacta en Cloudflare que necesitas, puede que no requieras otro agente.
Dónde ayuda GhostlyDDns
- Usas DNS de Cloudflare y ya tienes los registros A o AAAA que quieres mantener.
- Tu red doméstica, oficina, laboratorio o de respaldo tiene una IP pública cambiante.
- Quieres que el token API de Cloudflare se guarde localmente en lugar de en un servicio DDNS externo.
- Necesitas el mismo estilo de configuración en Windows, Linux o Linux ARM.
Cuando otro método DDNS es más sencillo
- Tu proveedor de internet te asigna una IP pública estática y el DNS cambia raramente.
- Tu router ya actualiza Cloudflare de forma segura con credenciales limitadas y logs útiles.
- Necesitas un panel alojado, controles de acceso para equipos, alertas y soporte gestionado.
- Esperas que la herramienta cree registros Cloudflare desde cero en la versión uno.
Índice
Actualizaciones de Cloudflare
GhostlyDDns actualiza solo cuando tu IP pública cambia realmente
El agente verifica tus direcciones públicas IPv4 e IPv6, las compara con el último valor conocido y llama a la API de Cloudflare solo si un registro A o AAAA necesita un nuevo destino. Esto mantiene el ciclo de actualización silencioso y evita tráfico API innecesario.
Los registros A siguen la dirección IPv4 actual
Usa registros A para servicios IPv4 como VPN doméstica, panel pequeño, proxy inverso o sitio de prueba.
Los registros AAAA pueden seguir IPv6 cuando tu host lo tiene
Activa IPv6 solo si la máquina tiene una ruta IPv6 estable. Si no, desactiva el detector IPv6.
Las llamadas a Cloudflare detectan cambios
GhostlyDDns compara valores y actualiza Cloudflare solo si el destino DNS cambia.
Privacidad y seguridad
La ejecución local mantiene las partes sensibles cerca de tu red
GhostlyDDns no necesita panel alojado. El token API queda en la máquina que ejecuta el agente, los logs son locales y el ciclo de actualización corre tras tu firewall, programador o servicio systemd.
Usa el token API de Cloudflare más pequeño y útil
Limita el token a la zona y permisos DNS que GhostlyDDns necesita. No reutilices un token global para un trabajo DDNS simple.
Protege el archivo YAML como un secreto
La configuración puede incluir el token API de Cloudflare. Mantén permisos estrictos y evita pegarlo en capturas, tickets o logs públicos.
El ciclo de actualización se ejecuta donde lo coloques
GhostlyDDns no requiere panel externo. Tu programador, firewall, logs y política de reintentos forman parte de tu configuración.
Monitorea fallos, no cada ejecución normal
Se espera una ejecución silenciosa y exitosa. Vigila códigos de salida distintos de cero, fallos repetidos de Cloudflare y puntos de detección que dejan de responder.
Flujo de configuración
El camino fiable es zona primero, token segundo, programador tercero
Una configuración limpia de DDNS es principalmente preparación. Crea el registro, limita el token de Cloudflare a la zona, realiza una prueba en seco y luego programa el agente según tu sistema operativo.
Crear el registro
Añade primero el registro A o AAAA en Cloudflare, elige el modo proxy y usa un nombre temporal durante las pruebas.
Limitar el token
Crea un token API de Cloudflare que solo pueda editar DNS en la zona deseada.
Ejecutar prueba en seco
Usa el comando en seco para confirmar configuración, nombres de registros, detectores y acceso a Cloudflare antes de una actualización en vivo.
Programar agente
Ejecuta una vez con temporizador o continuamente como servicio, luego revisa logs y códigos de salida en los primeros cambios de IP.
Configuración
Un archivo YAML describe el token, registros, intervalo, detección IP y logs
Mantén la configuración simple y revisable. Guarda el token seguro, ajusta el intervalo según tus necesidades, activa IPv6 solo si el host tiene ruta real y lista todos los registros Cloudflare que deben seguir la IP pública.
Comandos CLI principales
Usa ejecuciones en seco antes de activar un trabajo repetitivo. Muestran qué actualizaría GhostlyDDns sin hacer cambios ciegos en producción.
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 --versionEjemplo de configuración YAML
Los valores exactos dependen de tu zona Cloudflare y nombres de registros, pero la estructura es lo suficientemente pequeña para una revisión 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: autoDespliegue
Ejecuta GhostlyDDns como un servicio de infraestructura pequeño
En Linux, un servicio y temporizador systemd facilitan reiniciar y auditar el agente. En Windows, el Programador de tareas ejecuta el comando a intervalos. Los logs deben ser accesibles y la configuración no legible para todos.
Timer systemd en Linux
Usa una cuenta de servicio dedicada cuando sea posible y guarda la configuración en un directorio 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.targetProgramador de tareas de Windows
Ejecuta el mismo comando CLI cada pocos minutos y vigila códigos de salida distintos de cero en tu flujo operativo habitual.
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\GhostlyDDns\ghostly-ddns.exe once --config C:\GhostlyDDns\config.yaml" ^
/RL HIGHEST ^
/FEdiciones
Elige la versión según dónde se ejecutará el agente DDNS
Cada licencia cubre actualizaciones GhostlyDDns 1.x para la edición elegida. Elige Windows para oficina pequeña, Linux para VPS o servidor doméstico, o Linux ARM para dispositivos de bajo consumo.
Windows
Usa esto cuando una máquina Windows esté siempre conectada y deba mantener un registro Cloudflare actualizado para una red pequeña.
Abrir edición WindowsLinux
Usa esto para un VPS, servidor doméstico, laboratorio o host proxy inverso que ya ejecute servicios sin supervisión.
Abrir edición LinuxLinux ARM
Usa esto para dispositivos ARM64 siempre encendidos que puedan ejecutar un agente DDNS pequeño y ligero.
Abrir edición Linux ARMComenzar
Comienza con un registro de prueba antes de automatizar el DNS en producción
Crea un subdominio temporal, ejecuta GhostlyDDns en modo prueba, confirma que el token solo edita la zona deseada y luego aplica la configuración al registro real.
Preguntas frecuentes
¿Qué automatiza GhostlyDDns?
GhostlyDDns actualiza registros A y AAAA existentes en Cloudflare cuando cambia tu IP pública IPv4 o IPv6. No reemplaza el DNS de Cloudflare ni crea una plataforma de hosting.
¿Crea GhostlyDDns nuevos registros en Cloudflare?
La versión uno está pensada para actualizar registros ya existentes. Crea primero los registros DNS en Cloudflare y luego deja que GhostlyDDns mantenga sus destinos actualizados.
¿Dónde debo guardar el token API de Cloudflare?
Guarda el token en la máquina que ejecuta GhostlyDDns y protege el archivo YAML con permisos restrictivos. El token solo debe poder editar DNS en la zona deseada.
¿Puede GhostlyDDns actualizar registros IPv6?
Sí. Activa la detección IPv6 cuando el host tenga una dirección IPv6 enrutada real. GhostlyDDns puede actualizar registros AAAA cuando cambia la dirección IPv6 detectada.
¿Cuándo es suficiente el DDNS del proveedor?
El DDNS del proveedor puede ser suficiente si tu router o proveedor ya actualiza Cloudflare de forma segura, soporta los registros que necesitas y ofrece logs confiables.
¿Con qué frecuencia debe ejecutarse el agente?
Un intervalo corto de dos a cinco minutos es común en redes domésticas y de oficina. Usa un intervalo mayor si no es crucial un cambio rápido.