Le bloc /_ferndesk/* est manquant. Il sert les scripts et les feuilles de style du centre d’aide depuis la racine de votre domaine.
Placer votre centre d’aide dans un sous-dossier avec Caddy
Hébergez votre centre d’aide à un chemin d’un site qui utilise Caddy 2, par exemple yourcompany.com/help, avec deux blocs handle dans votre Caddyfile.
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.
Configuration
Définir 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 s’affiche (il ressemble à yourcompany.hc.ferndesk.com). Les exemples ci-dessous utilisent /help et www.yourcompany.com ; remplacez-les par les vôtres.
Ajouter les blocs et recharger
Ajoutez les deux blocs handle ci-dessous au bloc de votre site, remplacez PROXY_HOST par l’hôte proxy, puis rechargez Caddy avec caddy reload. Si le reste de votre site se trouve dans son propre bloc handle, conservez-le après ceux-ci.
www.yourcompany.com {
@ferndesk_help path /help /help/*
handle @ferndesk_help {
uri strip_prefix /help
reverse_proxy https://PROXY_HOST {
header_up Host {upstream_hostport}
header_up X-Ferndesk-Base-Path /help
header_up X-Ferndesk-Original-Host {host}
}
}
handle /_ferndesk/* {
reverse_proxy https://PROXY_HOST {
header_up Host {upstream_hostport}
header_up X-Ferndesk-Base-Path /help
header_up X-Ferndesk-Original-Host {host}
}
}
# ...your existing site config
}header_up Host {upstream_hostport}envoie l’hôte proxy dans l’en-têteHost, ce dont Ferndesk a besoin pour accepter la requête.Le sélecteur
path /help /help/*permet aux autres chemins commençant par les mêmes lettres, comme/helpful, de rester sur votre site.
Nous avons testé cette configuration avec Caddy 2.11 dans Docker sur un centre d’aide Ferndesk actif, en suivant la documentation de Caddy sur reverse_proxy. Si la configuration ne fonctionne pas chez vous, envoyez un e-mail à [email protected] en joignant votre configuration et l’adresse qui pose problème.
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. Si quelque chose ne fonctionne pas comme prévu, consultez Dépanner votre centre d’aide.
Questions fréquentes
Le centre d’aide s’affiche sans mise en forme
Pour utiliser plutôt un sous-domaine ou un autre hébergeur, consultez Connecter un domaine personnalisé à votre centre d’aide.