CDN
Purgar la caché de Kapsule CDN
Purging clears the copy of your content held at the edge so the next visitor gets a freshly fetched version from your origin, which is what you do when you have published a change and the old…
La purga vacía la copia de su contenido que se encuentra en el perímetro para que el próximo visitante obtenga una versión recientemente recuperada desde su origen, que es lo que usted realiza cuando ha publicado un cambio y la versión anterior aún se está mostrando.
El almacenamiento en caché es lo que hace que la CDN sea rápida, y también es la razón por la que un cambio que acaba de realizar puede no aparecer de inmediato. En lugar de reducir sus tiempos de vida útil de la caché a nada, manténgalos largos y purgue bajo demanda. Esta guía cubre ambos aspectos, además de cómo distinguir una caché de perímetro de una caché del navegador antes de buscar en el lugar incorrecto.
Cuándo necesita purgar
Purgue después de haber cambiado algo que los visitantes recuperan mediante URL:
- Ha reemplazado un archivo CSS o JavaScript y el anterior aún se está sirviendo.
- Ha cargado una nueva versión de una imagen sobre un nombre de archivo existente.
- Ha corregido un error en una página y desea que la versión rota desaparezca globalmente ahora mismo.
- Ha cambado el contenido de una página y no puede esperar a que expire el TTL del perímetro.
No necesita purgar cuando ha añadido una página completamente nueva o un nombre de archivo nuevo. Nada se almacena en caché para una URL que nunca ha sido solicitada.
Si versiona sus nombres de archivo de activos (style.a1b2c3.css en lugar de style.css), rara vez necesitará purgar en absoluto. Un nombre de archivo nuevo es una URL nueva, por lo que se recupera nuevo desde su origen y se almacena en caché bajo su propia clave.
Dónde se encuentra el control de purga
- Inicie sesión en KPanel.
- Haga clic en Websites en la barra lateral izquierda y luego haga clic en su sitio.
- En el menú del sitio, abra Performance y luego Kapsule CDN.
- Desplácese hasta la tarjeta Purge cache.
La dirección directa es /websites/<site-id>/cdn.

El control de purga solo aparece una vez que la CDN está activada para el sitio. Si la página muestra el banner CDN is off for this site o le solicita que conecte un dominio personalizado, no hay nada en el perímetro para purgar aún. Kapsule CDN es también un derecho del plan, por lo que un sitio en un plan de Kapsule Orbit u otro alojamiento en contenedor no tiene CDN en absoluto. Enabling Kapsule CDN on Your Site indica exactamente qué planes lo incluyen.
Purgar una URL individual
- En la tarjeta Purge cache, escriba la URL pública completa en URL to purge (leave blank for whole site). El marcador de posición del campo muestra la forma esperada:
https://your-domain.tld/path. - Haga clic en Purge.
- Aparece una confirmación que dice "Purged" seguida de la URL que ha introducido.
Utilice la URL exacta que un visitante solicitaría, incluyendo el esquema (https://), el host y la ruta. Una purga se hace coincidir en la URL, por lo que https://example.com/about y https://example.com/about/ son dos entradas de caché diferentes, al igual que la misma página con una cadena de consulta adjunta.
Purgar una URL es el primer paso correcto cuando sabe exactamente qué cambió. Es instantáneo y deja el resto de su caché intacto, por lo que el resto del sitio sigue siendo rápido.
Purgar todo el sitio
- Deje el campo URL to purge completamente en blanco.
- Haga clic en Purge.
- La confirmación dice "Full cache purged."
Una purga completa vacía todos los objetos almacenados en caché del sitio en cada ubicación de perímetro. Hasta que cada URL sea solicitada de nuevo, cada visitante es servido desde su origen, por lo que el origen recibe una ráfaga de tráfico y el primer visitante de cada página espera un viaje completo de ida y vuelta. En un sitio ocupado, prefiera purgar solo las URL específicas que cambió.
Cada purga que ejecuta se registra en el registro de actividad de la cuenta con la URL o un marcador de zona completa, por lo que puede ver quién purgó qué y cuándo.
Tiempos de vida útil de la caché y cómo interactúan
La tarjeta Cache TTLs, en la misma página, controla cuánto tiempo permanece el contenido sin una purga:
| Configuración | Lo que controla | Predeterminado |
|---|---|---|
| Edge TTL (seconds) | Cuánto tiempo el perímetro conserva una copia antes de volver a recuperar desde su origen | 3600 (1 hora) |
| Browser TTL (seconds) | Cuánto tiempo el navegador de un visitante mantiene su propia copia local | 3600 (1 hora) |
Los dos son independientes, y esta es la única fuente más común de confusión. Una purga vacía el perímetro. No puede llegar a la caché del navegador de un visitante. Si purgauesta y aún ve la versión anterior, casi con seguridad está mirando su propia caché del navegador.
Para descartar esto, cargue la página en una ventana privada o de incógnito, o realice una recarga dura. Si la ventana privada muestra la nueva versión, la purga funcionó y solo está esperando su propio navegador y los navegadores de otros visitantes, que se actualizarán una vez que expire su TTL del navegador.
Si publica con frecuencia y no puede versionar nombres de archivo, reduzca el Browser TTL a algo corto (unos pocos minutos) y deje el Edge TTL largo. Mantiene la mayor parte del beneficio del perímetro mientras da a los visitantes una ventana mucho más corta en la que pueden quedarse atrapados en una copia antigua.
Optimización de imágenes y purga
Si On-the-fly image optimisation está activado, el perímetro almacena el derivado optimizado de cada imagen junto con el original. Purgar la URL de la imagen también borra el derivado, por lo que una imagen reemplazada se vuelve a optimizar en su siguiente solicitud. No hay una purga separada para imágenes optimizadas.
Lo mismo se aplica a Serve WebP to supported browsers: la variante WebP vive bajo la misma URL y se borra con la misma purga.
Solución de problemas
"CDN not provisioned for this site." El sitio aún no tiene zona de perímetro. Primero habilite la CDN y espere a que el certificado termine de aprovisionarse.
"Purge failed." La solicitud de purga no llegó al perímetro. Espere un momento e intente de nuevo. Si sigue fallando, es posible que la zona de perímetro esté en medio del aprovisionamiento; compruebe que la página muestre el banner CDN is on.
He purgado y la página sigue siendo antigua. Primero verifique en una ventana privada. Si una ventana privada también muestra la versión antigua, confirme que ha purgado la URL exacta, incluida cualquier barra final y cadena de consulta, y luego intente una purga completa.
Solo algunos visitantes ven la actualización. Sus navegadores aún están dentro del TTL del navegador. Nada está mal: obtendrán la nueva versión cuando expire, o inmediatamente con una recarga dura.
El origen se cayó después de una purga completa. Esa es la ráfaga de tráfico no almacenado en caché descrita anteriormente. Aumente el TTL del perímetro, y la próxima vez purgue solo las URL que cambiaron. Improving Website Speed cubre cómo hacer que el origen en sí sea más resistente.
Si una purga se realiza correctamente pero el perímetro sigue sirviendo contenido antiguo durante más de unos pocos minutos, envíe un correo electrónico a support@kapsulehost.com con la URL exacta y la hora en que purgó.