neytor/cloudflare-ddns-updater
Automatiza la actualización del DNS de Cloudflare con la IP pública del servidor, ideal para DDNS.
Image
Integration & delivery
Operating systems
Monitoring & observability
0
1.6K
neytor/cloudflare-ddns-updater repository overview
Cloudflare DDNS Updater
Contenedor Docker multi-arquitectura que mantiene tus registros DNS de Cloudflare sincronizados con tu IP pública.
Arquitecturas soportadas
| Arquitectura | Plataforma | Dispositivos |
|---|---|---|
| amd64 | linux/amd64 | Servidores, PCs, VPS |
| arm64 | linux/arm64 | Raspberry Pi 4, Raspberry Pi 5, Orange Pi, Apple Silicon |
| armv7 | linux/arm/v7 | Raspberry Pi 2, Raspberry Pi 3, Orange Pi Zero/One |
Compatible con cualquier placa ARM: Raspberry Pi, Orange Pi, Banana Pi, Rock Pi, ODROID, etc.
Requisitos
- Docker
- Cuenta en Cloudflare
- Token de API de Cloudflare con permisos para editar registros DNS
Variables de entorno
| Variable | Descripción | Default |
|---|---|---|
CLOUDFLARE_EMAIL | Email de tu cuenta Cloudflare | — |
CLOUDFLARE_API_TOKEN | API Key o Token de Cloudflare | — |
ZONE_ID | Zone ID del dominio en Cloudflare | — |
DNS_RECORD_NAME | Registros DNS separados por coma | — |
SLEEP_INTERVAL | Segundos entre verificaciones | 600 |
PROXY_ENABLED | Activar proxy de Cloudflare | true |
Uso
Docker Compose (recomendado)
services:
cloudflare-ddns:
image: neytor/cloudflare-ddns-updater:latest
container_name: cloudflare-ddns
restart: unless-stopped
env_file:
- variables.env
Fichero variables.env:
[email protected]
CLOUDFLARE_API_TOKEN=tu-api-token
ZONE_ID=tu-zone-id
DNS_RECORD_NAME=ejemplo.com,sub.ejemplo.com
SLEEP_INTERVAL=300
PROXY_ENABLED=true
Docker CLI
docker run -d \
--name cloudflare-ddns \
--restart unless-stopped \
-e CLOUDFLARE_EMAIL="[email protected]" \
-e CLOUDFLARE_API_TOKEN="tu-api-token" \
-e ZONE_ID="tu-zone-id" \
-e DNS_RECORD_NAME="ejemplo.com,sub.ejemplo.com" \
-e SLEEP_INTERVAL=300 \
-e PROXY_ENABLED=true \
neytor/cloudflare-ddns-updater:latest
Raspberry Pi / Orange Pi / Placas ARM
No necesitas hacer nada especial. La imagen es multi-arquitectura, Docker detecta automáticamente tu plataforma:
# Funciona igual en RPi 5, Orange Pi, o cualquier placa ARM
docker pull neytor/cloudflare-ddns-updater:latest
CI/CD
Este proyecto usa GitHub Actions con:
- Auto-Release: Detecta nuevas versiones de Python semanalmente, hace build multi-arch y crea un release con changelog
- PR Validation: Valida que el Dockerfile compile para las 3 arquitecturas antes de mergear
Uso manual (sin Docker)
Si prefieres ejecutar el script directamente:
pip install requests
export CLOUDFLARE_EMAIL="[email protected]"
export CLOUDFLARE_API_TOKEN="tu-api-token"
export ZONE_ID="tu-zone-id"
export DNS_RECORD_NAME="ejemplo.com"
python cloudflare_ddns.py
También puedes usar cron:
*/30 * * * * /ruta/al/script.shpara ejecutar cada 30 minutos.
Tag summary
Content type
Image
Digest
sha256:ba033f8ea…
Size
25.6 MB
Last updated
30 days ago
docker pull neytor/cloudflare-ddns-updater:3.14.6