Eigene Domain hinzufügen

Binden Sie Ihre eigene Domain an eine ausgerollte App. Das TLS-Zertifikat wird für Sie ausgestellt und erneuert. Sie kümmern sich nur um DNS.

Voraussetzungen

• Eine ausgerollte App (für den ersten Deploy siehe Next.js-App ausrollen)
• Eine Domain, die Sie kontrollieren, mit Zugang zu Registrar bzw. DNS
• Die Console oder ein verbundener Agent (beide Wege funktionieren)

1. Hostnamen wählen.

   Apex-Domain (example.com) oder Subdomain (app.example.com). Beides funktioniert, und beide nutzen Eintragstypen, die jeder Registrar unterstützt.

2. Domain an Ihre App binden.

   In der Console

   Project > Settings > Domains > Add domain. Wählen Sie die App, fügen Sie den Hostnamen ein und klicken Sie auf Add. Die Seite zeigt das DNS-Ziel, auf das Sie im nächsten Schritt verweisen.

   Über Ihren Agenten

   Füg example.com zu meiner App widget auf nyxory hinzu

   Ihr Agent ermittelt Ihr Projekt (über nyx_project_list / nyx_app_list), ruft nyx_domain mit action: add, dem Hostnamen, der App und dem Projekt auf und meldet das DNS-Ziel zurück.

   Mit der CLI

   nyx domain add example.com --app widget

3. DNS auf das zurückgegebene Ziel richten.

   Die Antwort nennt Ihnen das genaue Ziel.

   • Subdomain: Legen Sie einen CNAME-Eintrag von Ihrem Hostnamen auf das Ziel an, das die Plattform veröffentlicht.
   • Apex (example.com): Legen Sie einen A-Eintrag an, der auf die IP aus der Antwort zeigt. Jeder Registrar unterstützt A-Einträge, ein Umweg über ALIAS/ANAME ist nicht nötig.

4. Auf das Zertifikat warten.

   nyx domain status example.com --watch

   Oder laden Sie die Domains-Einstellungen des Projekts neu. Die erste Ausstellung dauert üblicherweise 2–5 Minuten. Danach erneuert sich das Zertifikat automatisch, Sie müssen es nicht mehr anfassen.

5. Prüfen.

   curl -I https://example.com

   Erwartet sind 200 OK und ein gültiges Zertifikat von Let’s Encrypt.

Domains auflisten und entfernen

nyx domain list                       # all your bound domains
nyx domain list --app widget          # just one app
nyx domain remove example.com         # detach: removes the route and the certificate

Fehlerbehebung

Achtung:

• DNS noch nicht verteilt. Führen Sie dig example.com aus und prüfen Sie, ob der Name auf das Ziel aus der Antwort auflöst. Erscheint es noch nicht, hat Ihr Registrar die Änderung noch nicht verteilt. Warten Sie 60 Sekunden und prüfen Sie erneut.
• CAA-Einträge blockieren das Zertifikat. Steht an der Apex-Domain ein CAA-Eintrag, der letsencrypt.org nicht enthält, schlägt die Ausstellung ohne Meldung fehl. Entfernen Sie den CAA-Eintrag oder ergänzen Sie einen Eintrag 0 issue "letsencrypt.org".
• CertPending länger als 10 Minuten. Dann stimmt vorgelagert etwas nicht. Öffnen Sie in der Console die Detailansicht der Domain, sie zeigt das letzte Ereignis der Bereitstellung. Kommen Sie nicht weiter, hilft meist nyx domain remove und erneutes Hinzufügen.