Placer votre centre d’aide dans un sous-dossier avec Nginx
Rendez votre centre d’aide accessible à un chemin donné sur un site derrière Nginx, par exemple yourcompany.com/help, à l’aide de trois blocs location.
Un moyen de paiement doit être enregistré, ce qui est le cas d’un essai avec une carte. Les propriétaires et les administrateurs peuvent modifier ce paramètre.
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, par exemple /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.
Ajouter les blocs location
Ajoutez ce code 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 dans 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. En cas de problème, consultez Dépanner votre centre d’aide.
Pour utiliser un sous-domaine ou un autre hébergeur, consultez Connecter un domaine personnalisé à votre centre d’aide.