AssistanceSelf-Hosted Edge

Configurer Self-Hosted Edge : HTTPS et redirections sur vos propres serveurs

Réponse directe

Démarrez un essai de Pro avec le module complémentaire Self-Hosted Edge, ou ajoutez-le à Pro. Ajoutez votre domaine en tant que « HTTPS pour mon propre site », exécutez le conteneur depuis sa configuration sur chaque serveur et pointez les enregistrements A ou AAAA du domaine vers eux. RedirHub émet le certificat dès que vos serveurs répondent, le renouvelle ensuite et vous prévient par e-mail si vos serveurs cessent de répondre. Les liens que vous ajoutez au domaine redirigent eux aussi sur vos serveurs.

Avec Self-Hosted Edge, le HTTPS de vos domaines se termine sur vos propres serveurs, dans un conteneur placé devant votre application. RedirHub émet le certificat de chaque domaine, le renouvelle et le synchronise sur chaque serveur : vous n’exécutez aucun client ACME ni tâche de renouvellement. Les visiteurs vont directement sur vos serveurs et ne passent jamais par RedirHub.

Le même conteneur sert chaque lien que vous ajoutez au domaine, comme le fait le réseau de RedirHub : redirections, liens courts, codes QR, pages HTML personnalisées et liens protégés par mot de passe. Un lien sur un chemin redirige avant que votre application ne réponde, une règle fourre-tout ne reprend que les 404 de votre application, et visites et 404 apparaissent dans Analytics. Juste le HTTPS ? N’ajoutez aucun lien, et chaque requête va à votre application.

Avant de commencer#

  • Un serveur avec Docker, joignable depuis Internet sur le port 443. Le port 80 reste à votre application.
  • Votre application, ou un proxy comme Caddy ou nginx, qui répond en HTTP simple sur le port 80 du serveur. Un autre port fonctionne aussi, avec un seul réglage.
  • Le rôle de gestionnaire dans votre espace de travail : seuls les gestionnaires voient la commande avec le jeton de serveur de l’espace de travail.

Étape 1 : Obtenir le module complémentaire Self-Hosted Edge#

Self-Hosted Edge est un module complémentaire de Pro, à $100/mois pour jusqu’à 100 serveurs. Sur Enterprise, c’est le contrat qui le fixe.

  • Nouveau sur RedirHub : démarrez un essai de Pro avec Self-Hosted Edge. Il est gratuit pendant 14 jours. Une carte est nécessaire pour commencer, et rien n’est facturé avant la fin de l’essai.
  • Déjà en essai de Pro : ajoutez le module complémentaire à votre forfait dans le tableau de bord. Votre essai continue, le module est gratuit jusqu’à sa fin, puis il est facturé avec Pro.
  • Sur Pro payant : ajoutez-le à votre forfait dans le tableau de bord. Les fenêtres Ajouter un domaine et Connecter le proposent aussi, avec son prix, quand votre espace de travail ne l’a pas encore.

Étape 2 : Ajouter le domaine#

  1. Allez dans Noms d'hôtes et cliquez sur Ajouter un domaine.
  2. Saisissez le domaine ou le sous-domaine, par exemple app.example.com.
  3. Sous « À quoi va-t-il servir ? », choisissez « HTTPS pour mon propre site », puis cliquez sur « Ajouter et configurer les serveurs ». Sa configuration s’ouvre ensuite.

Pour un domaine déjà ajouté, ouvrez Connecter et choisissez « Utiliser mes propres serveurs » sous « Sur mes propres serveurs ». Via l’API ou le serveur MCP, créez le domaine avec connection_mode défini sur self_hosted. Avec le fournisseur Terraform (redirhub/redirhub 0.2.0 ou ultérieur), définissez connection_mode sur redirhub_domain ; le modifier plus tard bascule le domaine sur place :

hclresource "redirhub_domain" "shop" {
  host            = "shop.example.com"
  connection_mode = "self_hosted"
}

# Waits until your servers answer for it; its certificate follows.
resource "redirhub_domain_verification" "shop" {
  host = redirhub_domain.shop.host
}

Étape 3 : Exécuter le conteneur sur chaque serveur#

Sous « Ce que font vos serveurs », la configuration liste ce que fait le conteneur et génère la commande correspondante : les liens de votre domaine, les rapports de 404 de votre application, le port 80 renvoyé vers HTTPS et le port sur lequel écoute votre application. Copiez la commande, avec votre jeton de serveur déjà renseigné, et exécutez-la sur chaque serveur :

bashdocker run -d --name redirhub-edge --restart unless-stopped --network host \
  -v redirhub-edge:/data \
  -e REDIRHUB_TOKEN=<your server token> \
  redirhub/edge

Le conteneur prend le port 443 et transmet chaque requête à votre application sur le port 80, qui continue de servir comme avant. Exécutez la même commande, avec le même jeton, sur chaque serveur ; chacun apparaît sous « Vos serveurs » dès que son conteneur démarre. Conservez le volume quand vous mettez l’image à jour : il contient l’identité du serveur, ses certificats et la dernière copie de vos liens.

Réglages que lit le conteneur, sous la forme -e NAME=value. Seul le jeton est obligatoire.
RéglagePar défautCe qu’il fait
REDIRHUB_TOKENAucun (obligatoire)Le jeton de serveur de votre espace de travail. Il permet au serveur de récupérer les certificats et les liens de votre espace de travail, et rien d’autre, et de prouver chacun de vos domaines.
UPSTREAMhttp://127.0.0.1:80L’adresse où écoute votre application. Pour une application sur un autre port : -e UPSTREAM=http://127.0.0.1:8080.
PORT_HTTPS443Le port que prend le conteneur pour HTTPS. Ne le changez que derrière un répartiteur de charge TCP qui transmet le port 443 à ce port : Let’s Encrypt et nos vérifications joignent vos domaines sur le 443.
PORT_HTTPoffUn port pour le HTTP simple, par ex. 80. off laisse le port 80 à votre application.
ALWAYS_HTTPSonCe que reçoit le HTTP simple sur PORT_HTTP : on le renvoie vers HTTPS (301), off le sert comme HTTPS (vos liens, puis votre application).
LINKSonoff ne sert aucun lien sur ces serveurs : HTTPS uniquement, chaque requête va à votre application.
REPORT_404onoff ne signale aucun des 404 de votre application depuis ces serveurs.
PORT_HEALTHoffUn port pour le contrôle de santé d’un répartiteur de charge : GET /ready répond 200 dès que le serveur détient vos certificats.
PROXY_PROTOCOLoffDerrière un répartiteur de charge TCP qui envoie le protocole PROXY : ses adresses ou plages, par ex. 10.0.0.0/8, pour que votre application voie l’adresse du visiteur.

Pour changer la façon dont les requêtes atteignent votre application, montez vos propres fichiers dans /etc/edge/ : proxy.conf remplace les réglages de proxy générés, et les fichiers de http.d/ et server.d/ sont ajoutés au bloc http et aux serveurs de vos domaines (par exemple un upstream avec plusieurs serveurs d’application, ou un en-tête HSTS). Le conteneur les vérifie avant de démarrer et indique la ligne qui ne se charge pas.

Étape 4 : Pointer le DNS vers vos serveurs#

  • Chez votre fournisseur DNS, définissez les enregistrements A (et AAAA) du domaine sur les adresses de vos serveurs.
  • Pointez aussi www vers les mêmes serveurs, et son certificat couvrira également www.
  • Pour un wildcard comme *.example.com, ajoutez aussi l’enregistrement CNAME qu’affiche la configuration. Il prouve que le wildcard vous appartient et nous permet d’émettre son certificat. Les wildcards reçoivent uniquement des certificats, pas de liens.

Nous vérifions ensuite vos serveurs. Leur réponse sur /.well-known/host-verification en HTTPS prouve que le domaine vous appartient ; le conteneur y répond tout seul. Nous émettons le certificat et le synchronisons sur chaque serveur, et la configuration montre que vos serveurs servent HTTPS avec lui. Les renouvellements et les modifications de liens leur parviennent tout seuls, en quelques secondes.

Redirections et 404 sur vos serveurs#

  • Un lien sur un chemin redirige avant votre application, même quand la page existe. Ajoutez-en un dans RedirHub pour retirer une page ou la déplacer sans nouvelle version de votre application.
  • Une règle fourre-tout ne reprend que les 404 de votre application : une page qui fonctionne n’est jamais remplacée, et une page que votre application n’a plus va là où l’indique la règle fourre-tout.
  • Les 404 de votre application sont signalés et apparaissent dans Analytics, avec les visites de vos liens. Désactivez les rapports de 404 du domaine dans RedirHub, ou avec REPORT_404=off sur les serveurs.
  • Tous les types de liens fonctionnent sur vos serveurs : le conteneur exécute le même redirecteur que le réseau de RedirHub, donc les pages HTML personnalisées, les redirections en frame et les liens protégés par mot de passe se comportent exactement comme sur le DNS de RedirHub. Un lien que vous ajoutez, modifiez ou mettez en pause atteint chaque serveur en quelques secondes.

Si RedirHub est injoignable, vos serveurs continuent de servir avec les certificats et les liens qu’ils ont.

Surveillance#

Nous vérifions régulièrement chaque domaine sur vos serveurs et envoyons un e-mail aux propriétaires et gestionnaires de l’espace de travail quand quelque chose demande votre attention :

  • Vos serveurs ne répondent plus : un e-mail quand aucun de vos serveurs n’a répondu pour un domaine pendant une heure, avec la liste de tous les domaines concernés. S’ils restent muets pendant 7 jours, le domaine est libéré et vous recevez un dernier e-mail ; redémarrez le conteneur et il se reconnecte tout seul.
  • Un certificat ne peut pas être renouvelé : le renouvellement commence des semaines avant l’expiration et réessaie de lui-même. Si Let’s Encrypt ne peut toujours pas joindre le conteneur sur le port 443 quand il reste 14 jours au certificat, nous vous envoyons un e-mail, au plus une fois par jour, avec sa date d’expiration.

Ce sont les e-mails d’état des domaines : désactivez-les dans Préférences e-mail.

Si la configuration signale un problème#

MessageCe que cela signifieSolution
Impossible de joindre le port 443Le domaine n’atteint pas un conteneur en cours d’exécution sur le port 443.Vérifiez que ses enregistrements A ou AAAA pointent vers vos serveurs, que le conteneur tourne (docker ps) et que votre pare-feu autorise le port 443.
Le port 443 a répondu, mais pas avec le jeton de cet espace de travailAutre chose répond sur le port 443, ou le conteneur a été démarré avec un autre jeton.Arrêtez l’autre serveur HTTPS ou déplacez-le sur le port 80 derrière le conteneur, et démarrez le conteneur avec le jeton qu’affiche la configuration.
Nous ne voyons pas encore l’enregistrement CNAMEL’enregistrement CNAME du wildcard manque ou ne s’est pas encore propagé.Ajoutez l’enregistrement exactement comme indiqué. Les changements DNS peuvent mettre quelques minutes à apparaître.
Votre espace de travail n’inclut plus ses propres serveursLe module complémentaire a été retiré du forfait.Rajoutez Self-Hosted Edge à votre forfait dans la semaine ; passé ce délai, le domaine est libéré.

Remplacer le jeton#

Si le jeton a fuité, cliquez sur Remplacer le jeton dans la configuration du domaine, puis redémarrez le conteneur avec le nouveau jeton sur chaque serveur. Les serveurs qui gardent l’ancien jeton cessent de recevoir les certificats et les modifications de liens. Retirez de « Vos serveurs » un serveur que vous n’utilisez plus.

Essayez Self-Hosted Edge gratuitement Démarrez Pro avec Self-Hosted Edge : gratuit pendant 14 jours, jusqu’à 100 serveurs, des certificats émis et renouvelés pour vous, et vos liens servis sur vos serveurs.

Commencer l’essai gratuit

Questions fréquemment posées

Non. Le TLS se termine dans le conteneur sur votre serveur, qui répond à vos liens et transmet toutes les autres requêtes à votre application. RedirHub émet et renouvelle les certificats, les synchronise avec vos liens sur chaque serveur et reçoit les décomptes de visites et de 404.

Oui. Laissez-le servir le HTTP simple sur le port 80 et laissez le port 443 au conteneur, qui lui transmet chaque requête. Désactivez ses propres certificats et sa redirection HTTP vers HTTPS pour ces domaines.

Oui, si vous démarrez l’essai avec lui ou l’ajoutez pendant l’essai. Il est gratuit jusqu’à la fin de l’essai, puis facturé $100/mois avec Pro.

Vos serveurs continuent de servir HTTPS et vos liens avec ce qu’ils ont déjà. Les certificats sont renouvelés bien avant leur expiration, donc une courte panne n’en laisse jamais expirer un.

Oui. N’ajoutez aucun lien au domaine, ou démarrez le conteneur avec -e LINKS=off, et chaque requête va à votre application. Désactivez les rapports de 404 avec -e REPORT_404=off.

Jusqu’à 100 serveurs par espace de travail, dans n’importe quelle région ou cloud. Au-delà, parlez-nous d’Enterprise ; le tarif est fixé par contrat.