Utilisez cette page lorsqu’un domaine connecté via votre propre plateforme (mode d’intégration) ne se connecte pas, cesse de se synchroniser ou qu’une redirection ne se déclenche pas. Ouvrez d’abord le domaine sous Hôtes : son état et le résultat de la dernière vérification vous indiquent par où commencer.
État : En attente#
En attente signifie que RedirHub n’a pas encore reçu de réponse correcte du chemin de vérification sur votre domaine. Ouvrez https://your-domain/_redirhub/check dans un navigateur. Il doit renvoyer une courte ligne de texte brut commençant par token=.
- 404 ou votre propre page : l’intégration ne s’exécute pas encore sur cet hôte. Vérifiez qu’elle est déployée, qu’elle s’exécute sur cet hôte exact (www et le domaine racine sont séparés), et que vos routes laissent passer
/_redirhub/check. - Next.js : le middleware ou le proxy matcher doit inclure
/_redirhub/check. - Cloudflare Workers : la route du Worker doit couvrir l’hôte, par exemple
shop.example.com/*. - Un token différent : l’intégration utilise l’adresse des règles d’un autre domaine ou espace de travail. Copiez de nouveau l’adresse des règles depuis le tableau de bord.
- Rien du tout (délai d’attente, page d’erreur) : l’intégration n’a pas encore téléchargé son premier fichier de règles. Tant qu’elle n’en a pas un, elle ne répond pas au chemin de vérification. Vérifiez l’adresse des règles dans ses paramètres.
État : Synchronisation arrêtée#
Synchronisation arrêtée signifie que votre plateforme répond au chemin de vérification mais n’exécute plus les règles les plus récentes : ses règles sont plus anciennes que celles publiées par RedirHub. RedirHub vous envoie également un e-mail lorsque cela se produit.
- Vérifiez que l’intégration peut toujours atteindre l’adresse des règles (un pare-feu, une variable d’environnement modifiée ou un déploiement expiré en sont généralement les causes).
- Redéployez ou redémarrez l’intégration après avoir modifié ses paramètres.
Si un domaine reste désynchronisé pendant 7 jours, RedirHub le désactive. Corrigez l’intégration et le domaine se reconnecte lors de la prochaine vérification.
Une redirection ne se déclenche pas#
- Attendez une minute. L’intégration télécharge de nouvelles règles environ une fois par minute (Caddy peut se mettre à jour en quelques secondes).
- Testez dans une fenêtre privée ou avec curl -I. Les navigateurs mémorisent les redirections 301, donc votre propre navigateur peut afficher l’ancien résultat.
- Votre site répond en premier. Une règle générique ne s’applique qu’aux URL que votre site renvoie en 404. Si la page existe, votre site l’emporte. Utilisez plutôt une règle exacte pour ce chemin.
- Next.js : appelez d’abord les redirections dans votre proxy, avant les réécritures et la gestion de la langue. Un sélecteur qui ignore tous les chemins contenant un point ignore aussi des règles comme
/old.html. Les redirections dans next.config s’exécutent avant le proxy et peuvent masquer vos règles. Next.js ne sert pas les règles génériques, car le proxy ne voit jamais le statut final de votre site. - Non appliqué en mode intégration : HTML personnalisé, redirections dans une frame, protection par mot de passe, liens en pause ou expirés et domaines génériques. Un lien avec plusieurs destinations utilise sa destination principale.
Les visites ou les 404 n’apparaissent pas dans les statistiques#
- Les rapports sont envoyés avec la clé d’intégration de votre espace de travail. Vérifiez que la clé est définie dans l’intégration (en tant que secret ou variable d’environnement) et qu’il s’agit bien de la clé actuelle.
- Les rapports 404 ne sont envoyés que lorsque le signalement des 404 est activé pour le domaine (c’est le cas par défaut) et que la plateforme le prend en charge.
- Les rapports sont envoyés en arrière-plan par petits lots, alors attendez une minute ou deux avant de vérifier.
Toujours bloqué ?#
Envoyez-nous le domaine, votre plateforme et ce que renvoie https://your-domain/_redirhub/check. Nous vérifierons l’intégration de notre côté.
Questions fréquemment posées
RedirHub n’a pas encore reçu de réponse correcte du chemin de contrôle sur votre domaine. En général, l’intégration n’est pas encore déployée, ou elle ne s’exécute pas sur cet hôte ou sur /_redirhub/check.
L’intégration télécharge les règles environ une fois par minute (Caddy peut se mettre à jour en quelques secondes). Les navigateurs mémorisent aussi les redirections 301 : testez dans une fenêtre privée ou avec curl -I.
Un matcher de middleware courant ignore tous les chemins contenant un point, donc des règles comme /old.html n’atteignent jamais le proxy. Les redirections dans next.config s’exécutent aussi en premier et peuvent masquer vos règles.