Placer votre centre d’aide dans un sous-dossier avec Cloudflare
Diffusez votre centre d’aide à une adresse de votre site, par exemple yourcompany.com/help, en plaçant un Worker Cloudflare devant votre site. Le DNS de votre domaine doit être géré par Cloudflare.
Un moyen de paiement doit être enregistré. Un essai avec une carte bancaire satisfait cette condition. Les propriétaires et les administrateurs peuvent modifier ce paramètre.
Configurer le sous-dossier dans Ferndesk
Dans Centre d’aide > Personnaliser > Domaine personnalisé, choisissez Sous-dossier personnalisé, saisissez le domaine de votre site et un chemin tel que /help, puis cliquez sur Configurer le sous-répertoire. Copiez l’hôte proxy qui vous est indiqué (il ressemble à yourcompany.hc.ferndesk.com). Les exemples ci-dessous utilisent /help et www.yourcompany.com ; remplacez-les par vos propres valeurs.
Créer le Worker
Dans Cloudflare, créez un Worker (à partir du modèle Hello World) nommé, par exemple,
ferndesk-proxy, puis déployez-le.Dans les Paramètres du Worker, sous Domaines et routes, ajoutez deux routes à votre zone :
*yourcompany.com/help*et*yourcompany.com/_ferndesk*. La deuxième sert les scripts et les feuilles de style du centre d’aide ; sans elle, les pages s’affichent sans mise en forme.Modifiez le code du Worker, remplacez-le par le code ci-dessous, définissez
HELP_HOSTsur votre hôte proxy etPROXY_PREFIXsur votre chemin, puis déployez-le.
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;
}Le Worker supprime le chemin avant de transférer la requête, définit les deux en-têtes nécessaires et réécrit les redirections (par exemple, celles provenant d’articles renommés) pour les faire pointer à nouveau vers votre domaine.
Vérifier que tout fonctionne
Ouvrez https://www.yourcompany.com/help. Votre centre d’aide devrait s’afficher avec sa mise en forme, et les liens entre les articles devraient rester sur votre domaine. L’offre gratuite de Cloudflare limite le nombre de requêtes Worker exécutées chaque jour ; vérifiez ces limites si votre centre d’aide est très fréquenté. En cas de problème, consultez Résoudre les problèmes de votre centre d’aide.
Pour utiliser plutôt un sous-domaine ou un autre hébergeur, consultez Connecter un domaine personnalisé à votre centre d’aide.