Plans supporting the use of custom domain for knowledge base site
Professional | Business | Enterprise |
---|---|---|
Der Apache HTTP-Webserver , auch Apache-Server genannt, ist ein kostenloser Open-Source-Webserver. Apache ist hochflexibel und anpassbar. Sie können verschiedene Funktionen einfach aktivieren oder deaktivieren.
ANMERKUNG
Ersetzen Sie die Beispieldomäne durch Ihre von document360 bereitgestellte Domäne/benutzerdefinierte Domäne.
Beispieldomäne, die mit
example.document360.io
Pfad des Unterordners/Unterverzeichnisses (/v1), dargestellt als
example.document360.io/v1
Subfolder/subdirectory home page path (/help) dargestellt als
example.document360.io/help
Einrichten eines Unterordnerpfads
Stellen Sie sicher, dass die folgenden Apache-Servermodule aktiviert sind. Diese Module sind Teil der Apache-Serverinstallation.
•Stellvertreter
• proxy_http
•Header
•Ersatz
• proxy_html
Führen Sie den folgenden bash-Befehl aus, um die Module zu aktivieren:
sudo a2enmod proxy proxy_http headers substitute proxy_html
Homepage
Konfigurieren Sie die folgenden Blöcke für den Speicherort der Konfiguration des virtuellen Hosts.
Zum Beispiel
Standortblock : Proxy für alle Anforderungen, bei denen der Pfad mit "/help" beginnt.
Dieser Block leitet Anforderungen für die Startseite weiter.
<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>
Weiterleitungsblock zur Korrektur von Artikelvorschau-Links für das Hosting von Unterordnern
Die Links zur Artikelvorschau im Document360-Portal enthalten den Slug für den Arbeitsbereich und die Sprache in der URL.
Zum Beispiel
Artikel-URL:
docs.example.com/getting-started
Vorschau-Links im Wissensdatenbank-Portal:
docs.example.com/v1/en/getting-started
Sie können entweder einen weiteren Standortblock hinzufügen, um den Pfad zu behandeln /v1/en
, (oder) eine Umleitung von /v1/en
auf festlegen /
.
Bitte beachten Sie das folgende Code-Snippet, um die Weiterleitung festzulegen:
RewriteEngine on
RewriteRule ^v1/en$ / [R=301,L,NC]
Sie sollten das rewrite
Modul installieren, damit die Umleitung funktioniert. Verwenden Sie den folgenden Code, um das rewrite
Modul zu installieren.
sudo a2enmod rewrite
Artikel-/Kategorieseiten
Konfigurieren Sie die folgenden Blöcke für den Speicherort der Konfiguration des virtuellen Hosts.
Zum Beispiel
Standortblock - Proxy für alle Anforderungen, deren Pfad mit "/help/" beginnt
Dieser Block wird Anfragen für alle Artikel-/Kategorieseiten weiterleiten.
<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>
Starten Sie den Apache-Server neu
Wenn Sie beispielsweise Nginx unter Linux verwenden, verwenden Sie den Befehl
$ sudo systemctl restart nginx
ANMERKUNG
Wenn Sie die KB-Site 2.0 verwenden und Ihre Wissensdatenbank als Unterordner hosten möchten, müssen Sie den Unterordnerpfad sowie den Site-API-Pfad definieren.
Sitemap-Generierung
ANMERKUNG
Ersetzen Sie die Beispieldomäne durch Ihre von document360 bereitgestellte Domäne/benutzerdefinierte Domäne.
Beispieldomäne, die mit
example.document360.io
Das Sitemap-Präfix bleibt bis auf den Sprachcode (en, fr, de usw.) unverändert.
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>
Wie geht es weiter?
Nachdem Sie den Webserver erfolgreich konfiguriert haben, ist Ihre Wissensdatenbank-Site in Ihrem benutzerdefinierten Unterordner/Unterverzeichnis live.
Die vorhandene URL für Ihr Projekt bedient jedoch die Anforderungen.
Zum Beispiel
example.document360.io
undexample.com/docs
(if/docs
ist Ihr Ordnerpfad) verweist auf die Wissensdatenbank-Website.
Dies führt zu doppeltem Inhalt in Suchmaschinen (Google, Bing usw.). Dazu müssen Sie eine URL-Weiterleitung aktivieren.
ANMERKUNG
Um die Weiterleitung von
example.document360.io
nach zuexample.com/docs
aktivieren, kontaktieren Sie uns bitte unter support@document360.com.