Almacenar CSS/JS en caché de forma agresiva
Acelere los recursos con GET/HEAD, respuestas 200/301/302/304 y un TTL de 1 día o más; elimine los parámetros de seguimiento de campañas de la clave de caché.
Ayuda de CDN.com.tr
Definir el comportamiento de caché con Add Rule
Configure la clave de caché de dominio/ruta, el TTL, métodos/estados, encabezados/cookies, optimización y reglas de límite de velocidad.
Caché, seguridad, WAF y purga
Definir el comportamiento de caché con Add Rule
Configure la clave de caché de dominio/ruta, el TTL, métodos/estados, encabezados/cookies, optimización y reglas de límite de velocidad.
Ruta en el panel
- Panel de administración
- Cuentas CDN
- Advanced Management
- Add Rule
- Save / Apply Changes
¿Qué resuelve Add Rule?
Estos ejemplos usan escenarios seguros de origen WordPress para archivos estáticos, cadenas de consulta, encabezados/cookies y rutas de sesión sensibles.
Omitir administración, inicio de sesión, carrito y pago
Omita el caché cuando esté presente una cookie de sesión o carrito; las rutas wp-admin y wp-login nunca deben entrar en el caché compartido.
Limpiar encabezados de origen y depurar de forma segura
Ignore Set-Cookie o Cache-Control para las decisiones de caché, oculte X-Origin-Debug/X-Powered-By a los usuarios y active la depuración ascendente solo temporalmente.
Limitar la velocidad y permitir parámetros de consulta en lista blanca
Para rutas tipo API, incluya en la clave de caché solo los parámetros de consulta que cambian el contenido y establezca un límite de solicitudes.
Requisitos previos
- Se debe seleccionar una cuenta y un nombre de host.
- Guardar un Add Rule puede activar el flujo de implementación/aplicación en vivo; revise primero la ruta, el dominio y el orden de las reglas.
- Las capturas de pantalla usan valores como `www.example.com` en lugar de dominios reales de clientes.
- Para aplicaciones basadas en sesión como WordPress, escriba reglas de omisión de administración/inicio de sesión/carrito antes de almacenar en caché de forma amplia.
Modelo de decisión
Primero delimite el alcance
Reduzca la regla por dominio, protocolo y expresión regular de ruta antes de cambiar el comportamiento; las reglas amplias `/` necesitan revisión deliberada.
- Service domain: ¿qué nombre de host se ve afectado?
- Type: ¿se necesita HTTP y/o HTTP-2?
- Path Regex: ¿archivo, carpeta o endpoint exacto?
Modelo de consulta de la clave de caché
Mantenga los parámetros de consulta en la clave de caché solo cuando cambien el contenido; los parámetros de seguimiento generalmente se eliminan.
- Full query: cada parámetro crea un objeto de caché separado.
- Ignore all/listed: colapsa los parámetros de campaña.
- Allow listed: conserva solo parámetros como `lang` o `v`.
¿Bypass o TTL?
El contenido personalizado, de carrito y de administración debe omitir el caché; el contenido estático y anónimo puede recibir TTL.
- Bypass Cache: rutas de sesión/administración/carrito.
- Cache Expire Time: contenido estático y anónimo.
- Response TTL: duraciones separadas para 404/500 y otros estados.
Comportamiento de encabezados y cookies
Ignorar un encabezado de origen para las decisiones de caché es distinto de ocultarlo al cliente.
- Ignore Headers: elimina encabezados de las decisiones de caché del CDN.
- Hide Headers: no expone los encabezados de respuesta al navegador.
- Bypass by Cookie: omite el caché cuando la cookie está presente.
Guía paso a paso
Abrir Add Rule desde Advanced Management
Los ajustes preestablecidos a nivel de cuenta definen el comportamiento general; Add Rule escribe el comportamiento preciso para un dominio/ruta.
- Seleccione la cuenta de destino en CDN Accounts.
- Abra Advanced Management.
- Haga clic en Add Rule.
Resultado esperado: Se abre el modal de la regla y la nueva regla se prepara dentro del alcance de la cuenta seleccionada.
cdnctl equivalent
cdnctl accounts list
export ACCOUNT_UUID=<selected_account_uuid>
cdnctl cdn advanced-rules list --account "$ACCOUNT_UUID" --format tableReducir el alcance de dominio, protocolo y expresión regular de ruta
Estos campos determinan qué solicitudes coinciden con la regla; una expresión regular demasiado amplia puede cambiar todo el sitio.
- Elija el nombre de host en Service Domain Name.
- Seleccione HTTP y/o HTTP-2.
- Ingrese un patrón de archivo, carpeta o endpoint en Path Regex.
- Elija un ajuste preestablecido de caché si es necesario.
Resultado esperado: La regla coincide únicamente con el nombre de host y las rutas de destino.
cdnctl equivalent
cat > rule-static-assets.json <<EOF
{"server_domain_names":["www.example.com"],"type":["http","http2"],"path_regex":"^/cdn-help/rules/(cache-demo\\.css|query-demo\\.json)$"}
EOF
cdnctl cdn advanced-rules validate --account "$ACCOUNT_UUID" --file rule-static-assets.jsonDefinir clave de caché, TTL, métodos y estados
Para archivos estáticos, elimine los parámetros de consulta de seguimiento de la clave de caché y conserve solo las variantes reales.
- Elija Ignore listed params o Allow listed params en Cache Key Query Params.
- Ingrese Cache Expire Time.
- Limite Allowed Cache Methods y Allowed Cache Responses.
- Agregue valores de TTL por estado cuando sea necesario.
Resultado esperado: Los objetos CSS/JSON anónimos se almacenan en caché sin dividir el caché por parámetros de consulta innecesarios.
cdnctl equivalent
jq '. + {"cache_query_mode":"ignore_list","cache_query_params":["utm_*","gclid","fbclid","msclkid"],"cache_valid_time":"1 day","allowed_cache_methods":["GET","HEAD"],"allowed_cache_responses":["200","301","302","304"],"response_cache_times":{"200":"1 day","301":"1 week","302":"2 hours","304":"1 day"}}' rule-static-assets.json > rule-static-assets-cache.json
cdnctl cdn advanced-rules validate --account "$ACCOUNT_UUID" --file rule-static-assets-cache.jsonMantener las rutas de sesión de WordPress fuera del caché
Las rutas de administración, inicio de sesión, carrito y pago deben preservar el comportamiento del origen en lugar de devolver aciertos de caché.
- Delimite Path Regex a las rutas `/wp-admin`, `wp-login.php`, `cart` o `checkout`.
- Active Bypass Cache.
- Ingrese las cookies de sesión/carrito una por línea en Bypass by Cookie.
- Agregue Request Limit o reglas de hotlink si es necesario.
Resultado esperado: Las solicitudes de sesión no devuelven contenido en caché compartido a otro usuario.
cdnctl equivalent
cat > rule-wordpress-sensitive.json <<EOF
{"server_domain_names":["www.example.com"],"type":["http","http2"],"path_regex":"^/(wp-admin|wp-login\\.php|cart|checkout)(/.*)?$","bypass":"on","bypass_by_cookie":"wordpress_logged_in\nwoocommerce_cart_hash\nwp_woocommerce_session_","limit":30,"per_time":10}
EOF
cdnctl cdn advanced-rules validate --account "$ACCOUNT_UUID" --file rule-wordpress-sensitive.jsonConectar encabezados, cookies, optimización y depuración
Decida por separado si los encabezados de origen afectan las decisiones de caché y si se exponen a los navegadores.
- Use Ignore Headers para encabezados que no deban afectar las decisiones de caché.
- Use Hide Headers para encabezados que no deban exponerse a los clientes.
- Agregue Custom Headers de solicitud cuando sea necesario.
- Active Debug upstream headers solo durante pruebas temporales.
- Pruebe Image optimization y Google pagespeed solo en rutas delimitadas.
Resultado esperado: Los encabezados de origen se controlan de forma deliberada y la depuración no queda activada en el tráfico de producción.
cdnctl equivalent
jq '. + {"ignore_headers":["Cache-Control","Set-Cookie"],"hide_headers":["X-Origin-Debug","X-Powered-By"],"custom_headers":"X-Forwarded-Host: $host\nX-CDN-Rule-Debug: temporary","debug_upstream_headers":true,"image_optimization":"on","white_space":"on"}' rule-static-assets-cache.json > rule-headers-debug.json
cdnctl cdn advanced-rules validate --account "$ACCOUNT_UUID" --file rule-headers-debug.jsonGuardar, vigilar la implementación y verificar la URL pública
Como Save puede activar el flujo de aplicación en vivo, la verificación final se basa en ruta/dominio/TTL/encabezado.
- Revise los campos modificados y el orden de las reglas antes de guardar.
- Después de Save, vigile el estado de Operations o Apply Changes.
- Pruebe el estado, los encabezados de caché, los encabezados ocultos y la omisión por cookie en la URL pública.
Resultado esperado: Después del éxito de la operación, las solicitudes coincidentes muestran el nuevo comportamiento de caché/encabezado/límite de velocidad.
cdnctl equivalent
cdnctl cdn advanced-rules create --account "$ACCOUNT_UUID" --file rule-headers-debug.json
cdnctl operations list --account "$ACCOUNT_UUID"
curl -I "https://www.example.com/cdn-help/rules/cache-demo.css?utm_source=test"
curl -I -H "Cookie: wordpress_logged_in=redacted" "https://www.example.com/wp-admin/"Verificación
- Se revisan el orden de las reglas y los campos modificados.
- Las expresiones regulares amplias `/` requieren confirmación explícita.
- Los encabezados de depuración ascendente se desactivan después de las pruebas.
- Después de aplicar, se verifican la URL pública, el código de estado, el comportamiento de la consulta de la clave de caché y el resultado de encabezados/cookies con curl o las herramientas de desarrollo del navegador.
- Si cdnctl 0.1.2 aún no expone comandos de reglas avanzadas, envía el mismo payload a través del flujo de la API pública `/api/advanced_managements/{account_uuid}/store`.
Casos de uso
El área de administración/carrito de WordPress evita el caché mientras los recursos estáticos y las rutas JSON anónimas se almacenan en caché de forma deliberada.
Flujo de trabajo rápido
- Abra Advanced Management.
- Delimite la solicitud con Add Rule.
- Complete los campos de caché, encabezado/cookie y seguridad.
- Después de Save, verifique las operaciones y la URL pública.
Verificaciones
- El orden de las reglas es claro.
- La expresión regular de ruta no es más amplia de lo necesario.
- Los encabezados de depuración se desactivan después de las pruebas.
- Los campos modificados son visibles antes de guardar.
Páginas relacionadas
Gestionar la Protección contra bots (JS Challenge)
Active la verificación de tres modos desde la página Seguridad, use "Todos" con criterio, lea la tasa de superación.
La página Seguridad: WAF, bloqueo de IP y país, hotlink, límite de velocidad
Todos los controles de seguridad a nivel de cuenta viven en una sola página Seguridad: el interruptor de WAF para todo el sitio, la protección contra bots con JS Challenge, el bloqueo de IP y de país, la protección hotlink, el límite de velocidad de solicitudes y la expiración de enlaces. Cada guardado se despliega al edge automáticamente — no hay un paso de publicación aparte.
Leer registros de WAF
Use los registros de WAF para explicar el tráfico bloqueado o desafiado sin exponer los sistemas de registro internos.
Purgar contenido en caché
Purgue una ruta, una ruta guardada o toda la cuenta y separe el caché del CDN del caché del navegador.
Claves de caché y purga: por qué ocurre "purgué pero sigue viejo"
Cada objeto en caché se almacena bajo una clave construida a partir de la solicitud: esquema, host, ruta y cadena de consulta. Una purga solo elimina una entrada cuando apunta exactamente a esa clave. Entender esta única idea explica casi todos los casos de "la purga no funcionó".
Leer el estado de caché: HIT, MISS, BYPASS, EXPIRED
Use el encabezado de respuesta X-Proxy-Cache-MT para ver exactamente qué hizo el CDN con una solicitud y verificar que el caché funciona como se espera.