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…

Aangepaste Domein aan Uw Project Toevoegen

Elk Orbit-project beschikt over een gratis kaps.run adres, en u kunt uw eigen domeinen ernaast koppelen met een SSL-certificaat dat automatisch wordt ingericht. Deze gids behandelt het toevoegen van een domein, de DNS-record die u nodig hebt, hoe u de verificatiestatussen leest, het kiezen van een primair domein en wat u moet controleren wanneer een domein vastloopt.

Voordat u begint

U hebt een Orbit-project met minstens een succesvolle implementatie nodig, een domein waarvan u de DNS controleert, en een abonnement dat aangepaste domeinen bevat. Aangepaste domeinen zijn opgenomen in Liftoff en Apex; het gratis Launch-abonnement bevat ze niet. Zie Orbit Plan Limits.

Stap 1: Voeg het Domein Toe in Orbit

Open uw project in Orbit.
Open het tabblad Domain, of klik op Manage domains vanuit de kaart Custom domains in Settings.
Onder Add a domain typt u de hostnaam, bijvoorbeeld app.example.com.
Klik op Add.

Voer een eenvoudige hostnaam in. Voeg geen https://, slash of pad toe: het formulier wijst alles af wat niet een bare hostnaam is met "Enter a valid hostname like app.example.com".

Domain-tabblad van een Orbit-project

U kunt tot 25 domeinen aan een project toevoegen. De eerste die u toevoegt wordt het primaire domein.

Als het domein al aan een ander Orbit-project is gekoppeld, weigert Orbit het. Verwijder het eerst uit het andere project.

Stap 2: Voeg de DNS-record Toe

Orbit toont een DNS setup-panel met de exacte record die moet worden gemaakt: een CNAME, met de Name en Value die u moet gebruiken. Het doel is hetzelfde voor iedereen die uw DNS host.

Als Uw Domein Kapsule DNS Gebruikt

Klik op Domains in de KPanel-zijbalk.
Klik op uw domein.
Voeg in de DNS-editor een CNAME-record toe met de Name en Value die op het Orbit Domain-tabblad worden weergegeven.

Als Uw Domein Een Ander DNS-provider Gebruikt

Meld u aan bij die provider en voeg dezelfde CNAME-record toe. De interface verschilt, maar het recordtype, de naam en de waarde niet.

Apex-domeinen (example.com zonder subdomein) kunnen geen gewone CNAME onder de DNS-standaard gebruiken. Veel providers bieden CNAME-afvlakking of een ALIAS- of ANAME-record aan die hetzelfde bereikt; gebruik dat als u het hebt. Als u het niet hebt, publiceer dan op een subdomein zoals www.example.com en leid de apex ernaartoe via uw DNS-provider of registrar.

Stap 3: Wacht op Verificatie en SSL

Orbit controleert DNS zelf en het tabblad Domain rapporteert waar het is gebleven:

Wat u ziet	Wat het betekent
Checking DNS…	Een controle wordt nu uitgevoerd
CNAME not detected yet	De record is niet verspreid, of is onjuist
CNAME verified: SSL provisioning…	De record wordt opgelost, het certificaat wordt uitgegeven
SSL active: CNAME verified	Het domein is live en fungeert via HTTPS

Klik op Re-check DNS om een controle af te dwingen in plaats van te wachten op de volgende automatische.

DNS-verspreiding duurt overal van enkele minuten tot enkele uren, afhankelijk van de TTL op uw oude records. Het certificaat wordt uitgegeven binnen een minuut of twee na detectie van de CNAME en vernieuwt automatisch zolang het domein gekoppeld blijft.

Verlaag vóór het toevoegen van de record de TTL op de bestaande record voor die hostnaam en wacht tot de oude TTL verloopt. Overschakelen duurt dan minuten in plaats van uren. Dit is vooral van belang wanneer u een live-hostnaam verplaatst in plaats van een nieuwe toe te voegen.

Het Primaire Domein Kiezen

Met meer dan één domein gekoppeld, wordt een gemarkeerd als Primary. Klik op Set as primary domain op een geverifieerd domein om het te wijzigen. Het primaire is het canonieke adres voor het project; de anderen blijven functioneren.

Een Domein Verwijderen

Klik op Remove domain op de rij.

Het verwijderen van een domein neemt het onmiddellijk uit werking. Bezoekers bereiken uw project niet langer op die hostnaam en het certificaat daarvoor wordt niet meer onderhouden. De DNS-record bij uw provider wordt niet verwijderd: verwijder deze zelf zodra u deze niet meer nodig hebt, anders wijst deze naar een hostnaam die niet meer voor u antwoordt.

Uw project blijft functioneren op zijn kaps.run adres, ongeacht.

SSL Is Automatisch en Gratis

U koopt, uploadt of vernieuwt nooit een certificaat voor een Orbit-domein. Zodra de CNAME wordt opgelost, wordt een certificaat uitgegeven en vervolgens automatisch vernieuwd. Er is geen scherm voor certificaatbeheer omdat er niets te beheren is.

Probleemoplossing

Vastgelopen op "CNAME not detected yet".

Controleer het recordtype. Een A-record dat naar een IP-adres wijst, wordt niet geverifieerd; het moet een CNAME naar de waarde zijn die Orbit u heeft gegeven.
Controleer de recordnaam. Veel DNS-editors voegen de zone voor u toe, dus invoeren van app.example.com kan app.example.com.example.com opleveren. Voer alleen app in als de editor de zone als suffix toont.
Controleer op een conflicterende record. Een bestaande A, AAAA of CNAME met dezelfde naam wint of maakt de zone ongeldig. Verwijder het.
Controleer of u de zone hebt bewerkt die werkelijk gezaghebbend is. Als u recent naamservers hebt verplaatst, bewerkt u mogelijk de kopie van de oude provider.
Wacht tot de TTL van de record die u hebt vervangen.

Geverifieerd, maar het certificaat wordt niet geactiveerd. Een CAA-record op het domein kan de afgifte verhinderen. Verwijder het of voeg een vermelding toe waarmee de certificaatautoriteit die Kapsule gebruikt, wordt toegestaan. Als u niet zeker bent, neem dan contact op met ondersteuning met de domeinnaam.

"This domain is already attached to another project." Precies wat het zegt. Zoek het andere Orbit-project en verwijder het domein daar eerst.

"Domain limit reached." U hebt 25 domeinen op dit project bereikt. Verwijder er een die u niet meer nodig hebt.

Het domein wordt opgelost, maar toont de verkeerde site. Controleer het CNAME-doel karakter voor karakter. Het is gemakkelijk om het domein aan het ene project te koppelen en DNS naar een ander te richten.

Gerelateerd Lezen

What Is Orbit? voor hoe het kaps.run adres werkt
Configuring Redirects and Rewrites voor het sturen van oude paden naar nieuwe zodra het domein live is
Orbit Plan Limits voor welke abonnementen aangepaste domeinen bevatten

Een aangepast domein toevoegen aan uw project