Hilfe-Center mit Vercel in einem Unterordner bereitstellen
Stelle dein Hilfe-Center unter einem Pfad auf einer mit Vercel gehosteten Website bereit, zum Beispiel unter yourcompany.com/help, indem du Proxy-Routen zu vercel.json hinzufügst.
Dafür muss eine Zahlungsmethode hinterlegt sein. Eine Testphase mit hinterlegter Karte erfüllt diese Voraussetzung. Inhaber und Admins können dies ändern.
Unterordner in Ferndesk festlegen
Wähle unter Hilfe-Center > Anpassen > Benutzerdefinierte Domain die Option Benutzerdefinierter Unterordner aus, gib die Domain deiner Website und einen Pfad wie /help ein und klicke auf Unterverzeichnis konfigurieren. Kopiere den angezeigten Proxy-Host (er sieht etwa so aus: yourcompany.hc.ferndesk.com). In den folgenden Beispielen werden /help und www.yourcompany.com verwendet. Ersetze diese durch deine eigenen Angaben.
Routen hinzufügen
Füge dies in vercel.json im Stammverzeichnis deines Projekts ein (führe es mit dem vorhandenen Inhalt zusammen) und ersetze anschließend die drei Platzhalter:
__PUBLIC_HOST__: dein Produktions-Hostname, zum Beispielwww.yourcompany.com. Verwende den Produktions-Hostname und keine Vorschau-URL.__FERNDESK_HOST__: der Proxy-Host.__BASE_PATH__: dein 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. Dadurch wird eine Seite, die vor Abschluss der Einrichtung angefragt wurde, nicht als „Not Found“ zwischengespeichert. Stelle die Anwendung bereit, damit die Änderungen wirksam werden.
Funktion überprüfen
Rufe https://www.yourcompany.com/help auf. Dein Hilfe-Center sollte mit Formatierung geladen werden, und Links zwischen Artikeln sollten weiterhin auf deiner Domain bleiben. Falls direkt nach der Einrichtung Formatierungen fehlen, stelle die Anwendung erneut bereit, um den Vercel-Cache zu leeren. Wenn etwas nicht funktioniert, lies den Artikel Probleme mit deinem Hilfe-Center beheben.
Wenn du den Unterordner nicht mehr verwenden möchtest, klicke in Ferndesk auf Unterverzeichnis entfernen und entferne diese Einträge aus vercel.json.
Informationen zur Verwendung einer Subdomain oder anderer Hosting-Anbieter findest du unter Benutzerdefinierte Domain mit deinem Hilfe-Center verbinden.