Créer des Redirections Serverless avec Cloudflare Workers

Créer des redirections serverless avec Cloudflare Workers consiste à intercepter la demande de l'utilisateur sur le réseau Edge de Cloudflare et à renvoyer une réponse de redirection 301, 302 ou conditionnelle avant qu'elle n'atteigne le serveur d'origine. Cette méthode permet de créer rapidement et de manière évolutive des redirections basées sur le domaine, le chemin URL, le pays, l'appareil, la langue, les paramètres de campagne ou l'adéquation avec une ancienne page, sans toucher à la configuration du serveur web. C'est une solution particulièrement adaptée pour des transitions SEO, des changements de domaine, des parcours de pages de destination pour des campagnes, et la gestion de plusieurs sites, offrant une latence réduite, une gestion centrale, et une maintenance simplifiée.

Les redirections traditionnelles sont généralement mises en place via Apache .htaccess, des blocs de serveur Nginx, du code d'application ou des panneaux de contrôle d'hébergement. Ces méthodes restent valables ; toutefois, pour les sites à fort trafic, les équipes gérant plusieurs domaines, ou dans les projets nécessitant des décisions dynamiques basées sur différentes localisations, Cloudflare Workers offre une flexibilité supérieure. En effet, la logique de redirection s'exécute dans le datacenter Cloudflare le plus proche de l'utilisateur. Cela réduit à la fois la charge sur le serveur d'origine et diminue les risques de problèmes de performance et d'interruptions dues à des règles de serveur mal configurées.

Dans ce guide, vous trouverez des exemples pratiques allant des redirections 301 de base avec Cloudflare Workers, jusqu'à des scénarios de redirection basés sur le chemin, basés sur des paramètres de requête, basés sur le pays, axés sur les appareils mobiles, ainsi que des redirections en masse. Nous aborderons également, d'un point de vue SEO, quand utiliser 301 et quand préférer 302, les éléments à vérifier durant le processus de test, ainsi que les contrôles bénéfiques à effectuer concernant les domaines, les certificats SSL et l'hébergement sur l'infrastructure de Hostragons. Pour la gestion des domaines, vous pouvez consulter naturellement nos pages Enregistrement de domaine et gestion DNS, pour une connexion sécurisée solutions de certificats SSL, et pour un hébergement performant Paquets d'hébergement Web.

Qu'est-ce que Cloudflare Workers et pourquoi l'utiliser pour les redirections ?

Cloudflare Workers est une plateforme serverless qui vous permet d'exécuter des morceaux de code basés sur JavaScript aux points d'accès du réseau Cloudflare. L'expression « serverless » ne signifie pas qu'il n'y a pas de serveur ; cela signifie que vous n'avez pas à vous soucier de la gestion des serveurs, de l'évolutivité, de la maintenance de l'OS, ni de la capacité d'infrastructure. Lorsqu'un visiteur envoie une demande à votre site, un Worker gère cette demande sur le Edge, exécute vos règles et redirige l'utilisateur vers une autre adresse si nécessaire.

Le principal avantage d'utiliser des Workers pour des redirections est le niveau de contrôle qu'ils offrent. Vous pouvez non seulement effectuer une correspondance d'URL simple, mais également lire les en-têtes de la demande, le pays de l'utilisateur, le chemin, les paramètres de requête, les informations de l'agent utilisateur et la valeur d'hôte. Par exemple, vous pouvez transférer de manière permanente votre ancienne page /produits/hébergement vers la page /hébergement-web, rediriger uniquement les utilisateurs venant de l'étranger vers un sous-répertoire en anglais, ou diriger le trafic se présentant avec un certain paramètre de campagne vers une page de destination spécifique.

Dans la pratique, cette approche accelère également l'opération entre les équipes SEO et techniques. Pensez à ce que cela représenterait de transférer 450 URL d'un ancien site vers un nouveau. Plutôt que de modifier le fichier de configuration du serveur, de le publier, puis de revenir en arrière en cas d'erreur, vous pouvez gérer la carte de redirection à l'intérieur du Worker ou dans un espace de données externe comme KV. Cela facilite les processus de déploiement, de test et de retour en arrière.

Différences entre les redirections basées sur le serveur et celles avec Cloudflare Workers

Il n'existe pas de méthode unique qui convienne à tous les projets. Pour un petit site, quelques redirections 301 peuvent être réalisées via l'outil de redirection du panneau de contrôle d'hébergement. Cependant, si une logique complexe, un trafic élevé, plusieurs domaines et un besoin de changements rapides sont requis, Cloudflare Workers devient plus efficace. Le tableau suivant résume les principales différences à considérer lors de votre prise de décision.

Vous pouvez interpréter ce tableau par une règle simple : si le nombre de redirections est faible, les conditions sont simples et vous avez un accès serveur convivial, la méthode classique peut convenir. Cependant, si vos redirections impliquent une migration SEO, une distribution basée sur les pays, un flux de campagne A/B, ou une architecture multi-domaines, la couche Worker devient plus viable.

Pré-requis avant de commencer

Avant de procéder à des redirections avec Cloudflare Workers, il est important de compléter la préparation technique pour réduire les erreurs. Tout d'abord, votre domaine doit être actif sur Cloudflare et vos enregistrements DNS doivent être correctement configurés. Les enregistrements DNS avec un nuage gris qui n'ont pas la fonction proxy de Cloudflare activée peuvent ne pas activer le chemin du Worker comme prévu. Il est donc essentiel de vérifier l'état de proxy de Cloudflare pour l'hôte sur lequel la redirection sera appliquée.

• Un compte Cloudflare et un domaine actif pour la redirection.
• Des enregistrements DNS corrects, notamment A, CNAME ou d'autres types connexes.
• État du proxy Cloudflare et choix correct du mode SSL/TLS.
• Carte de redirection : anciennes URL, nouvelles URL et codes d'état.
• Liste de contrôle SEO : canonical, sitemap, liens internes et état de l'index.
• Outil de test : navigateur, curl ou outil de vérification des en-têtes HTTP.

Il est également crucial que votre serveur d'origine fonctionne correctement. La redirection du Worker peut réduire la charge sur l'origine, mais elle ne compense pas une configuration DNS ou SSL défectueuse. Si vous prévoyez de faire des redirections HTTPS, il est bénéfique de s'assurer que votre compte d'hébergement sur Hostragons a un certificat SSL actif. Les contenus Comment installer SSL gratuit et Opérations de redirection via cPanel peuvent servir de guides complémentaires à ce sujet.

Étapes pour créer des redirections serverless avec Cloudflare Workers

1. Créez un Worker

Accédez au panneau Cloudflare, sélectionnez le compte concerné, entrez dans la section Workers and Pages et créez un nouveau Worker. Au départ, Cloudflare vous fournit un exemple de script. Vous pouvez supprimer cet exemple et y écrire votre logique de redirection. Soyez descriptif avec le nom ; des noms tels que seo-redirects, domain-migration-redirects ou campaign-router faciliteront la maintenance future.

Dans une logique de redirection de base, une demande est reçue, un objet URL est créé et si une certaine condition est remplie, le Worker redirige vers la nouvelle adresse avec Response.redirect. Le code d'état 301 est utilisé pour des migrations SEO permanentes, tandis que 302 est préféré pour des campagnes temporaires ou des tests. Le code 308 est également utilisé pour des redirections permanentes, mais dans les migrations SEO, le code d'état 301 reste l'option la plus courante et compréhensible.

2. Ajoutez une Règle de Redirection 301 Simple

Le scénario le plus basique consiste à déplacer une ancienne page vers une nouvelle page de façon permanente. La logique est la suivante : si le chemin de la demande est /ancienne-page, alors redirigez l'utilisateur vers /nouvelle-page avec une réponse 301. Dans le Worker, vous vérifiez la valeur de request URL pour effectuer un contrôle de pathname. Ainsi, la redirection ne se produit que si le chemin correspondant est trouvé ; les autres demandes se poursuivent normalement.

Par exemple, si vous êtes passé d'une ancienne structure d'URL de catégorie d'hébergement à une nouvelle structure, vous pouvez déplacer l'URL /pack-hébergement vers /hébergement-web. Cela informe les moteurs de recherche que la page a été déplacée de façon permanente. Dans quelques semaines, Google commencera à relier l'URL nouvellement créée plus clairement ; cependant, il faut éviter de créer une chaîne de redirection et s'assurer que l'ancienne URL va directement à l'URL finale.

3. Définissez le Chemin du Worker

Écrire le code du Worker ne suffit pas, vous devez également spécifier avec le chemin sous quel type de requêtes il fonctionnera. Par exemple, example.com/* couvrira tous les chemins sous le domaine principal. Si vous souhaitez qu'il ne s'applique qu'à un certain sous-répertoire, vous pouvez définir un chemin plus précis comme example.com/ancien-blog/*. Gardez à l'esprit que rendre la portée de path trop large pourrait entraîner des redirections inattendues.

Avant de le mettre en production, il est sage de tester la portée du chemin sur un sous-domaine de staging ou de test. Par exemple, test.example.com/* vous permettra de faire fonctionner la règle et de vérifier les en-têtes ainsi que le comportement de redirection. Si tout semble correct, vous pouvez passer au domaine de production. Cette méthode est particulièrement utile pour éviter les erreurs de redirection en masse lors de projets de migration SEO majeurs.

4. Publiez et Testez le Code d'État HTTP

Une fois le Worker publié, il n'est pas suffisant de vérifier seulement si la page s'ouvre dans le navigateur. Le cache du navigateur peut parfois afficher d'anciens résultats. Au lieu de cela, vérifiez les en-têtes HTTP pour confirmer que le code d'état 301 ou 302 retourne correctement. Assurez-vous également que l'en-tête Location indique bien l'URL finale que vous attendez.

• L'ancienne URL va-t-elle directement vers la nouvelle URL ?
• Le code de redirection est-il 301 ou 302 ?
• Y a-t-il une chaîne supplémentaire lors du passage de HTTP à HTTPS ?
• Les variations www et non-www sont-elles cohérentes ?
• L'utilisation du slash à la fin de l'URL est-elle standardisée ?
• Les utilisateurs mobiles et de bureau voient-ils le même objectif SEO ?

Scénarios de Redirection Courants

Redirection de Page Unique

La redirection de page unique est le point de départ le plus simple et le plus sûr. Elle est utilisée lorsque votre ancienne page de service, page de campagne ou article de blog a été déplacé vers une nouvelle adresse. Ce à quoi il faut faire attention ici, c'est que l'intention de contenu de l'ancienne page soit cohérente avec celle de la nouvelle page. Rediriger un ancien guide SSL directement vers la page d'accueil peut frustrer l'expérience utilisateur et diluer les signaux SEO. Il est plus judicieux de rediriger vers le nouveau guide SSL le plus proche ou vers la page de catégorie.

Redirection avec une Carte URL en Masse

Lors de projets de migration de site, il peut être nécessaire de rediriger des dizaines voire des milliers d'URL. Vous pouvez définir un objet de map dans le Worker pour associer l'ancienne route à la nouvelle route. Par exemple, vous associez /ancien-blog/cloudflare-nedir à /blog/cloudflare-nedir. Cette approche est pratique pour de petites et moyennes listes. Cependant, pour plus de 1000 URL, intégrer une longue liste dans le code peut devenir difficile à gérer. Dans ce cas, il est préférable de lire la carte de redirection via Cloudflare KV, R2 ou une API externe pour avoir une architecture plus professionnelle.

Lorsque vous effectuez une redirection en masse, préparez un tableau dans Excel ou Google Sheets avec trois colonnes : ancienne URL, nouvelle URL et code d'état. Assurez-vous également qu'une même URL ne va pas vers plusieurs cibles, que l'URL finale renvoie le code d'état 200 et qu'elle n'est pas bloquée par robots.txt. L'erreur la plus fréquente dans les migrations SEO est d'envoyer globalement les anciennes URL vers des pages non pertinentes du nouveau site. Bien que cela puisse sembler réduire la perte de crawl à court terme, cela peut affaiblir les signaux de qualité à long terme.

Redirections Basées sur le Pays

Cloudflare vous permet d'utiliser les informations concernant le pays d'origine de la demande. Par exemple, vous pouvez rediriger les utilisateurs venant de la Turquie vers /tr, et ceux venant d'Allemagne vers /de. Toutefois, il est important d'être prudent avec les redirections automatiques basées sur le pays d'un point de vue SEO. Googlebot effectue souvent du crawling à partir de localisations spécifiques, et une mauvaise configuration peut rendre la découverte de versions linguistiques différentes plus difficile. C'est pourquoi les balises hreflang, les liens de sélection de langue et la distinction dans le sitemap doivent être correctement conçues.

Il est généralement plus sûr de faire des redirections basées sur le pays avec le code 302 plutôt que 301. Cela permet de fournir une expérience temporaire selon la localisation de l'utilisateur ; vous ne prétendez pas que la page a été déplacée de manière permanente. De plus, il est important de donner à l'utilisateur la possibilité de changer sa sélection de langue ou de pays pour une meilleure expérience.

Redirection Basée sur l'Appareil ou l'Agent Utilisateur

Rediriger les utilisateurs mobiles vers une autre page était autrefois courant, mais le design responsive est aujourd'hui considéré comme plus sain. Cependant, pour des pages de téléchargements d'applications spécifiques, des flux de campagnes mobiles ou des expériences de landing pages légères, la redirection basée sur l'agent utilisateur peut être utilisée. Là encore, il faut faire preuve de prudence du point de vue SEO. Offrir un contenu totalement différent aux utilisateurs de bureau et mobiles peut créer des signaux incohérents.

Si vous effectuez une redirection basée sur l'appareil, l'intention de contenu de la page montrée à l'utilisateur mobile doit être cohérente avec celle de la page de bureau. N'oubliez pas davantage que Google adopte une approche d'indexation mobile-first. L'expérience mobile étant un des signaux de classement les plus importants, il ne suffit pas d'optimiser uniquement la page de bureau.

Redirection de Campagne Basée sur les Paramètres de Requête

Pour les équipes de marketing digital, les redirections de Worker sont très utiles. Par exemple, vous pouvez diriger les utilisateurs venant avec le paramètre utm_campaign=blackfriday vers une page de campagne spéciale. Cette opération peut être effectuée sur le côté Edge sans nécessiter de développements supplémentaires sur l'application d'origine. Cependant, veillez à ne pas perdre complètement les paramètres UTM. Assurez-vous de les transférer vers la nouvelle URL si nécessaire pour les mesures analytiques ou de suivre correctement sur votre plateforme de campagne.

Choix entre 301, 302, 307 et 308 d'un point de vue SEO

Le choix du code de redirection n'est pas qu'un simple détail technique ; il indique aux moteurs de recherche l'intention de déplacer la page. Le code 301 signifie un déplacement permanent et c'est le code le plus utilisé lors de migrations SEO. Le code 302 est une redirection temporaire, préférée pour des campagnes, des tests ou des flux limités dans le temps. Le code 307 conserve la méthode HTTP lors de la redirection temporaire. Le code 308 est similaire au 301 en tant que redirection permanente, tout en préservant la méthode.

La règle d'or pour le SEO est la suivante : utilisez 301 pour les pages qui ont été déplacées de manière permanente et dont la nouvelle correspondance est claire ; utilisez 302 pour les redirections temporaires, personnalisées ou conditionnelles. Évitez également les chaînes de redirection. Si l'ancienne URL passe d'abord de HTTP à HTTPS, puis de non-www à www, puis à la nouvelle page, cela crée une chaîne à trois étapes. La structure idéale est d'amener l'ancienne URL directement à la nouvelle URL finale HTTPS en une seule étape.

Meilleures Pratiques pour la Performance et la Sécurité

Cloudflare Workers est rapide ; cependant, une logique de redirection mal écrite peut causer des retards et des erreurs. Gardez vos règles simples, n'écrivez pas de regex inutiles et évitez d'accroître des listes volumineuses sans contrôle dans le code. Pour de très grandes listes de redirection, des structures de stockage clé-valeur comme KV sont plus adaptées d'un point de vue performance et maintenance. De plus, assurez-vous que l'URL cible n’est pas la même que l'hôte actuel et le chemin, pour éviter des boucles infinies.

• Déterminez clairement la propriété pour chaque règle : équipe SEO, développement ou marketing.
• Faites une sauvegarde de la carte de redirection avant les modifications.
• Testez sur un domaine de staging avant de publier.
• Avant de publier un 301, assurez-vous que la nouvelle URL est permanente.
• Après chaque publication, vérifiez manuellement 10-20 URL d'exemple.
• Surveillez les rapports 404 et les données de couverture de Google Search Console.
• Ne laissez pas de liens internes vers l'ancienne URL ; mettez-les à jour vers la nouvelle URL.

D'un point de vue sécurité, il faut être vigilant face au risque de redirection ouverte. Utiliser directement les paramètres fournis par l'utilisateur comme next, redirect ou url peut permettre à des attaquants de détourner votre domaine de confiance. Si vous optez pour une redirection basée sur un paramètre, assurez-vous de n'inclure que des domaines autorisés sur liste blanche. Par exemple, seuls vos propres domaines ou des domaines de campagne vérifiés peuvent être des cibles.

La configuration SSL est également un point critique. Lorsque vous utilisez SSL Flexible sur Cloudflare, si l'origine ne dispose pas de HTTPS, cela peut entraîner des boucles de redirection compliquées. La structure la plus fiable est généralement le SSL Full ou Full strict. Pour cela, un certificat SSL valide doit être présent sur votre serveur d'origine. Les solutions SSL de Hostragons peuvent faciliter ce processus : acheter un certificat SSL et sécurité d'hébergement professionnel.

Points à considérer sur l'Infrastructure de Hostragons

Lors de l'utilisation de redirections Cloudflare Workers sur les sites hébergés chez Hostragons, il est essentiel de considérer les trois couches ensemble : DNS de domaine, configuration d'hébergement et redirections d'application. D'abord, il est nécessaire que les enregistrements de serveurs de noms de domaine soient redirigés vers Cloudflare. Ensuite, vos enregistrements DNS doivent pointer vers le serveur d'hébergement Hostragons, et les enregistrements utilisés pour le proxy doivent être activés avec un nuage orange.

Deuxièmement, assurez-vous que le domaine, les domaines additifs ou les alias définis dans votre panneau d'hébergement sont corrects. Même si la redirection se produit sur l'Edge de Cloudflare, certaines demandes continueront à atteindre le serveur d'origine. Il est donc possible que des problèmes d'expérience utilisateur se produisent si le domaine d'origine présente des hôtes virtuels incorrects, un manque de SSL ou une configuration de répertoire racine incorrecte. Les ressources Guide de redirection de domaine et Gestion de l'hébergement cPanel peuvent être utiles pour l'appariement des domaines et de l'hébergement.

Troisièmement, vérifiez les redirections au niveau de l'application. WordPress, Laravel, une application PHP personnalisée ou d'autres CMS peuvent eux-mêmes effectuer des redirections HTTPS, www ou basées sur la langue. Si un Worker Cloudflare exécute une seconde règle sur le même sujet, cela peut entraîner des boucles ou des chaînes. La meilleure approche consiste à centraliser la responsabilité des redirections dans une seule couche. Par exemple, toutes les redirections de domaine et de migration SEO peuvent être gérées par les Workers, tandis que celles concernant les sessions utilisateur dans l'application peuvent être gardées du côté développement.

Test, Surveillance et Débogage

Après la publication de la redirection, le processus de surveillance est presque aussi important que l'installation elle-même. Au cours des premières 24 heures, vérifiez les URL les plus critiques, les pages de destination générant des revenus, les pages les plus visitées en trafic organique et les anciennes URL ayant acquis des backlinks. Surveillez les rapports d'Indexation et d'Expérience de Page dans Google Search Console. Les logs du serveur, les analyses Cloudflare et les données d'analyse examinées ensemble permettent de repérer plus rapidement des redirections erronées.

Les motifs d'erreurs fréquemment observés incluent : l'utilisation accidentelle de 302 au lieu de 301, la redirection de l'ancienne URL vers la page d'accueil au lieu de la nouvelle, des comportements différents pour les variations avec ou sans slash, la sensibilité à la casse, et la perte de paramètres de requête. Cela peut directement affecter le taux de conversion si des pages de prix, produits, catégories, et support dans des sites e-commerce, SaaS ou d'hébergement sont mal orientées.

Après une mise en ligne, appliquez une simple liste de contrôle. D'abord, sélectionnez des exemples aléatoires de l'ancienne liste d'URL. Ensuite, testez chacune d'entre elles avec un outil de vérification d'en-tête. Troisièmement, assurez-vous que la page finale renvoie le code d'état 200. Quatrièmement, vérifiez que le contenu de la page correspond à l'intention de recherche de l'ancienne page. Cinquièmement, vérifiez que les liens internes ont été mis à jour vers les nouvelles URL. Ces cinq étapes permettent de prévenir une grande partie des redirections qui, bien que techniquement valides, pourraient être faibles du point de vue SEO.

Stratégie Exemple : Déplacement des Anciennes Pages d'Hébergement vers la Nouvelle Architecture d'Information

Envisageons un scénario concret. Une société d'hébergement renouvelle sa structure d'URL, passant de pages comme /linux-hosting, /wordpress-hosting-packages, /ssl-security, et /domain-lookup à une structure plus simplifiée. Les nouvelles cibles seraient respectivement /web-hosting, /wordpress-hosting, /ssl-certification, et /domain-search. Dans ce cas, quatre règles 301 clairement définies seraient créées dans le Worker. Par la suite, les menus internes du site, les liens de pied de page, le sitemap et les balises canonical seraient mis à jour vers les nouvelles URL.

Dans cette transition, l'objectif n'est pas seulement de rediriger l'utilisateur vers la bonne page. Il s'agit également de montrer clairement aux moteurs de recherche les nouvelles correspondances des anciennes pages. Si l'ancienne page /linux-hosting redirige vers la page d'accueil, Google peut perdre le contexte de cette page. Tandis que la page /web-hosting est beaucoup plus proche de l'intention de produit. C'est pourquoi une bonne carte de redirection fait plus qu'un simple fichier technique ; c'est une part intégrante de la stratégie SEO.

FAQ

Les redirections faites avec Cloudflare Workers sont-elles sécurisées pour le SEO ?

Oui, elles le sont lorsqu'elles utilisent le bon code d'état et la bonne URL cible. Pour les déplacements de pages permanentes, utilisez 301 ; pour les flux temporaires ou conditionnels, optez pour 302. Évitez également les chaînes de redirection, les boucles et les erreurs d'URL cible non pertinentes.

Un serveur d'origine doit-il être opérationnel pour une redirection avec Worker ?

Si la redirection est complètement gérée par Cloudflare Edge, elle peut répondre sans se rendre au serveur d'origine. Cependant, étant donné que la page finale à rediriger opère sur l'origine ou une autre infrastructure, la configuration de l'hébergement, DNS et SSL doit être correcte.

Est-il préférable d'utiliser Workers plutôt que des Règles de Page Cloudflare ?

Pour quelques redirections simples, les Règles de Page ou Redirect Rules peuvent suffire. Cependant, si des logiques dynamiques basées sur le chemin, le pays, l'appareil, les paramètres, les domaines multiples ou la carte sont nécessaires, les Workers sont une solution plus flexible et évolutive.

Changer une redirection 301 après coup sera-t-il un problème ?

Le 301 étant un signal permanent, il ne doit pas être modifié fréquemment. Les navigateurs et les moteurs de recherche peuvent mettre en cache les résultats 301. C'est pourquoi assurez-vous de la permanence de l'URL cible et de son adéquation avec l'intention de contenu avant de publier un 301.

Peut-on faire des redirections www et non-www avec Cloudflare Workers ?

Oui. En contrôlant la valeur d'hôte, vous pouvez rediriger les adresses non-www vers la version www ou vice versa. Ici, il est essentiel de définir une unique norme, de préparer le certificat SSL pour couvrir les deux variations et de mettre à jour les liens internes selon le même standard.

Conclusion

Créer des redirections serverless avec Cloudflare Workers est une méthode puissante qui offre à la fois performance et flexibilité opérationnelle dans les projets web modernes. Tant que vous choisissez correctement les codes 301 et 302, préparez soigneusement votre carte de redirection, et vérifiez ensemble les couches DNS, SSL et d'hébergement, vous pouvez gérer les transitions SEO de manière plus sécurisée. Pour les petits projets, des règles simples peuvent suffire, tandis que pour de grandes migrations, des tests, une surveillance et une documentation deviennent critiques.

En configurant correctement votre domaine, votre hébergement et votre infrastructure SSL chez Hostragons, vous pouvez établir des redirections Cloudflare Workers sur des bases solides. Si nécessaire, explorez nos pages sur Paquets d'hébergement Web, Vérification de domaine et solutions de certificats SSL pour planifier l'infrastructure adaptée à votre projet.