Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Configurer les en-têtes de requête HTTP

Dernière mise à jour :Aug 10, 2026

Par défaut, Alibaba Cloud CDN et DCDN transfèrent les en-têtes de requête, tels que ceux contenant l'adresse IP du client. Vous pouvez également configurer des en-têtes personnalisés. Pour réécrire les en-têtes HTTP dans les requêtes vers le serveur d'origine, modifiez les en-têtes de requête sortants. Cette fonctionnalité permet d'ajouter, de supprimer, de modifier ou de remplacer les en-têtes de requête HTTP envoyés au serveur d'origine afin de répondre à vos besoins métier.

Contexte

Un en-tête de requête HTTP fait partie d'un message de requête HTTP et sert à transmettre des paramètres spécifiques à un serveur.

Lorsqu'un point de présence (POP) CDN ou DCDN envoie une requête à un serveur d'origine pour récupérer des ressources, ce dernier accède aux informations contenues dans l'en-tête de la requête. Utilisez cette fonctionnalité pour réécrire les en-têtes HTTP dans les requêtes vers le serveur d'origine et lui transmettre des paramètres spécifiques.

Pour savoir comment un serveur d'origine récupère l'adresse IP réelle du client à partir de l'en-tête X-Forwarded-For dans une requête, consultez la rubrique Obtenir l'adresse IP réelle d'un client.

image

Remarques

  • Une requête sortante est un message HTTP envoyé par CDNDCDN à un serveur d'origine. La modification de la configuration des en-têtes de requête sortants affecte uniquement les messages HTTP envoyés par CDNDCDN au serveur d'origine. Cette configuration n'a aucun impact sur les messages HTTP servis directement depuis les POP CDNDCDN aux utilisateurs finaux.

  • Vous ne pouvez pas modifier les en-têtes de requête sortants pour un nom de domaine générique (wildcard).

  • ApsaraVideo VOD transmet par défaut les en-têtes de requête HTTP suivants lors du retour à l'origine. Aucune configuration supplémentaire n'est nécessaire.

    En-tête HTTP d'origine

    Description

    Exemple

    Ali-Cdn-Real-Ip

    L'adresse IP réelle du client se connectant à un POP CDN ou DCDN.

    Ali-Cdn-Real-Ip:192.168.0.1

    X-Forwarded-For

    Les adresses IP du client et de tous les POP intermédiaires CDN ou DCDN situés sur le chemin de la requête vers l'origine.

    X-Forwarded-For:192.168.0.1, 172.16.0.1

    X-Client-Scheme

    Le protocole de la couche application, tel que HTTP ou HTTPS, utilisé par un client pour envoyer une requête à un POP CDN ou DCDN.

    X-Client-Scheme:http

    Host

    Le nom de domaine du site web d'origine accédé par la requête vers l'origine.

    Host:example.com

    Via

    Les noms de tous les POP CDN ou DCDN traversés par la requête du client.

    Via:cn2546-10.l1, cache1.cn2546-10, l2cn2547-7.l2, cache1.l2cn2547-7

Procédure

  1. Connectez-vous à la console ApsaraVideo VOD.

  2. Dans le volet de navigation de gauche, sélectionnez Configuration Management > CDN Configuration > Domain Names.

  3. Recherchez le nom de domaine souhaité et cliquez sur Configure dans la colonne Actions.

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

  5. Cliquez sur l'onglet Back-to-origin HTTP Request Header.

  6. Cliquez sur Add et configurez les paramètres de l'en-tête.

    Important

    Si vous configurez différentes opérations pour le même en-tête de requête vers l'origine, un conflit survient et l'opération ayant la priorité la plus élevée s'exécute. L'ordre de priorité est le suivant : Replace > Add > Change et Delete.

    Ajouter un en-tête

    Paramètre

    Exemple

    Description

    Operation

    Ajouter

    Ajoute l'en-tête de requête spécifié aux requêtes vers le serveur d'origine.

    Request Header

    En-tête de requête d'origine personnalisé

    Sélectionnez Custom Back-to-origin Request Headers ou un en-tête de requête prédéfini.

    Header Name

    x-code

    Spécifie le nom de l'en-tête de requête personnalisé comme x-code.

    Header Value

    key1, key2

    Vous pouvez configurer plusieurs valeurs pour un en-tête de requête. Séparez les différentes valeurs par une virgule (,).

    Allow Duplicates

    Oui

    • Yes : Autorise l'ajout d'en-têtes de requête en double. Par exemple, x-code:key1 et x-code:key2.

    • No : Si vous ajoutez un en-tête portant le même nom, la nouvelle valeur écrase la valeur existante. Par exemple, si vous ajoutez d'abord x-code:key1 puis x-code:key2, la valeur finale sera x-code:key2.

    Rule Condition

    Ne pas utiliser

    Les conditions de règle identifient divers paramètres dans les requêtes des utilisateurs pour déterminer si une configuration s'applique à une requête spécifique.

    Important

    Lorsque vous utilisez une condition de règle, la correspondance se base sur la priorité de la condition associée, et non sur l'ordre de configuration de la fonctionnalité elle-même.

    • Ne pas utiliser : Aucune condition de règle n'est utilisée.

    • Pour ajouter ou modifier une condition de règle, accédez au moteur de règles.

    Supprimer un en-tête

    Paramètre

    Exemple

    Description

    Operation

    Supprimer

    Supprime tous les en-têtes correspondant au nom spécifié, y compris les doublons.

    Request Header

    En-tête de requête d'origine personnalisé

    Sélectionnez Custom Back-to-origin Request Headers ou un en-tête de requête prédéfini.

    Header Name

    x-code

    Spécifie le nom de l'en-tête de requête personnalisé comme x-code.

    Rule Condition

    Ne pas utiliser

    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.

    • Ne pas utiliser : N'utilise pas de condition de règle.

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

    Modifier un en-tête

    Paramètre

    Exemple

    Description

    Operation

    Modifier

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

    Request Header

    En-tête de requête d'origine personnalisé

    Sélectionnez Custom Back-to-origin Request Headers ou un en-tête de requête prédéfini.

    Header Name

    x-code

    Spécifie le nom de l'en-tête de requête personnalisé comme x-code.

    Change Value To

    key1, key3

    Vous pouvez configurer plusieurs valeurs pour un en-tête de requête. Séparez les différentes valeurs par une virgule (,).

    Rule Condition

    Ne pas utiliser

    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.

    • Ne pas utiliser : N'utilise pas de condition de règle.

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

    Remplacer un en-tête

    Paramètre

    Exemple

    Description

    Operation

    Remplacer

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

    Request Header

    En-tête de requête d'origine personnalisé

    Sélectionnez Custom Back-to-origin Request Headers ou un en-tête de requête prédéfini.

    Header Name

    x-code

    Spécifie le nom de l'en-tête de requête personnalisé comme x-code.

    Find

    key

    Une expression régulière pour trouver la valeur à remplacer.

    Replace With

    abc

    La valeur de remplacement.

    Match

    Tout faire correspondre

    • Match All : Remplace toutes les valeurs correspondantes. Par exemple, pour l'en-tête x-code:key1,key2,key3, si vous utilisez une expression régulière pour faire correspondre « key » et le remplacer par « abc », le résultat est x-code:abc1,abc2,abc3.

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

    Rule Condition

    Ne pas utiliser

    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.

    • Ne pas utiliser : N'utilise pas de condition de règle.

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

  7. Cliquez sur OK pour terminer la configuration.

Exemples

Exemple 1

Scénario : Ajoutez l'en-tête X-Forwarded-For aux requêtes de retour à l'origine pour transmettre l'IP du client et les adresses IP des serveurs proxy intermédiaires au serveur d'origine.

ApsaraVideo VOD inclut par défaut l'en-tête X-Forwarded-For dans les requêtes de retour à l'origine. Aucune configuration n'est nécessaire, sauf si vous souhaitez modifier le nom de l'en-tête.

Configuration :

  • Nom de l'en-tête personnalisé : X-Forwarded-For

  • Valeur de l'en-tête : $proxy_add_x_forwarded_for

Dans la boîte de dialogue Back-to-origin HTTP Request Header, définissez Header Operation sur Add, Custom Request Header Parameter sur Custom back-to-origin request header et Allow Duplicates sur Do not allow. Cliquez ensuite sur OK.

  • Nom de l'en-tête de requête personnalisé : X-Forwarded-For.

  • Valeur de l'en-tête de requête : $proxy_add_x_forwarded_for.

Exemple 2

Scénario : Ajoutez un en-tête aux requêtes de retour à l'origine pour transmettre l'adresse IP réelle du client au serveur d'origine.

ApsaraVideo VOD inclut par défaut l'en-tête Ali-Cdn-Real-Ip dans les requêtes de retour à l'origine. Cet en-tête contient l'adresse IP réelle du client. Aucune configuration n'est nécessaire, sauf si vous souhaitez modifier le nom de l'en-tête.

Configuration :

  • Nom de l'en-tête personnalisé : X-Real-IP

  • Valeur de l'en-tête : $http_Ali_Cdn_Real_Ip

Définissez Header Operation sur Add, Custom Request Header Parameter sur Custom back-to-origin request header et Allow Duplicates sur Do not allow. Cliquez ensuite sur OK.

Exemple 3

Scénario : Ajoutez un en-tête aux requêtes de retour à l'origine pour transmettre le port réel du client au serveur d'origine.

ApsaraVideo VOD inclut par défaut l'en-tête Ali-Cdn-Real-Port dans les requêtes de retour à l'origine. Cet en-tête contient le port réel du client. Aucune configuration n'est nécessaire, sauf si vous souhaitez modifier le nom de l'en-tête.

Configuration :

  • Nom de l'en-tête personnalisé : X-Real-Port

  • Valeur de l'en-tête : $http_Ali_Cdn_Real_Port

Définissez Header Operation sur Add, Custom Request Header Parameter sur Custom back-to-origin request header et Allow Duplicates sur Do not allow. Cliquez ensuite sur OK.

Documents connexes

Configurer des noms de domaine par lots