Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Configurer les en-têtes de réponse HTTP

Dernière mise à jour :Aug 10, 2026

Lorsque le cache d'un point de présence (POP) expire ou en cas d'absence de cache (cache miss), le POP demande le contenu le plus récent au serveur d'origine. Le contenu et les en-têtes HTTP renvoyés par le serveur d'origine sont appelés en-têtes de réponse d'origine. Vous pouvez modifier ces en-têtes sur votre serveur d'origine pour définir une politique de mise en cache, configurer le partage de ressources cross-origin (CORS), etc. Cela vous permet d'optimiser la vitesse de chargement du site web, de renforcer la sécurité du contenu, de contrôler l'accessibilité des ressources et d'améliorer l'expérience utilisateur.

Contexte

Les en-têtes de réponse HTTP font partie d'une réponse HTTP et transmettent des paramètres spécifiques au client.

Lorsque le contenu demandé par un utilisateur final n'est pas mis en cache sur un nœud CDN, le CDN effectue une requête vers l'origine et le serveur d'origine envoie une réponse. Vous pouvez modifier les en-têtes HTTP dans cette réponse entrante. Par exemple, vous pouvez réécrire la valeur de l'en-tête Content-Type avant sa transmission au client afin de garantir une analyse correcte. Si le serveur d'origine renvoie une valeur Content-Type incorrecte, le client risque de ne pas pouvoir analyser correctement le contenu. Vous pouvez résoudre ce problème en réécrivant l'en-tête sur le CDN.

image
Remarque
  • Une réponse entrante est le message HTTP qu'un serveur d'origine envoie à un nœud CDN. La modification des en-têtes de réponse entrants affecte uniquement le message HTTP envoyé du serveur d'origine au nœud CDN ; elle n'affecte pas les réponses que le nœud CDN sert à l'utilisateur final.

  • Vous ne pouvez pas modifier les en-têtes de réponse entrants pour les domaines génériques (wildcard).

Procédure

  1. Connectez-vous à la console ApsaraVideo VOD.

  2. Dans le volet de navigation de gauche, choisissez Configuration Management > CDN Configuration > Domain Names.

  3. Recherchez le nom de domaine que vous souhaitez gérer et cliquez sur Configure dans la colonne Actions.

  4. Dans le volet de navigation de gauche pour le nom de domaine, cliquez sur Back-to-Origin.

  5. Cliquez sur l'onglet Origin HTTP Response Headers.

  6. Cliquez sur Add et configurez l'en-tête de réponse HTTP de retour vers l'origine.

    Important

    Si plusieurs opérations s'appliquent au même paramètre d'en-tête de réponse d'origine, elles sont exécutées selon la priorité suivante : Replace > Add > Change et Delete. Par exemple, si une opération d'ajout et une opération de suppression sont configurées pour le même paramètre, l'opération d'ajout est exécutée avant l'opération de suppression.

    Ajouter un en-tête de réponse

    Paramètre

    Exemple

    Description

    Operation

    add

    Ajoute l'en-tête de réponse spécifié à la réponse d'origine.

    Response Header

    Custom Response Header

    Sélectionnez Custom Response Header ou un paramètre d'en-tête de réponse prédéfini.

    Header Name

    x-code

    Spécifie le nom de l'en-tête de réponse personnalisé.

    Header Value

    key1

    Saisissez une ou plusieurs valeurs d'en-tête, séparées par des virgules (,).

    key1,key2

    Allow Duplicates

    Allow

    • Yes : Vous permet d'ajouter des en-têtes de réponse en double. Par exemple, x-code:key1 et x-code:key2.

    • No : Si un en-tête portant le même nom existe déjà, la nouvelle valeur écrase l'existante. Par exemple, si vous ajoutez x-code:key1 puis x-code:key2, l'en-tête final est x-code:key2.

    Rule Condition

    Do not use

    Une condition de règle identifie diverses informations de paramètre dans une requête utilisateur. Cela détermine si une configuration prend effet pour cette requête.

    • Do not use : N'utilise pas de condition de règle.

    • Pour ajouter ou modifier des conditions de règle, gérez-les dans Rules Engine.

    Supprimer un en-tête de réponse

    Paramètre

    Exemple

    Description

    Operation

    delete

    Supprime tous les en-têtes de réponse ayant le nom spécifié, y compris les doublons.

    Response Header

    Custom Response Header

    Sélectionnez Custom Response Header ou un paramètre d'en-tête de réponse prédéfini.

    Header Name

    x-code

    Spécifie le nom de l'en-tête de réponse personnalisé à supprimer.

    Rule Condition

    Do not use

    Une condition de règle identifie diverses informations de paramètre dans une requête utilisateur. Cela détermine si une configuration prend effet pour cette requête.

    • Do not use : N'utilise pas de condition de règle.

    • Pour ajouter ou modifier des conditions de règle, gérez-les dans Rules Engine.

    Modifier un en-tête de réponse

    Paramètre

    Exemple

    Description

    Operation

    modify

    Modifie l'en-tête. Cette opération n'est pas autorisée si des en-têtes en double portant le même nom existent.

    Response Header

    Custom Response Header

    Sélectionnez Custom Response Header ou un paramètre d'en-tête de réponse prédéfini.

    Header Name

    x-code

    Spécifie le nom de l'en-tête de réponse personnalisé à modifier.

    Change Value To

    key1,key3

    Spécifie la nouvelle valeur de l'en-tête. Pour configurer plusieurs valeurs, séparez-les par des virgules (,).

    Rule Condition

    Une condition de règle identifie diverses informations de paramètre dans une requête utilisateur. Cela détermine si une configuration prend effet pour cette requête.

    • Do not use : N'utilise pas de condition de règle.

    • Pour ajouter ou modifier des conditions de règle, gérez-les dans Rules Engine.

    Remplacer un en-tête de réponse

    Paramètre

    Exemple

    Description

    Operation

    replace

    Remplace la valeur de l'en-tête. Cette opération n'est pas autorisée si des en-têtes en double portant le même nom existent.

    Response Header

    Custom Response Header

    Sélectionnez Custom Response Header ou un paramètre d'en-tête de réponse prédéfini.

    Header Name

    x-code

    Spécifie le nom de l'en-tête de réponse personnalisé dont vous souhaitez remplacer la valeur.

    Find

    key

    Une expression régulière qui correspond à la partie de la valeur de l'en-tête à remplacer.

    Replace With

    abc

    La valeur qui remplace le texte correspondant.

    Match

    Match All

    • Match All : Remplace toutes les occurrences correspondant à l'expression régulière. Par exemple, si l'en-tête est x-code:key1,key2,key3 et que vous utilisez une expression régulière pour remplacer la valeur correspondante key par abc, le résultat est x-code:abc1,abc2,abc3.

    • Match the First Only : Remplace uniquement la première occurrence correspondant à l'expression régulière. Par exemple, si l'en-tête est x-code:key1,key2,key3 et que vous utilisez une expression régulière pour remplacer la valeur correspondante key par abc, le résultat est x-code:abc1,key2,key3.

    Rule Condition

    -

    Une condition de règle spécifie les critères qu'une requête utilisateur doit respecter pour que cette configuration s'applique.

    • Do not use : Aucune condition de règle n'est utilisée.

    • Pour ajouter ou modifier des conditions de règle, accédez à la page rule engine.

  7. Cliquez sur OK pour terminer la configuration.

Exemples de configuration

Exemple 1 : Définir un type MIME de réponse

Cas d'utilisation

Définissez un type MIME spécifique pour une réponse.

Remarque

Les types MIME incluent les catégories principales suivantes :

  • Text : Inclut les fichiers texte (tels que .txt et .csv) et les fichiers HTML (tels que .html, .htm et .shtml).

  • Image : Inclut les fichiers image courants (tels que .jpg, .png et .gif).

  • Audio : Inclut les fichiers audio (tels que .mp3 et .wav).

  • Video : Inclut les fichiers vidéo (tels que .mp4 et .avi).

  • Application : Inclut les fichiers d'application (tels que .pdf, .doc et .xls).

Configuration

  • Opération d'en-tête de réponse : Add

  • Nom de l'en-tête : Content-Type

  • Valeur de l'en-tête : text/html

    Définissez Allow Duplicates sur Do not allow et Rule Condition sur Do not use, puis cliquez sur OK.

Résultat : Le POP ajoute l'en-tête Content-Type: text/html à la réponse du serveur d'origine. Si vous configurez à nouveau cet en-tête, la nouvelle valeur écrase l'existante.

Exemple 2 : Supprimer un en-tête de réponse

Cas d'utilisation

Suppression d'un en-tête de réponse.

Configuration

  • Opération d'en-tête de réponse : Delete

  • Nom de l'en-tête : Content-Type

    Définissez Allow Duplicates sur Do not allow et Rule Condition sur Do not use, puis cliquez sur OK.

Résultat : Le POP supprime l'en-tête Content-Type de la réponse avant de la renvoyer au client.

Remarque

Si vous appliquez les configurations de l'Exemple 1 et de l'Exemple 2, le système ajoute d'abord puis supprime l'en-tête de réponse Content-Type: text/html . Par conséquent, le client reçoit la réponse sans type MIME spécifié.

Références

Configurer des noms de domaine par lot