# Caché

> Guarda respuestas en el borde de OpenWAF, púrgalas en todos los nodos en un segundo y envía 103 Early Hints. Desactivada hasta que la actives.

La caché del borde de OpenWAF guarda las respuestas cacheables en cada nodo del borde, de modo que las peticiones repetidas se responden sin llegar a tu origen. Sigue el mismo modelo que las grandes CDN, con valores por defecto más seguros: los ficheros estáticos se cachean por extensión desde el primer momento, el HTML y el JSON solo cuando una regla lo indica, y se respeta el `Cache-Control` de tu origen.

> **Nota**
>
> La caché del borde está en beta y viene **desactivada por defecto**. No se cachea nada hasta que la activas en una zona o en un nombre.


## Dónde encaja

```text
petición ─▶ WAF · límites de peticiones · puerta de acceso · agentes IA ─▶ caché ─▶ origen
```

Todos los controles de seguridad se ejecutan **antes** de la caché. Una petición que bloquea el WAF nunca recibe una respuesta cacheada, y los aciertos también cuentan para los límites de peticiones. La caché ahorra trabajo a tu origen y tiempo a tus visitantes; nunca se salta la seguridad.

## Funciones

- **Valores por defecto seguros.** Los ficheros estáticos (imágenes, CSS, JS, fuentes, multimedia, archivos comprimidos, documentos) son elegibles; `Set-Cookie`, `private`, `no-store` y las cabeceras `Vary` desconocidas dejan una respuesta fuera de la caché. La [armadura anti-engaño de caché](https://developers.openwaf.dev/es/cache/default-behavior/#deception-armor) está activada.
- **Reglas de caché.** Hasta 25 reglas para omitir rutas o hacer elegible el HTML, con TTL del borde y del navegador, tratamiento de la cadena de consulta y contenido caducado. Plantillas para WordPress, Next.js y webs estáticas.
- **Purga rápida.** Por URL, prefijo, nombre, `Cache-Tag` o todo. Los nodos del borde la aplican en un segundo aproximadamente, y puedes ver cómo la confirma cada nodo.
- **Contenido caducado.** Sirve una copia caducada mientras se revalida, o cuando el origen está caído o responde 5xx.
- **103 Early Hints.** Deja que el navegador empiece a cargar hojas de estilo, fuentes y la imagen principal mientras tu origen aún genera la página.
- **Depuración clara.** Cada respuesta lleva `X-Cache-Status` y la cabecera estándar `Cache-Status`.

## Por dónde empezar

- [Primeros pasos](https://developers.openwaf.dev/es/cache/get-started/): activa la caché y comprueba que funciona.
- [Comportamiento por defecto](https://developers.openwaf.dev/es/cache/default-behavior/): qué se cachea, cuánto tiempo y qué nunca.
- [Claves de caché](https://developers.openwaf.dev/es/cache/cache-keys/): cómo se asignan las peticiones a los objetos en caché; cadenas de consulta y `Vary`.
- [Cabeceras de estado de la caché](https://developers.openwaf.dev/es/cache/cache-status/): cómo leer `X-Cache-Status`, `Cache-Status` y `Age`.
- [Configurar la caché](https://developers.openwaf.dev/es/cache/configure/): nivel de caché, TTL del navegador, modo desarrollo y contenido caducado.
- [Reglas de caché](https://developers.openwaf.dev/es/cache/cache-rules/): omite o cachea por ruta, extensión, cookie o parámetro.
- [Purgar la caché](https://developers.openwaf.dev/es/cache/purge/): todo, URL, prefijos, nombres o etiquetas, desde el panel o desde tu CI.
- [Early Hints](https://developers.openwaf.dev/es/cache/early-hints/): envía respuestas 103 con enlaces de precarga.
- [Referencia de ajustes](https://developers.openwaf.dev/es/cache/settings/): todos los ajustes, valores por defecto y límites.
- [Solución de problemas](https://developers.openwaf.dev/es/cache/troubleshooting/): por qué no se cachea una respuesta.