En bref. Définir include_subdomains sur true permet de faire correspondre le nom d’hôte source configuré et ses sous-domaines.
Définition : Oui. Il faut définir
include_subdomainssurtruepour la redirection d’URL. La redirection correspond alors au nom d’hôte source configuré ainsi qu’aux sous-domaines situés à sa gauche, tandis que la correspondance des chemins relève d’un paramètre distinct.
Points clés
- La référence des paramètres de redirection d’URL de Cloudflare définit
include_subdomainscomme un booléen dont la valeur par défaut estfalse. - Lorsque
include_subdomainsest activé, une source définie surexample.comcorrespond aussi àa.example.comet àa.b.example.com. - L’option s’applique au nom d’hôte source et à ses sous-domaines.
subpath_matchingdétermine si les chemins situés sous le chemin source configuré correspondent également. - Une URL source sans schéma correspond aux URL utilisant le schéma
httpcomme à celles utilisanthttps. - Si plusieurs redirections correspondent, une redirection dont le nom d’hôte correspond exactement est prioritaire sur une redirection pour laquelle l’option d’inclusion des sous-domaines (Include subdomains) est activée.
Comment l’option Include subdomains détermine-t-elle la correspondance d’un nom d’hôte ?
En juin 2026, la référence des paramètres de Cloudflare décrit include_subdomains comme un champ d’API de type booléen dont la valeur par défaut est false. Lorsque sa valeur est true, le nom d’hôte de l’URL source s’applique également aux sous-domaines situés à sa gauche, ainsi qu’au nom d’hôte spécifié lui-même.
Pour une URL source http://example.com/about, Cloudflare donne http://a.example.com/about et http://a.b.example.com/about comme exemples de requêtes correspondantes. Le paramètre couvre donc plusieurs niveaux de sous-domaines sous le nom d’hôte configuré. Il ne transforme pas le chemin source en motif de chemin avec caractère générique.
{
"source_url": "example.com/about",
"target_url": "https://example.com/newpage",
"include_subdomains": true
}
La redirection correspond-elle aussi aux chemins situés sous le chemin source ?
Cloudflare décrit subpath_matching comme le paramètre distinct qui contrôle les chemins situés sous le chemin source. Sa valeur par défaut est false. Lorsqu’il est activé, une redirection depuis /my-folder/ peut correspondre à /my-folder/item ; le segment restant, item, est transmis à la cible uniquement lorsque preserve_path_suffix vaut true.
L’algorithme de correspondance compare le schéma, le nom d’hôte et le chemin de la requête à la définition de la redirection. Il prend en compte les sous-domaines lorsque Include subdomains est activé et les sous-chemins lorsque l’option de correspondance des sous-chemins (Subpath matching) est activée. Par exemple, un chemin source example.com/blog peut également correspondre à example.com/blog/foo et à example.com/blog/bar lorsque la correspondance des sous-chemins est activée. La combinaison des deux paramètres couvre les noms d’hôte situés sous le nom d’hôte source configuré et les chemins situés sous le chemin source configuré.
Quelle redirection est prioritaire lorsque les noms d’hôte se recoupent ?
La documentation de Cloudflare sur la correspondance des Bulk Redirects indique qu’une redirection dont le nom d’hôte correspond exactement est prioritaire sur une redirection pour laquelle Include subdomains est activé. Parmi les redirections qui incluent toutes deux les sous-domaines, celle dont le domaine est le plus spécifique est prioritaire. L’exemple de Cloudflare compare bar.com à foo.bar.com : une requête vers qux.foo.bar.com utilise la redirection du domaine plus spécifique foo.bar.com.
Les redirections en masse (Bulk Redirects) sont évaluées avant l’envoi de la requête au serveur d’origine. Dès qu’une action de redirection s’exécute, Cloudflare n’effectue plus aucun traitement pour cette requête. La liste de redirections doit aussi être activée par une règle de redirection en masse (Bulk Redirect Rule) pour que ses redirections d’URL soient examinées.
Comment configurer l’URL source ?
Cloudflare exige une URL source, et l’URL de la requête entrante doit lui correspondre pour que la redirection s’applique. Le schéma peut être omis. Dans ce cas, la redirection s’applique aux requêtes HTTP comme aux requêtes HTTPS. La configuration consiste à inclure le nom d’hôte et le chemin à faire correspondre, puis à activer include_subdomains pour les noms d’hôte situés sous cette source.
Le guide de l’API Cloudflare montre que la mise en place de Bulk Redirects consiste à créer une liste de redirections, à y ajouter des éléments de redirection d’URL, puis à créer une Bulk Redirect Rule qui active la liste. Le trafic entrant destiné au nom d’hôte présent dans les requêtes des visiteurs doit passer par le proxy Cloudflare.
Termes associés
- Comment les Bulk Redirects de Cloudflare conservent-ils le suffixe d’un répertoire correspondant ?
- Pourquoi les redirections Cloudflare Bulk Redirects peuvent-elles supprimer les paramètres de requête d’une URL cible ?
- Quelle redirection est prioritaire lorsque des règles Cloudflare Pages se chevauchent ?
FAQ
include_subdomains inclut-il le nom d’hôte configuré lui-même ?
Oui. Cloudflare décrit la correspondance comme couvrant le domaine spécifié ainsi que les sous-domaines situés à sa gauche.
La redirection correspond-elle automatiquement à un chemin d’URL plus profond ?
Non. Activez subpath_matching lorsque la redirection doit aussi s’appliquer aux chemins situés sous le chemin source. preserve_path_suffix détermine si la partie du chemin qui n’a pas fait l’objet de la correspondance est copiée vers la cible.
Que se passe-t-il si une redirection avec correspondance exacte du nom d’hôte et une redirection de sous-domaines correspondent toutes deux ?
La redirection dont le nom d’hôte correspond exactement est prioritaire selon les règles de correspondance de Cloudflare. Pour deux redirections qui incluent toutes deux les sous-domaines, le domaine le plus spécifique est prioritaire.
Sources
- Cloudflare, « URL redirect parameters », 26 juin 2026
- Cloudflare, « How Bulk Redirects work », 5 mai 2026
- Cloudflare, « Create Bulk Redirects via API », 25 août 2026
Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO