Ajouter un domaine personnalisé à votre projet

Every Orbit project serves on a free kaps.run address, and you can attach your own domains alongside it with an SSL certificate provisioned automatically. This guide covers adding a domain, the DNS…

Chaque projet Orbit est servi sur une adresse kaps.run gratuite, et vous pouvez y attacher vos propres domaines avec un certificat SSL provisionné automatiquement. Ce guide couvre l'ajout d'un domaine, l'enregistrement DNS dont vous avez besoin, comment lire les états de vérification, choisir un domaine primaire, et ce qu'il faut vérifier quand un domaine reste bloqué.

Avant de Commencer

Vous avez besoin d'un projet Orbit avec au moins un déploiement réussi, d'un domaine dont vous contrôlez le DNS, et d'un plan incluant les domaines personnalisés. Les domaines personnalisés sont inclus dans Liftoff et Apex; le plan gratuit Launch ne les inclut pas. Voir Limites du Plan Orbit.

Étape 1 : Ajouter le Domaine dans Orbit

Ouvrez votre projet dans Orbit.
Ouvrez l'onglet Domain, ou cliquez sur Manage domains depuis la carte Custom domains dans Settings.
Sous Add a domain, tapez le nom d'hôte, par exemple app.example.com.
Cliquez sur Add.

Entrez un nom d'hôte brut. N'incluez pas https://, de slash final ou de chemin: le formulaire rejette tout ce qui n'est pas un nom d'hôte brut avec le message « Enter a valid hostname like app.example.com ».

Onglet Domain d'un projet Orbit

Vous pouvez ajouter jusqu'à 25 domaines à un projet. Le premier que vous ajoutez devient le domaine primary.

Si le domaine est déjà attaché à un autre projet Orbit, Orbit le refuse. Supprimez-le d'abord de l'autre projet.

Étape 2 : Ajouter l'Enregistrement DNS

Orbit affiche un panneau DNS setup avec l'enregistrement exact à créer: un CNAME, avec le Name et la Value à utiliser. La cible est la même quel que soit votre hébergeur DNS.

Si Votre Domaine Utilise Kapsule DNS

Cliquez sur Domains dans la barre latérale de KPanel.
Cliquez sur votre domaine.
Dans l'éditeur DNS, ajoutez un enregistrement CNAME en utilisant le Name et la Value affichés sur l'onglet Domain d'Orbit.

Si Votre Domaine Utilise un Autre Fournisseur DNS

Connectez-vous à ce fournisseur et ajoutez le même enregistrement CNAME. L'interface diffère, mais le type d'enregistrement, le nom et la valeur ne changent pas.

Les domaines apex (example.com sans sous-domaine) ne peuvent pas avoir un CNAME brut selon la norme DNS. De nombreux fournisseurs offrent l'aplatissement CNAME ou un enregistrement ALIAS ou ANAME qui réalise la même chose; utilisez celui-ci si le vôtre l'offre. S'il ne l'offre pas, publiez sur un sous-domaine tel que www.example.com et redirigez l'apex vers lui chez votre fournisseur DNS ou votre registraire.

Étape 3 : Attendre la Vérification et SSL

Orbit vérifie le DNS de son côté et l'onglet Domain rapporte où il en est:

Ce que vous voyez	Ce que cela signifie
Checking DNS…	Une vérification est en cours en ce moment
CNAME not detected yet	L'enregistrement n'a pas encore été propagé, ou est incorrect
CNAME verified: SSL provisioning…	L'enregistrement se résout, le certificat est en cours de délivrance
SSL active: CNAME verified	Le domaine est en direct et sert sur HTTPS

Cliquez sur Re-check DNS pour forcer une vérification plutôt que d'attendre la suivante automatique.

La propagation DNS prend n'importe où de quelques minutes à plusieurs heures selon la TTL de vos anciens enregistrements. Le certificat est délivré en une ou deux minutes après la détection du CNAME, et se renouvelle automatiquement tant que le domaine reste attaché.

Avant d'ajouter l'enregistrement, réduisez la TTL de l'enregistrement existant pour ce nom d'hôte et attendez que l'ancienne TTL expire. La transition prend alors quelques minutes plutôt que des heures. Cela importe surtout quand vous migrez un nom d'hôte en direct plutôt que d'en ajouter un nouveau.

Choisir le Domaine Primaire

Avec plus d'un domaine attaché, l'un est marqué Primary. Cliquez sur Set as primary domain sur n'importe quel domaine vérifié pour le changer. Le primaire est l'adresse canonique du projet; les autres continuent à être servis.

Supprimer un Domaine

Cliquez sur Remove domain sur la ligne.

Supprimer un domaine le met hors service immédiatement. Les visiteurs cessent d'atteindre votre projet sur ce nom d'hôte tout de suite, et le certificat pour celui-ci n'est plus maintenu. L'enregistrement DNS chez votre fournisseur n'est pas supprimé: supprimez-le vous-même une fois que vous n'en avez plus besoin, ou il continuera à pointer vers un nom d'hôte qui ne répond plus pour vous.

Votre projet continue à être servi sur son adresse kaps.run indépendamment.

SSL Est Automatique et Gratuit

Vous ne montez jamais, n'uploadez ou ne renouvelez un certificat pour un domaine Orbit. Une fois que le CNAME se résout, un certificat est délivré puis renouvelé automatiquement. Il n'y a pas d'écran de gestion de certificat parce qu'il n'y a rien à gérer.

Dépannage

Bloqué sur « CNAME not detected yet ».

Vérifiez le type d'enregistrement. Un enregistrement A pointant vers une adresse IP ne se vérifie pas; ce doit être un CNAME vers la valeur qu'Orbit vous a donnée.
Vérifiez le nom de l'enregistrement. De nombreux éditeurs DNS ajoutent la zone pour vous, donc entrer app.example.com peut produire app.example.com.example.com. Entrez seulement app si l'éditeur affiche la zone en suffixe.
Vérifiez l'absence d'enregistrement en conflit. Un A, AAAA ou CNAME existant sur le même nom gagnera ou rendra la zone invalide. Supprimez-le.
Vérifiez que vous avez édité la zone qui est réellement autoritaire. Si vous avez récemment changé les serveurs de noms, vous modifiez peut-être la copie de l'ancien fournisseur.
Attendez que la TTL de l'enregistrement que vous avez remplacé expire.

Vérifié, mais le certificat ne s'active pas. Un enregistrement CAA sur le domaine peut empêcher la délivrance. Soit supprimez-le, soit ajoutez une entrée autorisant l'autorité de certification qu'utilise Kapsule. Si vous n'êtes pas sûr, contactez le support avec le nom de domaine.

« This domain is already attached to another project. » Exactement ce que cela dit. Trouvez l'autre projet Orbit et supprimez d'abord le domaine là-bas.

« Domain limit reached. » Vous êtes à 25 domaines sur ce projet. Supprimez-en un que vous n'utilisez plus.

Le domaine se résout mais affiche le mauvais site. Vérifiez la cible CNAME caractère par caractère. Il est facile d'attacher le domaine à un projet et de pointer le DNS vers un autre.

Lectures Connexes

What Is Orbit? pour comprendre comment fonctionne l'adresse kaps.run
Configuring Redirects and Rewrites pour envoyer les anciens chemins aux nouveaux une fois que le domaine est en direct
Orbit Plan Limits pour savoir quels plans incluent les domaines personnalisés