ProxyPass funktioniert nicht in .htaccess, und die meisten Shared-Hosting-Anbieter deaktivieren Proxying. Verlagern Sie Ihre DNS-Verwaltung zu Cloudflare und folgen Sie stattdessen der Cloudflare-Anleitung.
Hilfe-Center mit Apache in einem Unterordner bereitstellen
Stellen Sie Ihr Hilfe-Center unter einem Pfad auf einer Website bereit, die mit Apache HTTP Server 2.4 läuft, zum Beispiel unter yourcompany.com/help. Dazu benötigen Sie drei Proxy-Regeln im virtuellen Host Ihrer Website.
Erfordert eine hinterlegte Zahlungsmethode. Eine Testphase mit hinterlegter Karte erfüllt diese Voraussetzung. Eigentümer und Admins können dies ändern.
Richten Sie es ein
Legen Sie den Unterordner in Ferndesk fest
Wählen Sie unter Hilfe-Center > Anpassen > Benutzerdefinierte Domain die Option Benutzerdefinierter Unterordner aus, geben Sie die Domain Ihrer Website und einen Pfad wie /help ein und klicken Sie auf Unterverzeichnis konfigurieren. Kopieren Sie den angezeigten Proxy-Host (er sieht etwa so aus: yourcompany.hc.ferndesk.com). In den folgenden Beispielen werden /help und www.yourcompany.com verwendet. Ersetzen Sie diese durch Ihre eigenen Werte.
Aktivieren Sie die Proxy-Module
Apache benötigt mod_proxy, mod_proxy_http, mod_ssl und mod_headers. Führen Sie unter Debian und Ubuntu sudo a2enmod proxy proxy_http ssl headers aus.
Fügen Sie die Regeln hinzu und laden Sie Apache neu
Fügen Sie die folgende Konfiguration zum virtuellen Host Ihrer Website hinzu. Ersetzen Sie PROXY_HOST durch den Proxy-Host und www.yourcompany.com durch den Host Ihrer Website. Prüfen Sie die Konfiguration anschließend mit apachectl configtest und laden Sie Apache neu.
# Inside the <VirtualHost *:443> block for www.yourcompany.com
SSLProxyEngine on
ProxyPreserveHost off
ProxyPassMatch "^/help$" "https://PROXY_HOST/"
ProxyPass "/help/" "https://PROXY_HOST/"
ProxyPass "/_ferndesk/" "https://PROXY_HOST/_ferndesk/"
<LocationMatch "^/(help$|help/|_ferndesk/)">
RequestHeader set X-Ferndesk-Base-Path "/help"
RequestHeader set X-Ferndesk-Original-Host "www.yourcompany.com"
</LocationMatch>Der abschließende Schrägstrich in
https://PROXY_HOST/in der zweiten Regel entfernt/helpaus allen darunterliegenden Pfaden. Lassen Sie ihn daher nicht weg. Die erste Regel leitet/helpunverändert weiter, und Ferndesk stellt es als Startseite Ihres Hilfe-Centers bereit.ProxyPreserveHost offsorgt dafür, dass der Proxy-Host alsHost-Header gesendet wird. Ist die Option aktiviert, schlägt jede Seite mit einem 500-Proxyfehler fehl.Apache verwendet die erste passende
ProxyPass-Regel. Setzen Sie diese Regeln daher oberhalb aller Regeln, die/an Ihre App weiterleiten.
Wir haben diese Konfiguration mit Apache 2.4.71 in Docker für ein aktives Ferndesk-Hilfe-Center getestet und uns dabei an der mod_proxy-Dokumentation von Apache orientiert. Wenn etwas in Ihrer Umgebung nicht funktioniert, schreiben Sie an [email protected] und senden Sie Ihre Konfiguration sowie die Adresse, bei der das Problem auftritt.
Prüfen Sie, ob es funktioniert
Rufen Sie https://www.yourcompany.com/help auf. Ihr Hilfe-Center sollte mit seiner Formatierung geladen werden und die Links zwischen Artikeln sollten weiterhin auf Ihre Domain verweisen. Falls etwas nicht stimmt, lesen Sie den Artikel Fehlerbehebung für Ihr Hilfe-Center.
Häufige Fragen
Das Hilfe-Center wird ohne Formatierung geladen
Die Regel /_ferndesk/ fehlt. Sie stellt die Skripte und Styles des Hilfe-Centers im Stammverzeichnis Ihrer Domain bereit.
Apache zeigt bei /help einen 500-Fehler an
Prüfen Sie, ob ProxyPreserveHost deaktiviert ist, ob SSLProxyEngine on im selben virtuellen Host steht und ob mod_ssl geladen ist. Im Apache-Fehlerprotokoll steht, was fehlt.
Informationen zur Verwendung einer Subdomain oder anderer Hosts finden Sie unter Benutzerdefinierte Domain mit Ihrem Hilfe-Center verbinden.