Mode d’intégration : utilisez RedirHub sans modifier votre DNS

Le mode d’intégration connecte un domaine à RedirHub sans modifier son DNS ni ajouter d’enregistrement DNS. Votre site conserve son DNS, son hébergement et son certificat HTTPS. Votre propre plateforme télécharge les règles du domaine depuis RedirHub, sert les redirections, les liens courts et les liens de codes QR que vous gérez dans le tableau de bord, et renvoie chaque visite, afin que le domaine apparaisse dans le même tableau de bord et les mêmes analyses qu’un domaine connecté par DNS.

Il est conçu pour les cas où pointer le DNS vers RedirHub n’est pas une option : le DNS est géré par l’informatique ou un client, le domaine héberge déjà un site en ligne, ou vous চানgez des liens courts et des redirections sur votre domaine principal à côté de vos propres pages.

Fonctionnement#

1. Fichier de règles. RedirHub publie un fichier de règles en texte brut pour chaque domaine connecté de cette façon. Votre plateforme le télécharge environ une fois par minute (Caddy peut aussi recevoir une poussée en une à deux secondes), de sorte qu’une modification dans le tableau de bord est mise en ligne sans redéploiement.
2. Chemin de vérification. Votre plateforme répond à /_redirhub/check sur le domaine. La première réponse correcte prouve que le domaine vous appartient et le connecte ; RedirHub continue de l’appeler pour vérifier si votre plateforme exécute les règles les plus récentes.
3. Redirections. Les règles exactes redirigent avant les propres routes de votre site. Une règle générique ne répond qu’aux URL que votre site renvoie en 404, de sorte qu’une page fonctionnelle n’est jamais prise en charge à la place.
4. Rapports. Chaque redirection est signalée en arrière-plan, sans ralentir le visiteur. Lorsque la plateforme le prend en charge, les 404 renvoyées par votre site sont aussi signalées, afin que les liens cassés apparaissent après une migration.

Si RedirHub ne peut pas être joint, votre plateforme conserve les dernières règles téléchargées et continue d’effectuer les redirections. Les intégrations échouent de manière ouverte : une erreur ne casse jamais une page.

Plateformes prises en charge#

• Cloudflare Workers : un Worker placé devant votre origine. Open source : redirhub/cloudflare-redirects.
• Next.js (sur Vercel ou auto-hébergé avec next start) : s’exécute dans votre proxy ou middleware. Open source : redirhub/nextjs-redirects.
• Caddy : un module Caddy pour vos propres serveurs, avec HTTPS à la demande pour les noms d’hôte de vos règles. Open source : redirhub/caddy-redirects.

Le format du fichier de règles est ouvert, donc n’importe qui peut écrire un client pour une autre plateforme : redirhub/integration-spec.

Configurez-le#

1. Dans le tableau de bord, ajoutez le domaine sous Noms d’hôte et choisissez Se connecter via votre propre plateforme. Aucun enregistrement DNS n’est nécessaire.
2. Choisissez votre plateforme. Le tableau de bord affiche l’adresse des règles et la clé d’intégration de votre espace de travail, ainsi qu’une invite avec les deux déjà renseignés.
3. Collez l’invite dans votre agent de codage IA (Claude, Cursor, ChatGPT et autres) ou suivez manuellement le README de la plateforme. Gardez la clé d’intégration secrète : elle va dans une variable d’environnement ou un secret, jamais dans du code public.
4. Déployez. Le domaine passe à Connecté dès que le chemin de vérification répond.

Connexion DNS ou mode d’intégration ?#

Utilisez la connexion DNS lorsque le domaine ne fait que rediriger (un domaine de réserve, un ancien domaine après une migration) : l’edge de RedirHub le sert et gère l’HTTPS pour vous. Utilisez le mode d’intégration lorsque le domaine exécute déjà un site web que vous souhaitez conserver, ou lorsque vous ne pouvez pas modifier son DNS.

Ce que le mode d’intégration ne fait pas#

• Le certificat HTTPS reste sur votre plateforme ; RedirHub n’en délivre pas pour le domaine.
• Chaque domaine peut contenir jusqu’à 50 000 règles de redirection. Les domaines génériques ne sont pas pris en charge.
• Le HTML personnalisé, les redirections par frame, la protection par mot de passe et les liens suspendus ou expirés ne s’appliquent pas. Un lien avec plusieurs destinations utilise sa destination principale.

Le mode d’intégration est inclus dans Core, Pro et Enterprise. Les redirections diffusées de cette manière sont comptabilisées dans les visites mensuelles du forfait, au même titre que les redirections diffusées via l’edge de RedirHub.