Placer votre centre d’aide dans un sous-répertoire avec Nginx
Rendez votre centre d’aide accessible à une adresse de votre site derrière Nginx, par exemple yourcompany.com/help, à l’aide de trois blocs location.
Nécessite un moyen de paiement enregistré, ce qui est le cas d’un essai avec carte. Les propriétaires et les administrateurs peuvent modifier ce paramètre.
Définir le sous-répertoire dans Ferndesk
Dans Centre d’aide > Personnaliser > Domaine personnalisé, choisissez Sous-répertoire 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 que nous vous indiquons (il ressemble à yourcompany.hc.ferndesk.com). Les exemples ci-dessous utilisent /help et www.yourcompany.com ; remplacez-les par vos propres valeurs.
Ajouter les blocs location
Ajoutez ce bloc dans le bloc server de votre site, remplacez PROXY_HOST par votre hôte proxy, puis rechargez Nginx. Conservez les tampons proxy plus grands : avec les valeurs par défaut, Nginx renvoie une erreur 502 Bad Gateway, car nos pages envoient des en-têtes volumineux.
# Inside the server block for www.yourcompany.com
proxy_buffer_size 32k;
proxy_buffers 8 32k;
proxy_busy_buffers_size 64k;
location = /help {
proxy_pass https://PROXY_HOST/;
proxy_ssl_server_name on;
proxy_set_header X-Ferndesk-Base-Path /help;
proxy_set_header X-Ferndesk-Original-Host $host;
}
location /help/ {
proxy_pass https://PROXY_HOST/;
proxy_ssl_server_name on;
proxy_set_header X-Ferndesk-Base-Path /help;
proxy_set_header X-Ferndesk-Original-Host $host;
}
location /_ferndesk/ {
proxy_pass https://PROXY_HOST;
proxy_ssl_server_name on;
proxy_set_header X-Ferndesk-Base-Path /help;
proxy_set_header X-Ferndesk-Original-Host $host;
}La barre oblique finale de proxy_pass https://PROXY_HOST/; supprime /help du chemin. Conservez-la donc dans les deux premiers blocs et omettez-la dans le bloc /_ferndesk/.
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, consultez Dépanner 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.