Hilfe-Center mit Cloudflare in einem Unterordner bereitstellen
Stelle dein Hilfe-Center unter einem Pfad auf deiner Website bereit, z. B. unter yourcompany.com/help, indem du einen Cloudflare Worker vor deine Website schaltest. Die DNS-Einstellungen deiner Domain müssen bei Cloudflare verwaltet werden.
Dafür muss eine Zahlungsmethode hinterlegt sein. Bei einem Testzeitraum mit Karte ist diese Voraussetzung erfüllt. Inhaber und Administratoren können diese Einstellung ä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). Die Beispiele unten verwenden /help und www.yourcompany.com; ersetze sie durch deine eigenen Angaben.
Worker erstellen
Erstelle in Cloudflare einen Worker (mit der Vorlage „Hello World“), gib ihm einen Namen wie
ferndesk-proxyund stelle ihn bereit.Füge in den Einstellungen des Workers unter Domains & Routen zwei Routen für deine Zone hinzu:
*yourcompany.com/help*und*yourcompany.com/_ferndesk*. Die zweite Route stellt die Skripte und Styles des Hilfe-Centers bereit. Ohne sie werden die Seiten ohne Formatierung geladen.Bearbeite den Code des Workers, ersetze ihn durch den folgenden Code, setze
HELP_HOSTauf deinen Proxy-Host undPROXY_PREFIXauf deinen Pfad und stelle den Worker bereit.
const HELP_HOST = 'your-company.hc.ferndesk.com'; // your Ferndesk help domain
const PROXY_PREFIX = '/help'; // the subfolder you chose in Ferndesk
const PROXY_VERSION = '2';
addEventListener('fetch', (event) => {
event.respondWith(handleRequest(event.request));
});
async function handleRequest(request) {
const originalUrl = new URL(request.url);
// Keep canonical trailing-slash behaviour on the edge
if (originalUrl.pathname.endsWith('/') && originalUrl.pathname !== '/') {
originalUrl.pathname = originalUrl.pathname.slice(0, -1);
return Response.redirect(originalUrl.toString(), 301);
}
// Only intercept the help subtree (and the help assets)
if (
originalUrl.pathname !== PROXY_PREFIX &&
!originalUrl.pathname.startsWith(`${PROXY_PREFIX}/`) &&
!originalUrl.pathname.startsWith('/_ferndesk/')
) {
return fetch(request);
}
// Build the upstream request with the prefix removed
const upstreamUrl = new URL(originalUrl.toString());
upstreamUrl.hostname = HELP_HOST;
if (upstreamUrl.pathname === PROXY_PREFIX) {
upstreamUrl.pathname = '/';
} else if (upstreamUrl.pathname.startsWith(`${PROXY_PREFIX}/`)) {
upstreamUrl.pathname = upstreamUrl.pathname.slice(PROXY_PREFIX.length) || '/';
}
// Enables edge caching: tells Ferndesk this render belongs to your
// subfolder so it gets its own cache entry.
upstreamUrl.searchParams.set('__bp', PROXY_PREFIX);
const proxyRequest = new Request(upstreamUrl.toString(), request);
// Let the help app know we are hosted under the subfolder
proxyRequest.headers.set('X-Ferndesk-Base-Path', PROXY_PREFIX);
proxyRequest.headers.set('X-Forwarded-Host', originalUrl.host);
proxyRequest.headers.set('X-Ferndesk-Original-Host', originalUrl.host);
proxyRequest.headers.set('X-Ferndesk-Proxy-Version', PROXY_VERSION);
// Handle redirects ourselves so renamed articles redirect visitors on
// this domain instead of being followed silently.
const response = await fetch(proxyRequest, { redirect: 'manual' });
if (response.status >= 300 && response.status < 400) {
return rewriteRedirect(response, originalUrl);
}
return response;
}
// Translates an upstream redirect (on the Ferndesk help host) back onto
// this site's host and subfolder. External redirects pass through as-is.
function rewriteRedirect(response, originalUrl) {
const location = response.headers.get('location');
if (!location) return response;
const target = new URL(location, `https://${HELP_HOST}`);
if (target.hostname !== HELP_HOST) return response;
target.protocol = 'https:';
target.host = originalUrl.host;
target.searchParams.delete('__bp');
const alreadyPrefixed =
target.pathname === PROXY_PREFIX || target.pathname.startsWith(`${PROXY_PREFIX}/`);
if (!alreadyPrefixed) {
target.pathname = target.pathname === '/' ? PROXY_PREFIX : PROXY_PREFIX + target.pathname;
}
// Response headers from fetch are immutable; copy to edit Location.
const rewritten = new Response(response.body, response);
rewritten.headers.set('location', target.toString());
return rewritten;
}Der Worker entfernt den Pfad vor der Weiterleitung, setzt die beiden benötigten Header und passt Weiterleitungen (z. B. von umbenannten Artikeln) so an, dass sie wieder auf deine Domain verweisen.
Prüfen, ob alles funktioniert
Rufe https://www.yourcompany.com/help auf. Dein Hilfe-Center sollte mit Formatierung geladen werden, und die Links zwischen den Artikeln sollten auf deiner Domain bleiben. Der kostenlose Cloudflare-Tarif begrenzt die Anzahl der Worker-Anfragen pro Tag. Prüfe daher die Limits, wenn dein Hilfe-Center stark genutzt wird. Falls etwas nicht stimmt, lies den Artikel Probleme mit deinem Hilfe-Center beheben.
Informationen zur Verwendung einer Subdomain oder anderer Hosts findest du unter Eine benutzerdefinierte Domain mit deinem Hilfe-Center verbinden.