AssistanceSelf-Hosted TLS

Configurer le TLS auto-hébergé : nos certificats sur vos propres serveurs

Réponse directe

Commencez un essai Pro avec l’option complémentaire Self-Hosted TLS, ou ajoutez-la à Pro. Ajoutez ensuite votre domaine comme « HTTPS uniquement, sur mes propres serveurs », lancez le conteneur issu de sa configuration sur chaque serveur, puis pointez vers eux les enregistrements A ou AAAA du domaine. RedirHub émet le certificat dès que vos serveurs répondent pour le domaine, puis le renouvelle à partir de ce moment-là.

Avec Self-Hosted TLS, le HTTPS pour 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, afin que vous n’ayez aucun client ACME ni tâche de renouvellement à gérer. Les requêtes des visiteurs vont directement vers vos serveurs et ne passent jamais par RedirHub.

Un domaine dans ce mode est en HTTPS uniquement : RedirHub n’y sert ni redirections ni liens courts.

Avant de commencer#

  • Un serveur avec Docker, accessible depuis internet sur le port 443. Le port 80 reste utilisé par 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 l’espace de travail.

Étape 1 : Obtenir l’option complémentaire Self-Hosted TLS#

Self-Hosted TLS est une option complémentaire de Pro, à 100 $/mois pour jusqu’à 100 serveurs. Sur Enterprise, le contrat le définit.

  • Nouveau chez RedirHub : commencez un essai Pro avec TLS auto-hébergé. C’est gratuit pendant 14 jours. Une carte est nécessaire pour démarrer, et rien n’est facturé avant la fin de l’essai.
  • Déjà sur un essai Pro : ajoutez l’option à votre forfait dans le tableau de bord. Votre essai continue de fonctionner, l’option est gratuite jusqu’à son terme, puis elle est facturée avec Pro.
  • Sur Pro payant : ajoutez-la à votre forfait dans le tableau de bord. Les boîtes de dialogue Ajouter un domaine et Connecter la proposent aussi, avec son prix, lorsque votre espace de travail ne l’a pas encore.

Étape 2 : Ajouter le domaine#

  1. Allez dans Hôtes et cliquez sur Ajouter un domaine.
  2. Saisissez le domaine ou le sous-domaine, par exemple app.example.com.
  3. Sous « À quoi allez-vous l’utiliser ? », choisissez « Uniquement HTTPS, sur mes propres serveurs », puis cliquez sur « Ajouter et configurer les serveurs ». Sa configuration s’ouvre ensuite.

Pour un domaine que vous avez déjà ajouté, ouvrez Connecter et choisissez « Utiliser mes propres serveurs » sous les autres façons de se connecter. Via l’API ou le serveur MCP, créez le domaine avec connection_mode défini sur self_hosted. Avec le provider Terraform (redirhub/redirhub 0.2.0 ou ultérieur), définissez connection_mode sur redirhub_domain ; le modifier ensuite bascule le domaine en place :

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

# Attend que vos serveurs y répondent ; son certificat suit.
resource "redirhub_domain_verification" "shop" {
  host = redirhub_domain.shop.host
}

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

La configuration affiche la commande avec le jeton de votre espace de travail déjà renseigné. Copiez-la 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 workspace 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 auparavant. Exécutez la même commande, avec le même jeton, sur chaque serveur ; chacun apparaîtra sous « Vos serveurs » une fois son conteneur démarré. Conservez le volume lors de la mise à jour de l’image : il contient l’identité du serveur et les certificats.

Paramètres que le conteneur lit, sous la forme -e NOM=valeur. Seul le jeton est requis.
SettingDefaultCe que cela fait
REDIRHUB_TOKENAucun (requis)Le jeton de votre espace de travail. Il permet au serveur de récupérer les certificats de votre espace de travail, et rien d’autre, et de valider chacun de vos domaines.
UPSTREAMhttp://127.0.0.1:80Où votre application écoute. Pour une application sur un autre port, ajoutez -e UPSTREAM=http://127.0.0.1:8080.
HTTPS_PORT443Le port que le conteneur utilise pour HTTPS. Modifiez-le uniquement derrière un équilibreur de charge qui transmet le port 443 vers ce port : Let’s Encrypt et nos vérifications atteignent vos domaines sur le port 443.
HTTP_PORToffUn port pour HTTP en clair. Désactivé, il laisse le port 80 à votre application.
HTTP_MODEredirectCe que HTTP en clair sur HTTP_PORT reçoit : redirect le redirige vers HTTPS, proxy le transmet à votre application.

Étape 4 : Dirigez le DNS vers vos serveurs#

  • Chez votre fournisseur DNS, définissez les enregistrements A (et AAAA) du domaine sur les adresses de vos serveurs.
  • Dirigez aussi www vers les mêmes serveurs, et son certificat couvre également www.
  • Pour un wildcard comme *.example.com, ajoutez aussi l’enregistrement CNAME indiqué par la configuration. Il prouve que le wildcard vous appartient et nous permet d’émettre son certificat.

Nous vérifions ensuite vos serveurs. Leur première réponse sur /.well-known/host-verification via HTTPS prouve que le domaine vous appartient ; le conteneur y répond lui-même. Nous émettons le certificat et le synchronisons vers chaque serveur, et la configuration montre que vos serveurs servent HTTPS avec celui-ci. Les renouvellements leur parviennent automatiquement.

Si la configuration présente un problème#

MessageCe que cela signifieFix
Impossible d’atteindre 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 est en cours d’exécution et que votre pare-feu autorise le port 443.
Le port 443 a répondu, mais pas avec le jeton de cet espace de travailQuelque chose d’autre 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, puis démarrez le conteneur avec le jeton affiché par la configuration.
Nous ne voyons pas encore l’enregistrement CNAMEL’enregistrement CNAME du caractère générique est manquant ou n’a pas encore propagé.Ajoutez l’enregistrement exactement comme indiqué. Les changements DNS peuvent prendre quelques minutes à apparaître.
Votre espace de travail n’inclut plus ses propres serveursL’extension a été supprimée du plan.Ajoutez à nouveau Self-Hosted TLS à votre plan dans un délai d’une semaine ; après cela, 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 conservent l’ancien jeton cessent de recevoir des certificats. Supprimez de « Vos serveurs » un serveur que vous n’utilisez plus.

Essayez Self-Hosted TLS gratuitement Commencez Pro avec Self-Hosted TLS : gratuit pendant 14 jours, jusqu’à 100 serveurs, certificats émis et renouvelés pour vous.

Commencer un essai gratuit

Questions fréquemment posées

Non. Le TLS se termine dans le conteneur sur votre serveur, qui transmet chaque requête à votre application. RedirHub ne fait qu’émettre et renouveler les certificats et maintenir tous les serveurs synchronisés.

Oui. Laissez-le servir le HTTP en clair sur le port 80 et réservez 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 cette option ou l’ajoutez pendant l’essai. C’est gratuit jusqu’à la fin de l’essai, puis facturé 100 $/mois avec Pro.

Vos serveurs continuent à servir HTTPS avec les certificats qu’ils ont déjà. Les certificats sont renouvelés bien avant leur expiration, donc une courte interruption ne peut pas en laisser expirer un.

Jusqu’à 100 serveurs par espace de travail, dans n’importe quelle région ou cloud. Au-delà, contactez-nous pour Enterprise ; la tarification est définie par contrat.