Clause de non-responsabilité: Cet article a été généré par traduction automatique.

Serveur HTTP Apache

Prev Next

Plans supporting the use of custom domain for knowledge base site 

Professional
Business
Enterprise






Le serveur Web HTTP Apache , également connu sous le nom de serveur Apache, est un serveur Web gratuit et open-source. Apache est très flexible et personnalisable. Vous pouvez facilement activer ou désactiver diverses fonctionnalités.

NOTE

Remplacez l’exemple de domaine par votre domaine fourni par document360/domaine personnalisé.

  • Exemple de domaine représenté à l’aide de example.document360.io

  • Chemin d’accès au sous-dossier/sous-répertoire (/v1) représenté par example.document360.io/v1

  • Subfolder/subdirectory home page path (/help) représenté par example.document360.io/help

Configuration du chemin d’accès à un sous-dossier

Assurez-vous que les modules de serveur Apache suivants sont activés. Ces modules font partie de l’installation du serveur Apache.
•procuration
• proxy_http
•En-têtes
•substituer
• proxy_html
Exécutez la commande bash suivante pour activer les modules :

    sudo a2enmod proxy proxy_http headers substitute proxy_html

Page d’accueil

  1. Configurez les blocs d’emplacement de configuration de l’hôte virtuel suivants.

Par exemple

  • Bloc d’emplacement - Proxy toutes les demandes dont le chemin commence à partir de « /help ».

Ce bloc permettra de proxy les requêtes pour la page d’accueil.

<Location /help>
   ProxyPreserveHost off
   RequestHeader set Host example.document360.io
   RequestHeader set requested-by proxy
   RequestHeader unset Accept-Encoding
   ProxyPass https://example.document360.io/v1
   ProxyPassReverse https://example.document360.io/v1



   AddOutputFilterByType SUBSTITUTE text/html
   substitute 's|href="/docs|href="/help|ni'
   substitute 's|href="/v1/docs|href="/help|ni'
   substitute 's|href="https://example.document360.io/docs|href="https://docs.example.com/help|ni'
</Location>

Bloc de redirection pour corriger les liens d’aperçu de l’article pour l’hébergement de sous-dossiers

  1. Les liens d’aperçu de l’article dans le portail Document360 contiennent l’espace de travail et le slug de langue dans l’URL.

Par exemple

  • URL de l’article : docs.example.com/getting-started

  • Liens d’aperçu dans le portail de la base de connaissances : docs.example.com/v1/en/getting-started

Vous pouvez soit ajouter un bloc d’emplacement supplémentaire pour gérer /v1/en le chemin, (ou) avoir une redirection définie de /v1/en à /.

Veuillez vous référer à l’extrait de code ci-dessous pour définir la redirection :

RewriteEngine on
RewriteRule ^v1/en$ / [R=301,L,NC]

Vous devez installer le rewrite module pour que la redirection fonctionne. Utilisez le code suivant pour installer le rewrite module.

sudo a2enmod rewrite

Pages d’articles/catégories

  1. Configurez les blocs d’emplacement de configuration de l’hôte virtuel suivants.

Par exemple

  • Bloc d’emplacement - Proxy pour toutes les requêtes dont le chemin commence à partir de « /help/ »

Ce blocage permettra de proxy les requêtes pour toutes les pages d’articles/catégories.

<Location /help/>
   ProxyPreserveHost off
   RequestHeader set Host example.document360.io
   RequestHeader set requested-by proxy
   ProxyPass https://example.document360.io/docs/
   ProxyPassReverse https://example.document360.io/docs/



   AddOutputFilterByType SUBSTITUTE text/html
   substitute 's|href="/docs|href="/help|ni'
   substitute 's|href="/v1/docs|href="/help|ni'
   substitute 's|href="https://example.document360.io/docs|href="https://docs.example.com/help|ni'
</Location>
  1. Redémarrer le serveur Apache

Par exemple, si vous utilisez Nginx sous Linux, utilisez la commande
$ sudo systemctl restart nginx

NOTE

Si vous êtes sur KB Site 2.0 et que vous souhaitez héberger votre base de connaissances en tant que sous-dossier, vous devez définir le chemin du sous-dossier ainsi que le chemin de l’API du site.


Génération de sitemap

NOTE

Remplacez l’exemple de domaine par votre domaine fourni par document360/domaine personnalisé.

  • Exemple de domaine représenté à l’aide de example.document360.io

  • Le préfixe du sitemap reste le même, à l’exception du code de langue (en, fr, de, etc.) example.document360.io/sitemap.xml.en

<Location /sitemap.xml.en>
    RequestHeader set Host example.document360.io
    RequestHeader set requested-by proxy
    ProxyPass https://example.document360.io/sitemap.xml.en
    ProxyPassReverse https://example.document360.io/sitemap.xml.en
</Location>

Que se passe-t-il ensuite ?

Une fois que vous avez correctement configuré le serveur Web, le site de votre base de connaissances est en ligne dans votre sous-dossier/sous-répertoire personnalisé.

Toutefois, l’URL existante de votre projet servira les demandes.

Par exemple example.document360.io et example.com/docs (si /docs est le chemin de votre dossier) pointera vers le site de la base de connaissances.

Cela provoquera du contenu dupliqué dans les moteurs de recherche (Google, Bing, etc.). Pour cela, vous devrez activer une redirection d’URL.

NOTE

Pour activer la redirection de example.document360.io à example.com/docs, veuillez nous contacter à l’adresse support@document360.com.