Tous les produits
Search
Centre de documentation

Edge Security Acceleration:Créer une règle de réécriture d'URI

Dernière mise à jour :Sep 21, 2026

Lorsqu'une ressource sur le serveur d'origine est déplacée, les points de présence (POP) du Dynamic Content Delivery Network (DCDN) réécrivent les URL de requête obsolètes et les redirigent vers le nouveau chemin. Cette opération réduit les requêtes vers l'origine et améliore les performances d'accès.

Remarque

Remarque : Lorsque cette fonctionnalité utilise les conditions de règle du Rules Engine, l'ordre d'exécution suit la priorité des conditions configurées dans le Rules Engine, et NON la priorité définie dans la configuration de cette fonctionnalité.

Informations générales

Le code d'état HTTP 302 (Found) indique que la ressource demandée a été temporairement déplacée. Lorsqu'une règle de réécriture d'URI est configurée, les POP DCDN ajoutent le nouvel URI à l'en-tête Location de la réponse HTTP 302. Le client envoie ensuite une nouvelle requête au nouvel URI.

Outre le code d'état 302 par défaut, les POP prennent également en charge les codes 303 et 307. Pour modifier le code d'état de redirection, soumettez un ticket.

Code d'état HTTP

Description

Méthode de traitement

Scénario

302

Found

Les requêtes GET restent inchangées. Les requêtes utilisant d'autres méthodes peuvent être converties en requêtes GET.

Une page web est temporairement inaccessible pour des raisons inconnues. Les moteurs de recherche ne mettent pas à jour l'URL de la page web.

303

See Other

Les requêtes GET restent inchangées. Les requêtes utilisant d'autres méthodes sont converties en requêtes GET. Le corps du message est supprimé.

Ce code d'état sert à rediriger les requêtes PUT et POST afin d'éviter les redirections répétées lors de l'actualisation de la page.

307

Temporary Redirect

La méthode de requête et le corps du message restent inchangés.

Une page web est temporairement inaccessible pour des raisons inconnues. Les moteurs de recherche ne mettent pas à jour l'URL de la page web. Si le site web prend en charge des méthodes de requête autres que GET, le code d'état 307 est renvoyé à la place du 302.

Important

Vous pouvez créer jusqu'à 50 règles de réécriture pour un nom de domaine. Si vous configurez plusieurs règles, elles s'appliquent selon l'ordre décroissant de leur liste dans la console DCDN.

Scénarios

Si une ressource sur le serveur d'origine est déplacée vers un autre répertoire, l'URL mise en cache sur les POP est mise à jour en conséquence. Lorsqu'un client envoie une requête à l'URL d'origine, DCDN réécrit et redirige la requête vers la nouvelle URL. Par exemple, un fichier image est déplacé du répertoire /download/ vers le répertoire /image/.

image

Procédure

  1. Connectez-vous à la console DCDN.

  2. Dans le volet de navigation de gauche, cliquez sur Domain Names.

  3. Sur la page Domain Names, localisez le nom de domaine cible et cliquez sur Configure.

  4. Dans l'arborescence de navigation de gauche du nom de domaine, cliquez sur Caching.

  5. Cliquez sur l'onglet URL Rewrite.

  6. Cliquez sur Add et configurez la règle de réécriture selon vos besoins métier.

    Paramètre

    Description

    URI to Be Rewritten

    • Le chemin doit commencer par une barre oblique (/) et exclure le protocole et le nom de domaine.

    • Les expressions régulières compatibles Perl (PCRE) sont prises en charge. Exemple : ^/hello$.

    Target URI

    • Si vous définissez Flag sur Break dans une règle de réécriture, le chemin doit commencer par une barre oblique (/) et exclure le protocole et le nom de domaine.

    • Si vous définissez Flag sur Redirect dans une règle de réécriture, le chemin peut contenir le protocole et le nom de domaine. Les PCRE sont pris en charge. Par exemple, $1 et $2 servent à référencer les chaînes capturées entre parenthèses dans le chemin à réécrire.

    Flag

    Valeurs valides : Redirect et Break.

    • Redirect : Si l'URI d'une requête correspond à une règle, le POP renvoie le code d'état 302 et redirige la requête vers l'URI spécifié dans l'en-tête Location. Les paramètres de l'URI d'origine ne sont pas modifiés. Après l'exécution de la règle actuelle, la requête est comparée aux autres règles.

    • Break : Si l'URI d'une requête correspond à une règle, le POP redirige la requête vers l'URI cible. Les paramètres de l'URI d'origine ne sont pas modifiés. Après l'exécution de la règle actuelle, les règles restantes sont ignorées.

  7. Cliquez sur OK.

    Une fois la fonctionnalité de réécriture créée, vous pouvez Modify ou Delete la règle dans l'onglet URL Rewrite.

Exemples de configuration

Exemple 1

Lorsqu'un client demande http://example.aliyundoc.com/hello, le chemin de la requête est /hello. Le POP inclut la nouvelle URL http://example.aliyundoc.com/index.html dans l'en-tête Location de la réponse 302 et renvoie la réponse au client. Le client envoie ensuite une requête à http://example.aliyundoc.com/index.html.

Pour cette règle, Path to Rewrite est défini sur ^/hello$, Destination Path est défini sur /index.html et Execution Rule est défini sur redirect.

Remarque

Lors d'une redirection 302, si l'en-tête Location n'inclut ni protocole ni nom de domaine, le client utilise par défaut le protocole et le nom de domaine de la requête d'origine.

Exemple 2

Lorsqu'un client demande http://example.aliyundoc.com/hello, le chemin de la requête /hello correspond à l'expression régulière ^/hello$. Le POP renvoie une réponse 302 au client. La réponse inclut l'URL de destination https://test.aliyundoc.com/index.html dans l'en-tête Location. Après réception de la réponse, le client envoie une requête à https://test.aliyundoc.com/index.html.

Règle de configuration : Définissez Path to Rewrite sur ^/hello$, définissez Destination Path sur https://test.aliyundoc.com/index.html et définissez Execution Rule sur redirect.

Exemple 3

Lorsqu'un client demande http://www.example.com/cdn/url/http://image.example.com/image/cat.jpg, le chemin de la requête contient /cdn/url/http://, ce qui correspond à l'expression régulière ^/cdn/url/http://(.*). Le POP renvoie une réponse 302 au client. La réponse inclut l'URL de destination http://image.example.com/image/cat.jpg dans l'en-tête Location. Après réception de la réponse, le client envoie une requête à http://image.example.com/image/cat.jpg.

Pour la règle de configuration, définissez Destination Path sur http://$1 et Execution Rule sur redirect.

Exemple 4

Lorsqu'un client demande http://example.aliyundoc.com/stories/index.html#/voice/318, la partie #/voice/318 de l'URL est un identifiant de fragment côté client. Le navigateur n'envoie pas cette partie au serveur. Le chemin de requête réel reçu par le POP est /stories/index.html. Par conséquent, lors de la configuration de la règle de réécriture, définissez Path to Rewrite sur ^/stories/index\.html$ pour faire correspondre le chemin avant le #. Ensuite, définissez Destination Path sur l'URL cible et Execution Rule sur Redirect.

Pour rediriger plusieurs URL sources ayant différents fragments # vers différentes URL de destination, vous devez configurer une règle de réécriture distincte pour chaque chemin source. En effet, un serveur ne peut pas distinguer les URL en fonction du contenu qui suit le symbole #.

Exemple 5

Configurer une page d'accueil de sous-répertoire : Renvoyer le fichier de page d'accueil par défaut d'un sous-répertoire lorsqu'un client accède au nom du sous-répertoire est une exigence courante pour les sites web. Vous pouvez utiliser la réécriture d'URL d'accès pour implémenter cette fonctionnalité côté DCDN sans modifier votre serveur d'origine. Par exemple, si le fichier de page d'accueil est https://www.example.com/cdn/index.html, après l'application de la configuration, une requête client vers https://www.example.com/cdn ou https://www.example.com/cdn/ renvoie le fichier de page d'accueil.

Avant de configurer les règles, assurez-vous que le fichier de page d'accueil dans le sous-répertoire sur le serveur d'origine est accessible. Par exemple, vérifiez que https://www.example.com/cdn/index.html peut être renvoyé comme prévu.

Le chemin de requête d'un client peut se terminer ou non par une barre oblique (/). Par conséquent, vous devez configurer les deux règles suivantes pour couvrir les deux cas :

  • Règle 1 : Définissez Path to Rewrite sur ^/(.+)/$, définissez Destination Path sur /$1/index.html et définissez Execution Rule sur Break.

  • Règle 2 : Définissez Path to Rewrite sur ^/([^.?#]+)$, définissez Destination Path sur /$1/index.html et définissez Execution Rule sur Break.

Après l'application de la configuration, accédez directement à un sous-répertoire, tel que https://www.example.com/cdn. Si le fichier de page d'accueil du sous-répertoire est renvoyé comme prévu, la configuration est réussie.

API associée

BatchSetDcdnDomainConfigs