Apache HTTP Server

Das Hosten Ihrer Document360-Wissensdatenbank in einem Unterordner auf Apache, wie zum Beispiel example.com/docs, erfordert das Aktivieren von Apache-Modulen sowie die Konfiguration von Proxy- und Redirect-Regeln. Dieser Artikel behandelt das Aktivieren der erforderlichen Module, das Routing der Startseite, der Artikel- und Kategorieseiten sowie den Site-API-Pfad, das Erstellen von Sitemaps und die Handhabung der URL-Weiterleitung, um doppelte Inhalte in Suchmaschinen zu vermeiden.

HINWEIS

Ersetzen Sie die Beispieldomain in diesem Artikel durch Ihre eigene, von Document360 bereitgestellte oder benutzerdefinierte Domain. Zum Beispiel example.document360.io repräsentiert dies Ihre Domäne, example.document360.io/v1 einen Pfad im Arbeitsbereich und example.document360.io/help einen Pfad auf der Startseite eines Unterordners.

Bevor du anfängst

Subordner-Hosting funktioniert nur, wenn sowohl der Unterordnerpfad (zum Beispiel /docs oder /help) als auch der Site-API-Pfad (zum Beispiel /api) in Document360 mit entsprechender Konfiguration auf Ihrem Server definiert sind.

Stellen Sie sicher, dass die folgenden Apache-Module aktiviert sind – diese sind Teil der Standardinstallation von Apache:

proxy
proxy_http
headers
substitute
proxy_html

Ermöglichen Sie ihnen mit:

sudo a2enmod proxy proxy_http headers substitute proxy_html

Wie man die Startseite konfiguriert

Konfigurieren Sie den folgenden Standortblock des virtuellen Hosts, um Anfragen für die Startseite zu proxyen, wobei der Pfad mit /helpbeginnt:

<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>

Behebung von Artikelvorschau-Links für Unterordner-Hosting

Artikelvorschau-Links im Document360-Portal enthalten den Arbeitsbereich und die Sprach-Slug in der URL. Zum Beispiel könnte die URL des Live-Artikels seindocs.example.com/getting-started, während der Link docs.example.com/v1/en/getting-startedzur Portalvorschau . Sie können entweder einen Standortblock hinzufügen, um den /v1/en Pfad zu verwalten, oder eine Weiterleitung von /v1/en :/

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

Diese Umleitung erfordert das Modul rewrite :

sudo a2enmod rewrite

Wie man Artikel- und Kategorieseiten konfiguriert

Füge die folgenden Standortblöcke derselben Apache Virtual Host-Konfigurationsdatei zu Proxy-Artikel, Kategorie und API-Anfragen hinzu:

<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>

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

  AddOutputFilterByType SUBSTITUTE application/json
  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>

Neustart des Apache-Servers, sobald er konfiguriert ist:

sudo systemctl restart apache2

HINWEIS

Ersetzen Sie /docs und /api durch die exakten Werte, die unter Unterordnerpfad und Site-API-Pfad im Document360-Portal konfiguriert sind.

Wie man die Sitemap-Erstellung einrichtet

Das Sitemap-Präfix bleibt gleich, außer dem Sprachcode (en, fr, de usw.).

<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>

Was passiert als Nächstes

Sobald Apache konfiguriert ist, ist deine Wissensdatenbank in deinem benutzerdefinierten Unterordner verfügbar. Die bestehende Document360-URL bedient weiterhin Anfragen – zum Beispiel verweist sowohl als auch example.document360.io example.com/docs auf Ihre Wissensdatenbank-Website. Dies führt zu doppelten Inhalten in Suchmaschinen wie Google und Bing.

Um doppelte Inhalte zu verhindern, aktivieren Sie den Schalter "Unterdomänenzugriff einschränken " unter > Knowledge base site > Custom domain > Subfolder hosting. Stellen Sie sicher, dass eine kanonische Domain konfiguriert ist, bevor Sie dies aktivieren – sobald sie aktiviert ist, leitet Ihre Document360-Subdomain automatisch auf Ihre kanonische Domain um.

Best Practices

Aktiviere alle fünf erforderlichen Apache-Module (proxy, proxy_http, headers, substitute, ), proxy_htmlbevor du Standortblöcke konfigurierst, sonst funktionieren Proxys und Neuschreiben nicht.
Halte den Unterordnerpfad und den Site-API-Pfad zwischen dem Document360-Portal und deiner Apache-Konfiguration identisch, um fehlerhafte Routing zu vermeiden.
Verwenden Sie die substitute Regeln konsistent über die Startseite, Artikel/Kategorie und API-Standortblöcke, um Mischlinge /docs und /help Links auf der Live-Seite zu vermeiden.
Richte die /v1/en Weiterleitung für Artikelvorschau-Links frühzeitig ein, da ungleiche Vorschaulinks sonst für Inhaltsautoren Verwirrung verursachen können.