Aprende a purgar recursos almacenados en la memoria caché de Cloudflare utilizando los métodos de purga disponibles para tu plan Cloudflare.
Información general
La aplicación de Almacenamiento en caché en el panel de control de Cloudflare permite la purga de recursos almacenados en caché por un solo archivo (recomendado), nombre de servidor o etiqueta de caché (solo para plan Enterprise) o todo el contenido almacenado en caché. Todos los clientes pueden purgar por un solo archivo (por URL) o todos los activos almacenados en caché. Los clientes de Cloudflare Enterprise también pueden purgar el uso de nombres de servidor y etiquetas de caché.
Purgar por un solo archivo (por URL)
Cuando eliges la opción Purgar por URL (por un solo archivo) en la aplicación Almacenamiento en caché, ese recurso almacenado en caché se elimina inmediatamente de los activos almacenados en tu CDN en todos los centros de datos. Cualquier solicitud nueva para el activo purgado obtiene la última versión de tu servidor web de origen y la agrega de nuevo a tu caché de CDN dentro del centro de datos de Cloudflare específico que atendió la solicitud.
¡Importante!: La purga por un solo archivo realizada a través de tu panel de control de Cloudflare no borra los objetos que contienen:
- Claves personalizadas de la memoria caché
- Un encabezado de origen
- Cualquiera de estos encabezados de respuesta:
- X-Forwarded-Host
- X-Host
- X-Forwarded-Scheme
- X-Original-URL
- X-Rewrite-URL
- Forwarded
Sin embargo, puedes purgar objetos con estas características a través de una llamada de la API (Purgar archivos mediante la dirección URL).
Asegúrate de incluir todos los encabezados y claves de la memoria caché contenidos en el objeto almacenado en la memoria caché, junto con los valores correspondientes, en la sección de datos/encabezados de la llamada de la API.
Cómo purgar por un solo archivo a través de tu panel de control de Cloudflare
1. Inicia sesión en Cloudflare y selecciona el sitio con los recursos que se van a purgar.
2. Haz clic en la aplicación Almacenamiento en caché.
3. En el panel Purgar caché, haz clic en Purga personalizada.
Aparece el cuadro de diálogo Purga personalizada.
4. Selecciona URL en Purgar por campo.
5. Introduce los valores apropiados en el cuadro de texto, utilizando el tipo de formato que se muestra en el ejemplo.
6. Sigue el resto de indicaciones para completar el formulario.
7. Revisa tus entradas.
8. Haz clic en Purgar.
Purgar todo
Para mantener un rendimiento óptimo del sitio, recomendamos encarecidamente utilizar la purga por un solo archivo (por URL) en lugar de una purga de caché completa.
Purgar todo borra inmediatamente todos los recursos de tu caché de CDN en todos los centros de datos de Cloudflare. Cada solicitud nueva de un recurso depurado regresa a tu servidor de origen para validar el recurso. Si Cloudflare no puede validar el recurso, obtiene la última versión del servidor de origen y reemplaza la versión almacenados en caché. Cuando un sitio con mucho tráfico contiene muchos activos, las solicitudes a tu servidor de origen pueden aumentar sustancialmente y pueden resultar en un rendimiento del sitio lento.
Purga todo a través de tu panel de control de Cloudflare
Recordatorio: te recomendamos que purges archivos únicos.
1. Inicia sesión en Cloudflare y selecciona el sitio con los recursos que se van a purgar.
2. Haz clic en la aplicación Almacenamiento en caché.
En el panel Purgar caché, haz clic en Purgar todo.
Aparece un cuadro de diálogo de advertencia.
4. Si aceptas, haz clic en Purgar todo.
Purgar los recursos almacenados en caché a través de la API
Puedes automatizar o purgar la caché de scripts utilizando estas API de Cloudflare:
Purgar utilizando etiquetas de caché (solo Cloudflare Enterprise)
La purga de etiquetas de caché facilita la depuración de varios archivos. Puedes realizar una purga masiva al añadir etiquetas de caché a tus activos (páginas web, archivos de imagen, etc.).
Cómo funcionan las etiquetas de caché
Este es el flujo de trabajo general para usar etiquetas de caché:
- Añade etiquetas al encabezado de respuesta HTTP de etiqueta de caché de tu servidor web de origen para tu contenido web (páginas, activos estáticos, entre otros).
- Asegúrate de que tu tráfico web sea redirigido mediante proxy a través de Cloudflare.
- Cloudflare asocia las etiquetas en el encabezado HTTP de etiqueta de caché con el contenido que se está almacenando en caché.
- Utiliza etiquetas de caché específicas para purgar tu caché CDN de Cloudflare de todo el contenido que contenga esa etiqueta de caché, a través de tu panel de control o utilizando nuestra API.
- Cloudflare fuerza una falta de caché en el contenido con la etiqueta de caché purgada.
Cómo añadir encabezados de respuesta HTTP de etiqueta de caché
Añade etiquetas de caché a tu contenido web en los encabezados de respuesta HTTP de etiqueta de caché. Utiliza encabezados HTTP para permitir que el cliente y el servidor pasen información adicional en solicitudes o respuestas. Los encabezados HTTP consisten en un nombre que no distingue entre mayúsculas y minúsculas seguido de dos puntos (:) y el valor válido. Por ejemplo, etiqueta de caché: etiqueta1, etiqueta2, etiqueta3. Usa comas, tal y como se indica, para separar las etiquetas cuando quieres usar múltiples etiquetas de caché.
Cuando tu contenido llega a nuestra red perimetral, Cloudflare:
- Elimina el encabezado HTTP de etiqueta de caché antes de enviar la respuesta al visitante de tu sitio web.
Tus usuarios finales nunca ven los encabezados HTTP de etiqueta de caché en tu sitio web habilitado para Cloudflare.
- Elimina espacios en blanco del encabezado y cualquier nombre de etiqueta de caché antes y después:
etiqueta1, etiqueta2 y etiqueta1,etiqueta2 se consideran iguales.
- Elimina todas las comas repetidas y finales antes de aplicar etiquetas de caché:
etiqueta1,,,etiqueta2 y etiqueta1, etiqueta2 se consideran iguales.
Algunas cosas para recordar:
- Una sola respuesta HTTP puede tener más de un campo de encabezado HTTP de etiqueta de caché.
- La longitud mínima de una etiqueta de caché es de 1 byte.
Las etiquetas individuales no tienen una longitud máxima, pero el encabezado HTTP de etiqueta de caché agregado no puede exceder los 16 KB después del nombre del campo del encabezado, lo que supone aproximadamente 1 000 etiquetas únicas. La longitud incluye espacios en blanco y comas, pero no el nombre del campo del encabezado.
- Para las depuraciones de caché, la longitud máxima de las etiquetas de caché en una llamada de la API es de 120 caracteres.
- El encabezado HTTP de etiqueta de caché debe aceptar todos los caracteres válidos permitidos en los encabezados HTTP, como se especifica en RFC-5987.
- No se permiten espacios en las etiquetas de caché.
- No importa si se usa mayúscula o minúscula:
etiqueta1 y etiqueta1 se consideran iguales.
Purgar con etiquetas de caché en el panel de control de Cloudflare
1. Inicia sesión en Cloudflare y selecciona el sitio con los recursos que se van a purgar.
2. Haz clic en la aplicación Almacenamiento en caché.
3. En el panel Purgar caché, haz clic en Purga personalizada.
Aparece el cuadro de diálogo Purga personalizada.
4. Selecciona Etiqueta en Purga por sección.
En el cuadro de texto, introduce tus etiquetas para purgar los recursos en caché.
6. Haz clic en Purga.
Cómo purgar mediante etiquetas de caché o nombres de servidor a través de la API de Cloudflare
Consulta nuestra documentación sobre la eliminación de activos almacenados en caché de tu CDN al usar las API de nombre de servidor o Purga por etiqueta de caché . Puedes usar hasta 30 etiquetas de caché en una llamada de la API y realizar hasta 30 000 llamadas de la API de purga en un periodo de 24 horas.
Purgar la memoria caché por prefijo (solo Cloudflare Enterprise)
Los clientes Enterprise pueden purgar su caché mediante el prefijo de la URL o los separadores de ruta en su URL. Por ejemplo, en el caso de una URL como https://www.ejemplo.com/foo/bar/baz/qux.jpg, las solicitudes de purga válidas incluyen:
- www.ejemplo.com/
- www.ejemplo.com/foo/
- www.ejemplo.com/foo/barra/
- www.ejemplo.com/foo/barra/baz/
- www.ejemplo.com/foo/bar/baz/qux.jpg
La purga por prefijo es útil en muchos casos como, por ejemplo:
- Purgar todo dentro de un directorio.
- Aumentar el control sobre los objetos almacenados en caché en una ruta.
- Simplificar el número de llamadas de purga enviadas.
Purga por prefijo de URL está disponible a través de la API Purga:
curl -X POST "https://api.cloudflare.com/client/v4/zones/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/purge_cache" \ -H "X-Auth-Email: [email protected]" \ -H "X-Auth-Key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \ -H "Content-Type: application/json" \ --data '{"prefixes":["www.example.com/foo","www.example.com/bar/baz"] }
La purga por prefijo de URL también está disponible a través de la interfaz de usuario:
- Inicia sesión en tu cuenta de Cloudflare.
- Selecciona la cuenta de Cloudflare correspondiente.
- Haz clic en la aplicación Almacenamiento en caché en el panel de control.
- Haz clic en la pestaña Configuración.
- Desplázate hasta la sección Purgar caché.
- Selecciona Purga personalizada y Prefijo
- Sigue las instrucciones de sintaxis.
- Un prefijo por línea
- Máximo 30 prefijos por llamada de la API
Existen varias limitaciones en cuanto a la purga por prefijo:
- Los separadores de ruta están limitados a 31 para un prefijo (example.com/a/b/c/d/e/f/g/h/i/j/k/l/m...).
- Las solicitudes de purga se limitan a 30 prefijos por solicitud.
- Se aplican límites de velocidad de purga.
- Las cadenas de consulta URI y los fragmentos no se pueden purgar por prefijo:
- www.ejemplo.com/foo?a=b (cadena de consulta)
- www.exmaple.com/foo#bar (fragmento)
Recursos relacionados
- ¿Qué extensiones de archivo almacena Cloudflare en la memoria caché para contenido estático?
- ¿Cómo puedo saber si Cloudflare almacena en la memoria caché mi sitio web o un archivo específico?
- ¿Cómo indico a Cloudflare qué debe almacenar en la memoria caché?
- Habilitar el encabezado Origin Cache-Control con las reglas de página de Cloudflare
- Cloudflare Caching