Tutorial para borrar la caché de Cloudflare: Una guía completa para administradores web y de DevOps

¿Cómo afecta el borrado de la caché de Cloudflare a la implementación y la resolución de problemas?

Borrar la caché de Cloudflare es un paso clave en el ciclo de lanzamiento y resolución de problemas de sitios web y aplicaciones. Esta guía práctica y especializada abarca métodos de limpieza, consejos de seguridad, comandos de línea de comandos, automatización en CI/CD y configuraciones de Nginx/Apache y WordPress para que los administradores de sitios, los equipos de DevOps, los desarrolladores, los comerciantes y los jugadores puedan implementar cambios de forma rápida y segura en la periferia (más de 85 ubicaciones globales) después de una actualización o corrección de errores.

¿Por qué es necesario borrar la caché de Cloudflare?

Borrar caché Esto es necesario cuando las versiones antiguas del contenido (como CSS/JS/imágenes o HTML almacenado en caché en Edge) están causando problemas de visualización o rendimiento incorrectos.

• Después de actualizar los archivos estáticos o el contenido HTML almacenado en caché en Edge.
• Tras desplegar una aplicación o migrarla, la nueva versión debe mostrarse inmediatamente en los Edge.
• Para solucionar problemas de visualización o errores relacionados con contenido obsoleto.
• En situaciones donde el tiempo es crucial, como en el comercio o los juegos, el contenido en directo debe actualizarse instantáneamente.

Tipos de borrado de caché en Cloudflare

1) Deshazte de todo

Borrar todas las cachés en una zona. Rápido y sencillo, pero Costoso Y a veces aumenta la carga en el origen.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"purge_everything":true}'

2) Purga por URL (purga selectiva por URL)

Eliminar archivos o páginas específicos; la mejor opción para actualizar recursos o páginas específicas y evitar los efectos secundarios de una eliminación completa.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"files":["https://example.com/css/app.css","https://example.com/js/app.js"]}'

3) Purga por etiqueta — Avanzado

Limpieza por etiqueta Adecuado para invalidar un grupo de recursos marcados con una etiqueta; útil en aplicaciones complejas y microservicios.

Nota: Esta función puede variar en algunos planes o cuentas empresariales.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"tags":["product-123","homepage-v2"]}'

4) Modo de desarrollo y omisión de caché

El modo de desarrollo del panel de control desactiva el almacenamiento en caché en Edge durante 3 horas, lo que resulta perfecto para el desarrollo a corto plazo.

Para eludir las rutas de la API o basadas en cookies de Reglas de la página O Trabajadores Usar.

Obtención del ID de zona y creación de token API con acceso mínimo

Puedes usar la API para obtener el ID de zona; en el campo de respuesta. identificación Es lo mismo que el ID de zona.

curl -X GET "https://api.cloudflare.com/client/v4/zones?name=example.com" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json"

Para crear un token de API, vaya a la ruta Cloudflare → Mi perfil → Tokens de API → Crear token Proceda y otorgue solo los permisos necesarios. Normalmente, permiso Zona → Purga de caché Es suficiente para ciertas zonas. Restringir los tokens a una zona específica y establecer una fecha de vencimiento. Aumenta significativamente la seguridad.

Comprobación del estado de la caché de una respuesta (cf-cache-status)

Para depurar desde el encabezado estado de la caché de CF Uso, cuyos valores típicos son: GOLPEAR, EXTRAÑAR, VENCIÓ, DINÁMICA, DERIVACIÓN, REVALIDADO.

curl -I -s -D - https://example.com | grep -i cf-cache-status

Consejos y encabezados de configuración del servidor (Nginx/Apache)

Para archivos estáticos (comprimidos e inmutables)

Utilizar el control de caché a largo plazo junto con la huella digital (hash en el nombre del archivo) es el mejor enfoque para reducir la necesidad de una eliminación completa de los activos.

location ~* \.(js|css|jpg|jpeg|png|svg|woff2?)$ {
    expires 30d;
    add_header Cache-Control "public, max-age=2592000, s-maxage=2592000, immutable";
}

Esta configuración es adicional a las configuraciones Caché de todo / Caché perimetral TTL Cloudflare provoca que los activos se almacenen en el borde de la red durante mucho tiempo.

Para páginas HTML (actualizables)

location / {
    add_header Cache-Control "no-cache, must-revalidate, max-age=0";
}

En Cloudflare, puedes configurar un TTL de caché perimetral más bajo o usar reglas de página para tener un mayor control sobre las páginas importantes.

Respetar el encabezado de origen

En el panel de control de Cloudflare, en la sección de Almacenamiento en caché, hay una opción que determina si Cloudflare respetará los encabezados de origen o utilizará su propia configuración. Se recomienda habilitar esta opción para un mayor control. Control de caché de origen Usar.

Integración con WordPress y plugins

El plugin oficial de Cloudflare para WordPress permite la purga automática después de publicar o actualizar.

• Los plugins de caché como WP Rocket o W3 Total Cache tienen opciones de purga local; utilice la purga con Cloudflare al mismo tiempo para actualizar también el borde de la red.
• Para sitios críticos (VPS de comercio o sitios de juegos), reduzca la configuración de TTL y habilite la purga selectiva para mantener la latencia y la estabilidad.

Automatización de la limpieza de caché en CI/CD

Agrega un paso sencillo para eliminar las URL generadas después de la implementación automatizada (GitHub Actions / GitLab CI / Jenkins). Asegúrate de usar la gestión de secretos para almacenar los tokens.

- name: Purge Cloudflare cache
  run: |
    curl -X POST "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/purge_cache" \
    -H "Authorization: Bearer ${{ secrets.CF_API_TOKEN }}" \
    -H "Content-Type: application/json" \
    --data "{\"files\": [\"https://example.com/path/to/file.js\"]}"

Scripts de Linux para la limpieza por lotes

Para eliminar una lista de URL, puedes usar un archivo y jq. Para un mejor rendimiento, divide los lotes en 30 y ejecútalos en paralelo.

cat urls.txt | jq -R -s -c 'split("\n")[:-1]' | \
xargs -I{} curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
 -H "Authorization: Bearer <API_TOKEN>" -H "Content-Type: application/json" \
 --data '{"files":'{}'}'

Consejos y limitaciones de seguridad

Permisos mínimos Para el token de API: solo "Purga de caché" y limitado a las zonas necesarias; establezca una fecha de caducidad.

• Límites de velocidad: La API Purge tiene límites de solicitudes; evite purgar todo continuamente y utilice purgas por lotes cuando sea necesario.
• Registro de eventos: Registre cada purga en los registros de CI o del sistema para ver la causa y la hora; esto resulta útil para las auditorías.

Casos especiales: Trabajadores, KV y renderizado/GPU

Si está utilizando Cloudflare Workers, es posible que la purga de caché de zona estándar no borre la caché de Workers; en el código de Worker, utilice caché.eliminar Y utilice soluciones especiales.

Para archivos grandes, como modelos o archivos de renderizado, utilice el control de caché a largo plazo para archivos inmutables y la eliminación selectiva para actualizaciones.

Para usuarios sensibles como comerciantes y jugadores, elegir la ubicación y la configuración de CDN adecuadas es importante para reducir la latencia; el almacenamiento en caché debe configurarse de forma inteligente para mantener actualizado el contenido crítico.

Mejores prácticas y consejos prácticos

• Utilice Purge Everything únicamente como último recurso. Usar.
• Utilice la opción "Purgar por URL o etiquetas" para minimizar los efectos secundarios.
• Encabezados Control de caché Establezca el origen correctamente.
• Para contenido estático, utilice la caché de larga duración y la huella digital para publicar archivos nuevos sin necesidad de una eliminación completa.
• Utilice Page Rules o Cloudflare Workers para rutas o API sensibles que deban omitirse.
• Automatización: Combinar la eliminación de casos (archivos nuevos) con la integración continua después de cada despliegue.
• Seguridad: Utilice tokens restringidos y revise periódicamente el acceso.

Para mantener un equilibrio entre velocidad y estabilidad, la combinación de encabezados de origen y purga opcionales ofrece los mejores resultados.

Conclusión

Borrar la caché de Cloudflare puede parecer una tarea sencilla, pero requiere comprender los tipos de purgas, encabezados y las implicaciones de rendimiento y seguridad. Con la configuración adecuada, que incluye Origin Cache-Control, etiquetas y purgas selectivas, puedes mantener la velocidad y la estabilidad de tu aplicación, especialmente en infraestructuras con más de 85 ubicaciones globales y que utilizan servidores GPU, VPS dedicados o servicios anti-DDoS.

Si desea obtener más información sobre los planes, la configuración de la caché y la automatización posterior al lanzamiento, puede consultar los recursos y las páginas pertinentes o ponerse en contacto con el equipo de soporte.

Preguntas frecuentes