En bref. Placer un fichier texte brut _redirects dans le répertoire de sortie des ressources statiques et écrire une source, une destination et un code de statut facultatif par ligne.

Définition : Au 17 octobre 2026, Cloudflare Pages utilise un fichier texte brut nommé _redirects, sans extension, pour configurer les redirections des requêtes visant des ressources statiques. Chaque règle indique un chemin source, une destination et un code de statut HTTP facultatif.

Points clés

La documentation sur les redirections de Cloudflare prévoit une règle par ligne et un code de statut par défaut de 302.
La documentation sur la configuration de la compilation définit le répertoire de compilation (build) comme l’emplacement où la commande de compilation dépose le site compilé.
La documentation sur le routage des Functions prévoit une propriété exclude dans _routes.json pour les chemins qui doivent contourner les Functions, le code exécuté sur les routes correspondantes.

Où placer le fichier ?

Les consignes de placement de Cloudflare situent _redirects dans le répertoire des ressources statiques du projet. Avec un framework, public/ ou static/ contient souvent les ressources copiées dans le répertoire de sortie final lors de la compilation. Sans framework, le fichier peut se trouver directement dans le répertoire de sortie de la compilation.

Le déploiement obtenu doit contenir _redirects dans ce répertoire de sortie. Pages analyse le fichier et applique ses règles aux réponses servant des ressources statiques ; le fichier de configuration lui-même est exclu des ressources statiques servies.

Quelle syntaxe utiliser pour une redirection ?

Le format par ligne de Cloudflare est le suivant :

[source] [destination] [code?]

Les crochets décrivent les champs ; les règles réelles utilisent des chemins et des valeurs, comme dans ces exemples tirés de la même documentation :

/home301 / 301
/home302 / 302
/querystrings /?query=string 301
/twitch https://twitch.tv

La destination accepte un chemin local ou une URL externe, y compris une chaîne de requête ou un fragment. Les codes de statut de redirection pris en charge sont 301, 302, 303, 307 et 308. En l’absence de code, 302 est utilisé, comme dans l’exemple du lien externe. Une ligne commençant par # est un commentaire. Une règle dont le format est invalide est ignorée.

Comment les motifs capturent-ils des parties d’un chemin ?

Un caractère générique appelé « splat », écrit *, capture tous les caractères correspondants. La documentation sur les motifs de Cloudflare autorise un seul splat dans une URL et insère la valeur capturée dans la destination avec :splat.

Un paramètre de substitution nommé (named placeholder) capture une valeur sous un nom introduit par un deux-points. Dans un chemin, la correspondance s’arrête à une barre oblique. La même documentation donne ces exemples :

/blog/* /posts/:splat
/movies/:title /media/:title

Les noms de ces paramètres commencent par une lettre et contiennent des lettres, des chiffres ou des traits de soulignement. Chaque paramètre nommé ne peut être référencé qu’une seule fois. La destination peut aussi insérer les valeurs capturées dans une chaîne de requête :

/products/:code/:name /products?code=:code&name=:name

Quelles limites et exceptions s’appliquent aux règles ?

Les règles applicables au fichier de Cloudflare autorisent jusqu’à 2 000 redirections statiques et 100 redirections dynamiques, avec une limite de 1 000 caractères par déclaration. Les règles statiques doivent précéder les règles dynamiques. Lorsque plusieurs règles partagent un chemin source, celle qui figure le plus haut s’applique. Une redirection correspondante s’applique aussi lorsqu’une ressource existe au chemin demandé.

La même documentation exclut les requêtes servies par Pages Functions. Ces routes nécessitent une logique de redirection dans la Function ou une exclusion du routage des Functions. Les redirections s’exécutent également avant les règles de _headers.

Termes associés

Questions fréquentes

Puis-je rediriger vers un autre site web ?

Oui. La syntaxe de destination de Cloudflare accepte les liens externes, comme le montre /twitch https://twitch.tv.

Puis-je utiliser un fragment d’URL dans une règle ?

Vous pouvez inclure un fragment dans la destination. La même documentation explique que les fragments de la source sont ignorés, car le navigateur les évalue.

Puis-je servir une autre page locale sans changer l’URL dans le navigateur ?

La même documentation décrit le relais par proxy avec le statut 200, par exemple /blog/* /news/:splat 200. Ce mécanisme sert le contenu d’une autre URL relative du site ; les domaines externes sont exclus du relais par proxy.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Comment créer des redirections sur Cloudflare Pages ?