CDN:Modify incoming response headers

Contexto

Los encabezados de respuesta HTTP son componentes de una respuesta HTTP que transmiten parámetros específicos al cliente.

Cuando el contenido solicitado por un usuario final no está almacenado en la caché de un nodo CDN, el servicio realiza una recuperación de origen y el servidor de origen envía una respuesta. Usted puede modificar los encabezados HTTP de esta respuesta entrante. Por ejemplo, es posible reescribir el valor del encabezado Content-Type antes de que llegue al cliente para garantizar un análisis sintáctico correcto. Si el servidor de origen devuelve un valor incorrecto para Content-Type, el cliente podría fallar al analizar el contenido. Este problema se resuelve al reescribir el encabezado en el CDN.

Casos de uso

A continuación se presentan diversos casos de uso comunes con sus respectivos ejemplos:

• Tipo de contenido incorrecto: si el tipo de contenido (Content-Type) que devuelve el servidor de origen no coincide con el contenido real, el cliente podría no analizarlo correctamente. Por ejemplo, un archivo HTML marcado erróneamente como texto sin formato. Configure el encabezado de respuesta del origen para resolver este problema.

  Ejemplo: cambie Content-Type: text/plain por Content-Type: text/html.

• Control de la política de caché: cuando requiere un control detallado sobre la política de almacenamiento en caché del CDN, ajuste los campos Cache-Control o Expires en los encabezados de respuesta del servidor de origen. Esta acción ayuda a optimizar la frecuencia de actualización del contenido y la tasa de aciertos de caché.

  Ejemplo: cambie Cache-Control: max-age=3600 por Cache-Control: max-age=86400 para ampliar el tiempo de expiración de la caché. Para obtener más información sobre las reglas de caché predeterminadas del CDN, consulte Alibaba Cloud CDN Default Cache Rules and Priorities.

• Cross-Origin Resource Sharing (CORS): si desea permitir que aplicaciones web de otros dominios accedan a recursos alojados en el CDN, debe configurar el encabezado Access-Control-Allow-Origin y otros encabezados CORS relacionados en el servidor de origen. Estos ajustes garantizan que, cuando un navegador realice una solicitud de origen cruzado, el CDN proporcione los encabezados de respuesta adecuados al cliente para evitar errores de CORS. Para obtener más información sobre problemas de acceso de origen cruzado, consulte Configure Cross-Origin Resource Sharing.

  Ejemplos:

  • Access-Control-Allow-Origin: *: permite solicitudes de recursos de origen cruzado desde todos los dominios.

  • Access-Control-Allow-Methods: GET, POST, OPTIONS: especifica los métodos HTTP permitidos para las solicitudes de origen cruzado.

• Transferencia comprimida: si el servidor de origen admite transferencias comprimidas pero no las ha habilitado, o si el algoritmo de compresión utilizado no es el más eficiente, establezca Accept-Encoding en el encabezado de respuesta de retorno al origen. De este modo, indicará al servidor de origen que utilice el método de compresión óptimo.

  Ejemplo: cambie Accept-Encoding: gzip, deflate por Accept-Encoding: br para priorizar la compresión Brotli. Para obtener más información, consulte Brotli Compression.

• Redirección: cuando el servidor de origen necesita redirigir a un usuario hacia otra URL, configure los encabezados de redirección correctos en el encabezado de respuesta del origen. Para obtener más información, consulte Configure 301/302 redirect following.

  Ejemplo: Location: https://www.example.com/new-page.html: notifica al CDN y al navegador del usuario la nueva ubicación del recurso para una redirección 301 o 302.

• Comportamiento de origen personalizado: en ocasiones es necesario agregar encabezados personalizados a la respuesta para implementar funciones específicas o con fines de seguimiento.

Notas

• Las configuraciones múltiples se ejecutan de arriba hacia abajo, según el orden en que aparecen en la lista. Sus efectos son acumulativos. Si varias configuraciones modifican el mismo encabezado, la última tiene prioridad. En el siguiente ejemplo, la configuración 2 es la que surte efecto:

  • Configuración 1: agregue el encabezado de respuesta HTTP: cache-control: max-age=3600

  • Configuración 2: agregue el encabezado de respuesta HTTP: cache-control: no-cache

• Cuando se aplican condiciones de regla, la coincidencia se determina por la prioridad de dichas condiciones y no por el orden de las configuraciones.

Procedimiento

1. Inicie sesión en la consola de CDN.

2. En el panel de navegación izquierdo, haga clic en Domain Names.

3. En la página Domain Names, busque el dominio de destino y haga clic en Manage en la columna Actions.

4. En el panel de navegación del dominio, haga clic en Origin Fetch.

5. Haga clic en la pestaña Modify Incoming Response Header.

6. Haga clic en Customize.

7. Modifique la configuración del encabezado de respuesta entrante.

   Importante

   Si varias operaciones se aplican al mismo parámetro de encabezado de respuesta del origen, estas se ejecutan según la siguiente prioridad: Replace > Add > Change y Delete. Por ejemplo, si configura una operación de adición y otra de eliminación para el mismo parámetro, la adición se ejecuta antes que la eliminación.

   Agregue un encabezado de respuesta

   Parámetro	Ejemplo	Descripción
   Operation	add	Agrega el encabezado de respuesta especificado a la respuesta del origen.
   Response Header	Custom Response Header	Seleccione Custom Response Header o un parámetro de encabezado de respuesta predefinido.
   Header Name	x-code	Especifica el nombre del encabezado de respuesta personalizado.
   Header Value	key1	Introduzca uno o más valores de encabezado, separados por comas (,).
   	key1,key2
   Allow Duplicates	Allow	Yes: permite agregar encabezados de respuesta duplicados. Por ejemplo, x-code:key1 y x-code:key2. No: si ya existe un encabezado con el mismo nombre, el nuevo valor sobrescribe al anterior. Por ejemplo, si agrega x-code:key1 y luego x-code:key2, el encabezado final será x-code:key2.
   Rule Condition	Do not use	Una condición de regla identifica diversa información de parámetros en una solicitud de usuario. Esto determina si una configuración surte efecto para dicha solicitud. Do not use: no utiliza ninguna condición de regla. Para agregar o editar condiciones de regla, gestiórelas en Rules Engine.

   Elimine un encabezado de respuesta

   Parámetro	Ejemplo	Descripción
   Operation	delete	Elimina todos los encabezados de respuesta que tengan el nombre especificado, incluidos los duplicados.
   Response Header	Custom Response Header	Seleccione Custom Response Header o un parámetro de encabezado de respuesta predefinido.
   Header Name	x-code	Especifica el nombre del encabezado de respuesta personalizado que se va a eliminar.
   Rule Condition	Do not use	Una condición de regla identifica diversa información de parámetros en una solicitud de usuario. Esto determina si una configuración surte efecto para dicha solicitud. Do not use: no utiliza ninguna condición de regla. Para agregar o editar condiciones de regla, gestiórelas en Rules Engine.

   Modifique un encabezado de respuesta

   Parámetro	Ejemplo	Descripción
   Operation	modify	Modifica el encabezado. Esta operación no se permite si existen encabezados duplicados con el mismo nombre.
   Response Header	Custom Response Header	Seleccione Custom Response Header o un parámetro de encabezado de respuesta predefinido.
   Header Name	x-code	Especifica el nombre del encabezado de respuesta personalizado que se va a modificar.
   Change Value To	key1,key3	Especifica el nuevo valor del encabezado. Para configurar varios valores, sepárelos con comas (,).
   Rule Condition		Una condición de regla identifica diversa información de parámetros en una solicitud de usuario. Esto determina si una configuración surte efecto para dicha solicitud. Do not use: no utiliza ninguna condición de regla. Para agregar o editar condiciones de regla, gestiórelas en Rules Engine.

   Reemplace un encabezado de respuesta

   Parámetro	Ejemplo	Descripción
   Operation	replace	Reemplaza el valor del encabezado. Esta operación no se permite si existen encabezados duplicados con el mismo nombre.
   Response Header	Custom Response Header	Seleccione Custom Response Header o un parámetro de encabezado de respuesta predefinido.
   Header Name	x-code	Especifica el nombre del encabezado de respuesta personalizado cuyo valor desea reemplazar.
   Find	key	Expresión regular que coincide con la parte del valor del encabezado que se va a reemplazar.
   Replace With	abc	Valor que reemplaza al texto coincidente.
   Match	Match All	Match All: reemplaza todas las apariciones que coinciden con la expresión regular. Por ejemplo, si el encabezado es x-code:key1,key2,key3 y utiliza una expresión regular para reemplazar el valor coincidente key por abc, el resultado será x-code:abc1,abc2,abc3. Match the First Only: reemplaza únicamente la primera aparición que coincide con la expresión regular. Por ejemplo, si el encabezado es x-code:key1,key2,key3 y utiliza una expresión regular para reemplazar el valor coincidente key por abc, el resultado será x-code:abc1,key2,key3.
   Rule Condition	-	Una condición de regla especifica los criterios que debe cumplir una solicitud de usuario para que esta configuración se aplique. Do not use: no se utiliza ninguna condición de regla. Para agregar o editar condiciones de regla, vaya a la página rule engine.

8. Haga clic en OK.

Encabezados de respuesta predeterminados

Alibaba Cloud CDN establece cuatro encabezados de respuesta de forma predeterminada: Cache-Control, Content-Type, Expires y Last-Modified. Estos encabezados esenciales del protocolo HTTP controlan el almacenamiento en caché, definen los tipos de contenido, establecen tiempos de expiración y registran la última fecha de modificación de los recursos.

Ejemplos de configuración

Preguntas frecuentes

• Para dudas sobre resolución de problemas (CORS, caracteres ilegibles, descarga o vista previa, Set-Cookie, tipo MIME de JS, etc.), consulte Cache troubleshooting.

• Para consultas generales (verificación ACAO del origen, configuración precisa de video/mp4, compatibilidad con archivos JS, estado de sincronización de archivos, etc.), consulte Origin fetch FAQ.