Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Configurer la redirection 301/302 à l'origine

Dernière mise à jour :Aug 10, 2026

Lorsque la redirection 301/302 à l'origine est activée, les points de présence (POP) du CDN gèrent directement les redirections 301 et 302 provenant du serveur d'origine au lieu de les renvoyer aux clients. Cette approche réduit la surcharge liée aux échanges de données et accélère la distribution des ressources.

Prérequis

Votre serveur d'origine utilise des redirections 301/302 pour mettre en œuvre sa logique métier.

Contexte

Les codes d'état HTTP 301 et 302 indiquent qu'une ressource a été déplacée et n'est plus accessible à l'emplacement demandé. Pour gérer cette situation, le serveur inclut généralement un en-tête Location dans sa réponse. Lorsqu'un client reçoit une réponse 301/302 accompagnée d'un en-tête Location, il envoie une nouvelle requête à l'adresse spécifiée afin de récupérer la ressource.

Fonctionnement

La redirection 301/302 signifie que lorsqu'un point de présence (POP) CDNDCDN reçoit un code d'état 301 ou 302 du serveur d'origine en réponse à une requête vers l'origine, le POP CDNDCDN suit directement l'adresse indiquée dans l'en-tête Location pour récupérer la ressource, au lieu de renvoyer le code d'état 301/302 à l'utilisateur.

image
  1. Un client demande le fichier http://example.com/examplefile.txt.

  2. Le fichier n'est pas mis en cache sur le point de présence (POP) CDNDCDN ; une requête vers l'origine est donc envoyée.

  3. Le serveur d'origine renvoie un code d'état 301 ou 302, avec un en-tête Location pointant vers http://www.example.org/examplefile.txt.

  4. Après avoir reçu la réponse du serveur d'origine, le POP CDNDCDN envoie une requête à l'adresse Location http://www.example.org/examplefile.txt pour récupérer la ressource.

  5. Une fois que le point de présence (POP) CDNDCDN a obtenu la ressource requise, celle-ci est mise en cache sur le POP CDNDCDN.

  6. Le POP CDNDCDN renvoie les ressources récupérées à l'utilisateur.

À ce stade, si un autre utilisateur demande le fichier http://example.com/examplefile.txt, la requête atteint directement le cache du point de présence (POP) CDN DCDN et le fichier est renvoyé à l'utilisateur.

Remarques relatives à l'utilisation

Avant de configurer la redirection 301/302 à l'origine, vérifiez si un hôte d'origine est configuré pour le nom de domaine accéléré dans ApsaraVideo VOD :

  • Si aucun hôte d'origine par défaut ou spécifique n'est configuré : lorsque le serveur d'origine répond à un POP CDNDCDN avec un code d'état 301/302 et une URL Location, l'en-tête Host de la requête vers l'origine utilisera le nom de domaine issu de l'URL Location.

  • Si un hôte d'origine est configuré pour le nom de domaine accéléré : lorsque le serveur d'origine renvoie un code d'état 301/302 avec une URL Location, le POP CDN utilise l'hôte d'origine configuré comme en-tête Host dans les requêtes suivantes adressées à l'URL Location. Par défaut, l'hôte d'origine correspond au nom de domaine accéléré. Si votre serveur d'origine exige que l'en-tête Host corresponde au nom de domaine présent dans l'URL Location, l'accès peut échouer. Pour résoudre ce problème, soumettez un ticket afin de demander une configuration backend. Pour plus d'informations, consultez la rubrique Nous contacter.

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. Repérez le nom de domaine à gérer et cliquez sur Configure dans la colonne Actions.

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

  5. Sous l'onglet Configuration, dans la section Origin 301/302 Redirection, activez l'interrupteur Origin 301/302 Redirection et configurez les paramètres.

    Paramètre

    Description

    Maximum 301/302 Redirects

    Ce paramètre définit le nombre maximal de fois qu'un point de présence (POP) CDN peut suivre une redirection lors d'une seule requête utilisateur. Si cette limite est dépassée, le POP renvoie directement un code d'état 301 ou 302 à l'utilisateur. La valeur par défaut est 2 et la plage valide s'étend de 1 à 5.

    Remarque

    La configuration du paramètre Maximum 301/302 Redirects influe sur le nombre maximal de requêtes vers l'origine. Le nombre maximal de requêtes vers l'origine correspond au nombre maximal de fois qu'un nœud CDN peut accéder au serveur d'origine lors d'une seule requête utilisateur.

    La formule est la suivante : Nombre maximal de requêtes vers l'origine = Maximum 301/302 Redirects + 1. Le maximum par défaut est 3 et la plage valide s'étend de 2 à 6.

    Retain Parameters in 301/302 Redirects

    • Yes : les paramètres de la requête d'origine sont conservés dans la requête vers l'origine adressée au nouvel emplacement.

    • No : les paramètres de la requête d'origine ne sont pas conservés dans la requête vers l'origine adressée au nouvel emplacement.

    Retain Request Headers in 301/302 Redirects

    • Yes : les en-têtes de la requête d'origine sont conservés dans la requête vers l'origine adressée au nouvel emplacement.

    • No : les en-têtes de la requête d'origine ne sont pas conservés dans la requête vers l'origine adressée au nouvel emplacement.

  6. Cliquez sur OK pour finaliser la configuration.

Exemple de configuration

Cas d'utilisation : les ressources de votre serveur d'origine ont été déplacées vers un nouvel emplacement, mais vous souhaitez que les clients y accèdent de manière transparente via le nom de domaine d'origine.

Configuration : activez la redirection 301/302 à l'origine pour le nom de domaine example.com avec les paramètres suivants :

  • Maximum Number of 301/302 Redirects : 2

  • Retain Parameters in 301/302 Redirects : Ne pas conserver

  • Retain Request Headers in 301/302 Redirects : Ne pas conserver

Explication des résultats : un utilisateur demande le fichier http://example.com/examplefile.txt. Si le fichier n'est pas mis en cache sur le nœud CDNDCDN, le nœud demande la ressource au serveur d'origine. Le serveur d'origine renvoie un code d'état 301 ou 302 ainsi que l'URL de redirection http://www.example.org/examplefile.txt.

  1. Lorsqu'un point de présence (POP) CDN DCDN reçoit un code d'état 301 ou 302, il envoie une requête à l'adresse de redirection. Le POP tente de suivre la redirection jusqu'à deux fois. En cas d'échec des tentatives, le POP renvoie le code d'état 301 ou 302 à l'utilisateur.

  2. Le POP CDNDCDN récupère la ressource, la renvoie à l'utilisateur et la met en cache sur le POP CDNDCDN.

  3. Lorsque d'autres utilisateurs demandent à nouveau le fichier, CDNDCDN renvoie directement la ressource mise en cache.