Nur benutzerdefinierte Domain

Ihre Dokumentation wird unter YOUR_SLUG.jamdesk.app gehostet. Wenn Sie eine benutzerdefinierte Domain verbinden, antwortet diese Subdomain weiterhin – aber jede von ihr bereitgestellte Seite enthält ein <link rel="canonical">-Tag, das auf Ihre Domain verweist. Dadurch indexieren Suchmaschinen Ihre Domain, niemals die Subdomain. Für die meisten Projekte ist das alles, was Sie benötigen.

Die Screenshots zeigen die Benutzeroberfläche auf Englisch.

Nur benutzerdefinierte Domain geht einen Schritt weiter: Die Subdomain wird für direkte Besucher deaktiviert. Ein direkter Aufruf von YOUR_SLUG.jamdesk.app liefert einen 404-Fehler, und Ihre Dokumentation ist nur über Ihre eigene Domain erreichbar.

Aktivierung

1

Ihre benutzerdefinierte Domain überprüfen

Fügen Sie Ihre Domain im Dashboard hinzu und überprüfen Sie sie – siehe Benutzerdefinierte Domains. Der Umschalter erfordert eine Domain mit dem Status Active.

2

Ihren Proxy überprüfen (nur bei Reverse-Proxy-Konfigurationen)

Wenn Ihre Domain ein einfacher, auf Jamdesk verweisender CNAME ist (z. B. docs.acme.com), überspringen Sie diesen Schritt – es gibt nichts zu konfigurieren. Wenn Sie Dokumentation unter yoursite.com/docs über einen Proxy bereitstellen, muss der Proxy sich bei jeder weitergeleiteten Anfrage identifizieren – siehe unten Proxy-Konfigurationen.

3

Den Umschalter aktivieren

Öffnen Sie im Dashboard die Settings Ihres Projekts, erweitern Sie die Karte Custom Domain und aktivieren Sie Custom domain only. Jamdesk überprüft zuerst Ihre aktive Domain und aktiviert den Umschalter erst, wenn Ihre Konfiguration erfolgreich geprüft wurde – wenn die Prüfung fehlschlägt, teilt Ihnen die Meldung genau mit, was Sie korrigieren müssen.

Änderungen erreichen innerhalb einer Minute jeden Edge-Server.

Proxy-Konfigurationen

Eine Anfrage an YOUR_SLUG.jamdesk.app wird nur bereitgestellt, wenn sie sich als über Ihren Proxy kommend identifiziert – entweder mit dem Header X-Jamdesk-Forwarded-Host oder dem Abfragemarker ?jd_proxy=1. Jeder Konfigurationsleitfaden enthält bereits die richtige Option:

• Vercel – Umschreibungen in vercel.json übertragen ?jd_proxy=1; Edge Middleware setzt den Header
• Cloudflare Workers – Der Worker setzt den Header
• AWS CloudFront – der benutzerdefinierte Origin-Header
• Reverse Proxy – nginx, Apache, Caddy und HAProxy setzen den Header

Wenn Sie einem dieser Leitfäden gefolgt sind, ist Ihre Konfiguration bereits fertig.

Verwenden Sie MCP oder das Chat-Widget über einen Reverse Proxy? Leiten Sie /api/mcp/:path* und /api/chat/:path* genauso weiter wie /docs. Auf Vercel:

{
  "rewrites": [
    { "source": "/api/mcp/:path*", "destination": "https://YOUR_SLUG.jamdesk.app/api/mcp/:path*?jd_proxy=1" },
    { "source": "/api/chat/:path*", "destination": "https://YOUR_SLUG.jamdesk.app/api/chat/:path*?jd_proxy=1" }
  ]
}

Wenn Ihre benutzerdefinierte Domain per CNAME auf Jamdesk verweist, funktionieren MCP und Chat auf Ihrer Domain ohne Änderungen weiter – richten Sie MCP-Clients auf https://docs.acme.com/_mcp und Sie sind fertig.

Wissenswertes

• Auf der reinen Subdomain liefern alle Aufrufe 404 – Seiten, sitemap.xml, robots.txt, llms.txt und Markdown-Exporte. Browser zeigen eine einfache Jamdesk-Fehlerseite an.
• Bilder bleiben erreichbar. Bilder, Videos und Social-Preview-Bilder (OG) sind ausgenommen – die Website-Vorschau im Dashboard lädt sie direkt von der Subdomain.
• Sie können sich nicht selbst aussperren. Wenn der DNS-Eintrag Ihrer Domain ausfällt, beendet Jamdesk die Durchsetzung der Sperre, und die Subdomain wird wieder bereitgestellt, bis sich die Domain erholt. Wenn Sie stattdessen Ihre eigene Proxy-Konfiguration beschädigen (z. B. indem Sie den Marker aus einer Umschreibung entfernen), deaktivieren Sie den Umschalter, während Sie das Problem beheben.
• Die Search API ist davon nicht betroffen – sie wird über einen API-Schlüssel authentifiziert.

Was kommt als Nächstes?