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…

Benutzerdefinierte Domäne zu Ihrem Projekt Hinzufügen

Jedes Orbit-Projekt läuft auf einer kostenlosen kaps.run Adresse, und Sie können Ihre eigenen Domänen daneben hinzufügen, wobei ein SSL-Zertifikat automatisch bereitgestellt wird. Dieser Leitfaden behandelt das Hinzufügen einer Domäne, den DNS-Eintrag, den Sie benötigen, wie Sie die Verifizierungszustände lesen, das Auswählen einer Primärdomäne und was Sie überprüfen sollten, wenn eine Domäne steckenbleibt.

Bevor Sie Beginnen

Sie benötigen ein Orbit-Projekt mit mindestens einer erfolgreichen Bereitstellung, eine Domäne, für die Sie das DNS kontrollieren, und einen Plan, der benutzerdefinierte Domänen enthält. Benutzerdefinierte Domänen sind in Liftoff und Apex enthalten; der kostenlose Launch-Plan enthält sie nicht. Siehe Orbit-Planlimits.

Schritt 1: Domäne in Orbit Hinzufügen

Öffnen Sie Ihr Projekt in Orbit.
Öffnen Sie die Registerkarte Domain, oder klicken Sie auf Manage domains in der Karte Custom domains in Settings.
Unter Add a domain geben Sie den Hostnamen ein, zum Beispiel app.example.com.
Klicken Sie auf Add.

Geben Sie einen einfachen Hostnamen ein. Fügen Sie nicht https://, einen nachgestellten Schrägstrich oder einen Pfad hinzu: das Formular lehnt alles ab, das kein reiner Hostname mit der Meldung "Enter a valid hostname like app.example.com" ist.

Domain-Registerkarte eines Orbit-Projekts

Sie können bis zu 25 Domänen zu einem Projekt hinzufügen. Die erste Domäne, die Sie hinzufügen, wird zur Primärdomäne.

Wenn die Domäne bereits an ein anderes Orbit-Projekt gebunden ist, lehnt Orbit sie ab. Entfernen Sie sie zuerst aus dem anderen Projekt.

Schritt 2: DNS-Eintrag Hinzufügen

Orbit zeigt einen DNS setup-Panel mit dem genauen zu erstellenden Eintrag: einen CNAME mit dem Name und Wert, den Sie verwenden sollten. Das Ziel ist gleich, unabhängig davon, wer Ihr DNS hostet.

Wenn Ihre Domäne Kapsule DNS Verwendet

Klicken Sie auf Domains in der KPanel-Seitenleiste.
Klicken Sie auf Ihre Domäne.
Fügen Sie im DNS-Editor einen CNAME-Eintrag hinzu, indem Sie den Name und Wert verwenden, die auf der Orbit Domain-Registerkarte angezeigt werden.

Wenn Ihre Domäne Einen Anderen DNS-Anbieter Verwendet

Melden Sie sich bei diesem Anbieter an und fügen Sie denselben CNAME-Eintrag hinzu. Die Benutzeroberfläche unterscheidet sich, aber der Eintragstyp, der Name und der Wert nicht.

Apex-Domänen (example.com ohne Subdomain) können nach dem DNS-Standard keinen einfachen CNAME annehmen. Viele Anbieter bieten CNAME-Flattening oder einen ALIAS- oder ANAME-Eintrag, der dasselbe erreicht; verwenden Sie das, falls Ihres es hat. Falls nicht, veröffentlichen Sie auf einer Subdomain wie www.example.com und leiten Sie die Apex bei Ihrem DNS-Anbieter oder Registrar um.

Schritt 3: Auf Verifizierung und SSL Warten

Orbit überprüft DNS eigenständig, und die Domain-Registerkarte zeigt, wo es angekommen ist:

Was Sie sehen	Was es bedeutet
Checking DNS…	Eine Überprüfung läuft gerade
CNAME not detected yet	Der Eintrag hat sich noch nicht verbreitet, oder er ist falsch
CNAME verified: SSL provisioning…	Der Eintrag wird aufgelöst, das Zertifikat wird ausgestellt
SSL active: CNAME verified	Die Domäne ist live und wird über HTTPS bedient

Klicken Sie auf Re-check DNS, um eine Überprüfung zu erzwingen, anstatt auf die nächste automatische zu warten.

Die DNS-Verbreitung kann je nach TTL Ihrer alten Einträge von einigen Minuten bis zu mehreren Stunden dauern. Das Zertifikat wird innerhalb einer oder zwei Minuten nach der Erkennung des CNAME ausgestellt und erneuert sich automatisch, solange die Domäne verbunden bleibt.

Bevor Sie den Eintrag hinzufügen, senken Sie die TTL für den bestehenden Eintrag für diesen Hostnamen und warten Sie, bis die alte TTL abläuft. Der Wechsel dauert dann Minuten statt Stunden. Dies ist besonders wichtig, wenn Sie einen live-Hostnamen verschieben, anstatt einen neuen hinzuzufügen.

Auswahl der Primärdomäne

Bei mehr als einer angebundenen Domäne ist eine als Primary gekennzeichnet. Klicken Sie auf Set as primary domain auf einer verifizerten Domäne, um sie zu ändern. Die Primärdomäne ist die kanonische Adresse für das Projekt; die anderen continue zu bedienen.

Entfernung einer Domäne

Klicken Sie auf der Zeile auf Remove domain.

Das Entfernen einer Domäne nimmt sie sofort aus dem Betrieb. Besucher erreichen Ihr Projekt auf diesem Hostnamen nicht mehr, und das Zertifikat dafür wird nicht länger gepflegt. Der DNS-Eintrag bei Ihrem Anbieter wird nicht entfernt: löschen Sie ihn selbst, sobald Sie ihn nicht mehr benötigen, oder er wird weiterhin auf einen Hostnamen zeigen, der nicht mehr für Sie antwortet.

Ihr Projekt dient weiterhin auf seiner kaps.run Adresse, unabhängig davon.

SSL ist Automatisch und Kostenlos

Sie kaufen, laden oder erneuern niemals ein Zertifikat für eine Orbit-Domäne. Sobald der CNAME aufgelöst wird, wird ein Zertifikat ausgestellt und dann automatisch erneuert. Es gibt keinen Zertifikatverwaltungsbildschirm, da es nichts zu verwalten gibt.

Troubleshooting

Steckengeblieben auf "CNAME not detected yet".

Überprüfen Sie den Eintragstyp. Ein A-Eintrag, der auf eine IP-Adresse zeigt, wird nicht verifiziert; es muss ein CNAME zu dem Wert sein, den Orbit Ihnen gab.
Überprüfen Sie den Eintragsname. Viele DNS-Editoren hängen die Zone für Sie an, sodass die Eingabe von app.example.com zu app.example.com.example.com führen kann. Geben Sie nur app ein, wenn der Editor die Zone als Suffix anzeigt.
Überprüfen Sie auf einen konfliktierenden Eintrag. Ein bestehender A-, AAAA- oder CNAME-Eintrag mit demselben Namen gewinnt oder macht die Zone ungültig. Entfernen Sie ihn.
Überprüfen Sie, dass Sie die Zone bearbeitet haben, die tatsächlich autoritativ ist. Wenn Sie kürzlich Nameserver verschieben, bearbeiten Sie möglicherweise die Kopie des alten Anbieters.
Warten Sie die TTL des Eintrags ab, den Sie ersetzt haben.

Verifiziert, aber das Zertifikat wird nicht aktiviert. Ein CAA-Eintrag auf der Domäne kann die Ausstellung verhindern. Entfernen Sie ihn entweder oder fügen Sie einen Eintrag hinzu, der die von Kapsule verwendete Zertifizierungsstelle zulässt. Falls Sie sich nicht sicher sind, kontaktieren Sie den Support mit dem Domainnamen.

"This domain is already attached to another project." Genau das, was es sagt. Finden Sie das andere Orbit-Projekt und entfernen Sie die Domäne zuerst dort.

"Domain limit reached." Sie haben 25 Domänen auf diesem Projekt erreicht. Entfernen Sie eine, die Sie nicht länger benötigen.

Die Domäne wird aufgelöst, zeigt aber die falsche Website. Überprüfen Sie das CNAME-Ziel Zeichen für Zeichen. Es ist leicht, die Domäne an ein Projekt zu binden und das DNS auf ein anderes zu zeigen.

Weiterführende Ressourcen

What Is Orbit? zur Funktionsweise der kaps.run Adresse
Configuring Redirects and Rewrites zum Weiterleiten alter Pfade zu neuen, sobald die Domäne live ist
Orbit Plan Limits für Informationen, welche Pläne benutzerdefinierte Domänen enthalten

Ein benutzerdefinierten Domäne zu Ihrem Projekt hinzufügen