DNS dinámico con la API de Cloudflare y un timer de systemd
Un script de veinte líneas que mantiene el dominio apuntando a la IP pública de casa, con un token de permisos mínimos y un timer de systemd que lo corre cada cinco minutos.
Mi conexión de casa tiene IP pública dinámica: cambia cada tanto, sin aviso. Si el dominio sigue apuntando a la IP vieja, todos los servicios dejan de responder. La solución es un DNS dinámico: algo que detecta la IP actual y actualiza el registro.
Hay contenedores y clientes listos para esto, pero preferí un script corto en el propio Proxmox, sin dependencias raras, que pueda leer de un vistazo.
El token de API
En Cloudflare: My Profile → API Tokens → Create Token. Usá la plantilla Edit zone DNS y restringila:
- Permissions: Zone → DNS → Edit.
- Zone Resources: Include → Specific zone → tu dominio.
Así, si el token se filtra, solo sirve para tocar el DNS de ese dominio. No uses la “Global API Key” de la cuenta para esto.
Guardalo en un archivo que solo lea root:
install -m 600 /dev/null /root/.cloudflare-token
nano /root/.cloudflare-token
El script
Lo guardé en /usr/local/bin/cloudflare-ddns. Necesita curl y jq (apt install curl jq).
#!/bin/sh
# Mantiene el dominio y su comodín apuntando a la IP pública actual
ZONA=ejemplo.com.ar
TOKEN=$(cat /root/.cloudflare-token) || exit 1
API=https://api.cloudflare.com/client/v4
cf() { curl -fsS --max-time 20 -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" "$@"; }
IP=$(curl -fsS --max-time 10 https://api.ipify.org) \
|| { logger -t cloudflare-ddns "sin IP pública"; exit 1; }
ZID=$(cf "$API/zones?name=$ZONA" | jq -r ".result[0].id")
[ -n "$ZID" ] && [ "$ZID" != null ] \
|| { logger -t cloudflare-ddns "zona no encontrada"; exit 1; }
for NOMBRE in "$ZONA" "*.$ZONA"; do
REG=$(cf "$API/zones/$ZID/dns_records?type=A&name=$NOMBRE" | jq -c ".result[0] // empty")
DATOS=$(jq -nc --arg n "$NOMBRE" --arg ip "$IP" \
'{type:"A",name:$n,content:$ip,ttl:300,proxied:false}')
if [ -z "$REG" ]; then
cf -X POST "$API/zones/$ZID/dns_records" -d "$DATOS" >/dev/null \
&& logger -t cloudflare-ddns "creado $NOMBRE -> $IP"
elif [ "$(echo "$REG" | jq -r .content)" != "$IP" ]; then
cf -X PUT "$API/zones/$ZID/dns_records/$(echo "$REG" | jq -r .id)" -d "$DATOS" >/dev/null \
&& logger -t cloudflare-ddns "actualizado $NOMBRE -> $IP"
fi
done
Qué hace, paso por paso:
- Lee el token y averigua la IP pública preguntándole a
api.ipify.org. - Busca el identificador de la zona en Cloudflare.
- Para el dominio y para el comodín, busca el registro A. Si no existe, lo crea. Si existe con otra IP, lo actualiza. Si ya tiene la IP correcta, no hace nada.
- Deja un mensaje en el log del sistema solo cuando cambia algo.
Usar jq para armar el JSON evita problemas de comillas, y -f en curl hace que un error HTTP corte el script en lugar de seguir con datos basura.
chmod 755 /usr/local/bin/cloudflare-ddns
/usr/local/bin/cloudflare-ddns && journalctl -t cloudflare-ddns -n 5
El timer de systemd
En lugar de cron, uso un timer de systemd: los logs quedan en el journal y es fácil ver cuándo corrió.
/etc/systemd/system/cloudflare-ddns.service:
[Unit]
Description=Actualiza el dominio en Cloudflare
Wants=network-online.target
After=network-online.target
ConditionPathExists=/root/.cloudflare-token
[Service]
Type=oneshot
ExecStart=/usr/local/bin/cloudflare-ddns
/etc/systemd/system/cloudflare-ddns.timer:
[Unit]
Description=Actualiza el dominio en Cloudflare cada 5 minutos
[Timer]
OnBootSec=1min
OnUnitActiveSec=5min
[Install]
WantedBy=timers.target
Y se activa:
systemctl daemon-reload
systemctl enable --now cloudflare-ddns.timer
systemctl list-timers cloudflare-ddns.timer
Un detalle: con doble NAT, ¿qué IP ves?
El script pregunta la IP desde el propio servidor, así que obtiene la IP con la que sale la conexión del laboratorio. Si en tu casa hay más de una salida a internet (dos proveedores, por ejemplo), asegurate de que sea la misma por la que entran las conexiones. En mi caso la PC sale por un camino y el laboratorio por otro, y el script tiene que correr en el laboratorio.
Usar el mismo script para otras cosas
Como el script ya sabe cuándo cambia la IP, lo aproveché para actualizar también una línea de la lista de IPs permitidas de Traefik que necesita conocer la IP de casa. Un sed al final del script alcanza.
¿Y DuckDNS?
DuckDNS es gratis y anda bien, pero te da un subdominio de duckdns.org y no podés crear tus propios registros. Lo sigo usando en paralelo para cosas de prueba. Para todo lo serio, el dominio propio con este script.