Richten Sie Ihr Help Center mit Cloudflare in einem Unterordner ein
Stellen Sie Ihr Help Center unter einem Pfad auf Ihrer Website bereit, zum Beispiel unter yourcompany.com/help, indem Sie einen Cloudflare Worker vor Ihre Website schalten. Das DNS Ihrer Domain muss bei Cloudflare verwaltet werden.
Dafür muss eine Zahlungsmethode hinterlegt sein. Bei einem Testzeitraum mit hinterlegter Karte ist diese Voraussetzung erfüllt. Inhaber und Administratoren können diese Einstellung ä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 Beispiele unten verwenden /help und www.yourcompany.com; ersetzen Sie diese durch Ihre eigenen Angaben.
Worker erstellen
Erstellen Sie in Cloudflare einen Worker (mit der Vorlage „Hello World“) mit einem Namen wie
ferndesk-proxyund stellen Sie ihn bereit.Fügen Sie in den Einstellungen des Workers unter Domains & Routen Ihrer Zone zwei Routen hinzu:
*yourcompany.com/help*und*yourcompany.com/_ferndesk*. Die zweite Route stellt die Skripte und Styles des Help Centers bereit. Ohne sie werden die Seiten ohne Formatierung geladen.Bearbeiten Sie den Code des Workers, ersetzen Sie ihn durch den folgenden Code, legen Sie
HELP_HOSTauf Ihren Proxy-Host undPROXY_PREFIXauf Ihren Pfad fest und stellen Sie 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 erforderlichen Header und schreibt Weiterleitungen um (zum Beispiel von umbenannten Artikeln), damit sie wieder auf Ihre Domain verweisen.
Prüfen, ob alles funktioniert
Rufen Sie https://www.yourcompany.com/help auf. Ihr Help Center sollte mit Formatierung geladen werden, und Links zwischen Artikeln sollten auf Ihrer Domain bleiben. Im kostenlosen Cloudflare-Tarif ist die Anzahl der Worker-Anfragen pro Tag begrenzt. Prüfen Sie daher die Limits, wenn Ihr Help Center stark frequentiert ist. Falls etwas nicht stimmt, lesen Sie Fehlerbehebung für Ihr Help Center.
Informationen zur Verwendung einer Subdomain oder anderer Hosts finden Sie unter Benutzerdefinierte Domain mit Ihrem Help Center verbinden.