Help Center mit Vercel in einem Unterordner bereitstellen
Stellen Sie Ihr Help Center unter einem Pfad auf einer mit Vercel gehosteten Website bereit, zum Beispiel unter yourcompany.com/help, indem Sie Proxy-Routen zu vercel.json hinzufügen.
Dazu muss eine Zahlungsmethode hinterlegt sein. Eine Testphase mit hinterlegter Karte erfüllt diese Voraussetzung. Inhaber und Admins können die Zahlungsmethode ändern.
Unterordner in Ferndesk festlegen
Wählen Sie unter Help Center > Anpassen > Benutzerdefinierte Domain die Option Benutzerdefinierter Unterordner aus, geben Sie die Domain Ihrer Website und einen Pfad wie /help ein und klicken Sie auf Unterverzeichnis konfigurieren. Kopieren Sie den angezeigten Proxy-Host (er sieht etwa so aus: yourcompany.hc.ferndesk.com). Die folgenden Beispiele verwenden /help und www.yourcompany.com; ersetzen Sie diese durch Ihre eigenen Angaben.
Routen hinzufügen
Fügen Sie dies in vercel.json im Stammverzeichnis Ihres Projekts ein (führen Sie es mit dem vorhandenen Inhalt zusammen) und ersetzen Sie anschließend die drei Platzhalter:
__PUBLIC_HOST__: Ihr Hostname in der Produktionsumgebung, zum Beispielwww.yourcompany.com. Verwenden Sie den Hostnamen der Produktionsumgebung, nicht eine Vorschau-URL.__FERNDESK_HOST__: der Proxy-Host.__BASE_PATH__: Ihr Pfad einschließlich des führenden Schrägstrichs, zum Beispiel/help.
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"headers": [
{
"source": "/_ferndesk",
"headers": [
{ "key": "x-vercel-enable-rewrite-caching", "value": "0" }
]
},
{
"source": "/_ferndesk/:match*",
"headers": [
{ "key": "x-vercel-enable-rewrite-caching", "value": "0" }
]
},
{
"source": "__BASE_PATH__",
"headers": [
{ "key": "x-vercel-enable-rewrite-caching", "value": "0" }
]
},
{
"source": "__BASE_PATH__/:match*",
"headers": [
{ "key": "x-vercel-enable-rewrite-caching", "value": "0" }
]
}
],
"routes": [
{
"src": "/_ferndesk",
"dest": "https://__FERNDESK_HOST__/_ferndesk?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
},
{
"src": "/_ferndesk/(.*)",
"dest": "https://__FERNDESK_HOST__/_ferndesk/$1?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
},
{
"src": "__BASE_PATH__/_ferndesk",
"dest": "https://__FERNDESK_HOST__/_ferndesk?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
},
{
"src": "__BASE_PATH__/_ferndesk/(.*)",
"dest": "https://__FERNDESK_HOST__/_ferndesk/$1?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
},
{
"src": "__BASE_PATH__",
"dest": "https://__FERNDESK_HOST__/?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
},
{
"src": "__BASE_PATH__/(.*)",
"dest": "https://__FERNDESK_HOST__/$1?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
}
]
}Der Abschnitt headers deaktiviert das Rewrite-Caching von Vercel für diese Pfade. So wird eine Seite, die vor Abschluss der Einrichtung angefordert wurde, nicht als „Nicht gefunden“ zwischengespeichert. Stellen Sie das Projekt bereit, damit die Änderungen übernommen werden.
Funktion überprüfen
Öffnen Sie https://www.yourcompany.com/help. Ihr Help Center sollte mit seiner Formatierung angezeigt werden, und Links zwischen Artikeln sollten weiterhin auf Ihrer Domain bleiben. Wenn direkt nach der Einrichtung Formatierungen fehlen, stellen Sie das Projekt erneut bereit, um den Vercel-Cache zu leeren. Falls etwas nicht stimmt, lesen Sie den Artikel Probleme mit Ihrem Help Center beheben.
Wenn Sie den Unterordner nicht mehr verwenden möchten, klicken Sie in Ferndesk auf Unterverzeichnis entfernen und entfernen Sie diese Einträge aus vercel.json.
Informationen zur Verwendung einer Subdomain oder anderer Hosting-Anbieter finden Sie unter Eine benutzerdefinierte Domain mit Ihrem Help Center verbinden.