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
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.
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.