Der Block /_ferndesk/* fehlt. Er stellt die Skripte und Formatierungen des Help Centers im Stammverzeichnis Ihrer Domain bereit.
Help Center mit Caddy in einem Unterverzeichnis bereitstellen
Stellen Sie Ihr Help Center unter einem Pfad auf einer Website bereit, auf der Caddy 2 läuft, zum Beispiel unter yourcompany.com/help. Fügen Sie dazu zwei handle-Blöcke in Ihre Caddyfile ein.
Dafür muss eine Zahlungsmethode hinterlegt sein. Eine Testversion mit hinterlegter Karte erfüllt diese Voraussetzung. Inhaber und Administratoren können das ändern.
Richten Sie es ein
Legen Sie das Unterverzeichnis in Ferndesk fest
Wählen Sie unter Help Center > Anpassen > Benutzerdefinierte Domain die Option Benutzerdefiniertes Unterverzeichnis 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). Die folgenden Beispiele verwenden /help und www.yourcompany.com; ersetzen Sie diese durch Ihre eigenen Werte.
Fügen Sie die Blöcke hinzu und laden Sie Caddy neu
Fügen Sie die beiden handle-Blöcke unten in den Block Ihrer Website ein, ersetzen Sie PROXY_HOST durch den Proxy-Host und laden Sie Caddy mit caddy reload neu. Wenn sich der übrige Teil Ihrer Website in einem eigenen handle-Block befindet, muss dieser nach den hier gezeigten Blöcken stehen.
www.yourcompany.com {
@ferndesk_help path /help /help/*
handle @ferndesk_help {
uri strip_prefix /help
reverse_proxy https://PROXY_HOST {
header_up Host {upstream_hostport}
header_up X-Ferndesk-Base-Path /help
header_up X-Ferndesk-Original-Host {host}
}
}
handle /_ferndesk/* {
reverse_proxy https://PROXY_HOST {
header_up Host {upstream_hostport}
header_up X-Ferndesk-Base-Path /help
header_up X-Ferndesk-Original-Host {host}
}
}
# ...your existing site config
}header_up Host {upstream_hostport}sendet den Proxy-Host alsHost-Header. Ferndesk benötigt diesen Header, um die Anfrage anzunehmen.Der Matcher
path /help /help/*sorgt dafür, dass andere Pfade, die mit denselben Buchstaben beginnen, wie/helpful, weiterhin auf Ihrer Website bleiben.
Wir haben diese Konfiguration mit Caddy 2.11 in Docker anhand eines live geschalteten Ferndesk-Help-Centers getestet und uns dabei an der Dokumentation zu Caddys reverse_proxy orientiert. Falls es bei Ihnen nicht funktioniert, schreiben Sie eine E-Mail an [email protected] und senden Sie Ihre Konfiguration sowie die Adresse, bei der der Fehler auftritt.
Prüfen Sie, ob alles funktioniert
Rufen Sie https://www.yourcompany.com/help auf. Ihr Help Center sollte mit allen Formatierungen geladen werden, und Links zwischen Artikeln sollten auf Ihrer Domain bleiben. Falls etwas nicht stimmt, lesen Sie den Artikel Probleme mit Ihrem Help Center beheben.
Häufige Fragen
Das Help Center wird ohne Formatierung geladen
Informationen zu einer Subdomain oder anderen Hosts finden Sie unter Eine benutzerdefinierte Domain mit Ihrem Help Center verbinden.