Der Block /_ferndesk/* fehlt. Er stellt die Skripte und Styles des Help Centers im Stammverzeichnis Ihrer Domain bereit.
Help Center mit Caddy in einem Unterordner bereitstellen
Stellen Sie Ihr Help Center unter einem Pfad auf einer Website bereit, die mit Caddy 2 läuft, z. B. yourcompany.com/help. Dazu benötigen Sie zwei handle-Blöcke in Ihrer Caddyfile.
Dafür muss eine Zahlungsmethode hinterlegt sein. Eine Testphase mit hinterlegter Karte erfüllt diese Voraussetzung. Inhaber und Admins können dies ändern.
Richten Sie es ein
Legen Sie den Unterordner in Ferndesk fest
Wählen Sie unter Help Center > Customize > Custom Domain die Option Custom sub-folder aus, geben Sie die Domain Ihrer Website und einen Pfad wie /help ein und klicken Sie auf Configure subdirectory. Kopieren Sie den Proxy host, den wir Ihnen anzeigen (er sieht etwa so aus: yourcompany.hc.ferndesk.com). In den folgenden Beispielen verwenden wir /help und www.yourcompany.com; ersetzen Sie diese durch Ihre eigenen Angaben.
Fügen Sie die Blöcke hinzu und laden Sie Caddy neu
Fügen Sie die beiden folgenden handle-Blöcke zum Block Ihrer Website hinzu, ersetzen Sie PROXY_HOST durch den Proxy-Host und laden Sie Caddy mit caddy reload neu. Wenn sich der Rest Ihrer Website in einem eigenen handle-Block befindet, lassen Sie ihn nach diesen Blöcken stehen.
www.yourcompany.com {
@ferndesk_help path /help /help/*
handle @ferndesk_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. Das benötigt Ferndesk, um die Anfrage anzunehmen.Der
path /help /help/*-Matcher 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 an einem aktiven Ferndesk-Help-Center getestet und uns dabei an der Dokumentation zu Caddys reverse_proxy orientiert. Falls etwas in Ihrer Konfiguration 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
Öffnen Sie https://www.yourcompany.com/help. Ihr Help Center sollte mit allen Formatierungen geladen werden, und Links zwischen Artikeln sollten weiterhin Ihre Domain verwenden. Falls etwas nicht stimmt, lesen Sie Fehlerbehebung für Ihr Help Center.
Häufige Fragen
Das Help Center wird ohne Formatierung geladen
Informationen zur Verwendung einer Subdomain oder anderer Hosts finden Sie unter Eine benutzerdefinierte Domain mit Ihrem Help Center verbinden.