Der Router ferndesk-assets fehlt oder passt nicht zu deinem Host. Er stellt die Skripte und Styles des Help Centers im Stammverzeichnis deiner Domain bereit.
Help Center mit Traefik in einem Unterordner bereitstellen
Stelle dein Help Center unter einem Pfad auf einer Website hinter Traefik Proxy v3 bereit, z. B. unter yourcompany.com/help, mit zwei Routern und einem Service, der auf Ferndesk verweist.
Es ist eine hinterlegte Zahlungsmethode erforderlich. Eine Testversion mit hinterlegter Karte erfüllt diese Voraussetzung. Inhaber und Administratoren können diese Einstellung ändern.
Einrichtung
Unterordner in Ferndesk festlegen
Wähle unter Help Center > Customize > Custom Domain die Option Benutzerdefinierter Unterordner, gib die Domain deiner Website und einen Pfad wie /help ein und klicke auf Unterverzeichnis konfigurieren. Kopiere den Proxy-Host, den wir dir anzeigen (er sieht etwa so aus: yourcompany.hc.ferndesk.com). Die Beispiele unten verwenden /help und www.yourcompany.com; ersetze sie durch deine eigenen Werte.
Dynamische Konfiguration hinzufügen
Füge die folgende Konfiguration in eine Datei ein, die vom File-Provider von Traefik geladen wird, und ersetze PROXY_HOST durch den Proxy-Host und www.yourcompany.com durch den Host deiner Website. Füge beiden Routern denselben Entry Point und dieselben TLS-Einstellungen wie dem Router deiner Website hinzu. Traefik übernimmt Dateiänderungen automatisch, wenn der Provider die Datei überwacht.
# Dynamic configuration, loaded with the file provider
http:
routers:
ferndesk-help:
rule: "Host(`www.yourcompany.com`) && (Path(`/help`) || PathPrefix(`/help/`))"
middlewares: [ferndesk-strip, ferndesk-headers]
service: ferndesk
ferndesk-assets:
rule: "Host(`www.yourcompany.com`) && PathPrefix(`/_ferndesk/`)"
middlewares: [ferndesk-headers]
service: ferndesk
middlewares:
ferndesk-strip:
stripPrefix:
prefixes: ["/help"]
ferndesk-headers:
headers:
customRequestHeaders:
X-Ferndesk-Base-Path: "/help"
X-Ferndesk-Original-Host: "www.yourcompany.com"
services:
ferndesk:
loadBalancer:
passHostHeader: false
servers:
- url: "https://PROXY_HOST"passHostHeader: falsesorgt dafür, dass der Proxy-Host alsHost-Header gesendet wird. Mit der Standardeinstellung schlagen alle Seiten mit einem 403-Fehler fehl.Traefik ordnet Router nach der Länge ihrer Regel. Daher haben diese Vorrang vor einem Router, der nur auf deinen Host passt. Wenn du die Prioritäten der Router selbst festlegst, gib diesen eine höhere Priorität.
Wenn die Router deiner Website Docker-Labels oder Kubernetes verwenden, lasse diesen Service im File-Provider und verweise von einem anderen Provider aus mit
ferndesk@filedarauf.
Wir haben diese Konfiguration mit Traefik 3.6 in Docker anhand eines Live-Help-Centers von Ferndesk getestet und sind dabei der Traefik-Dokumentation zu Services gefolgt. Falls die Konfiguration bei dir nicht funktioniert, schreibe eine E-Mail an [email protected] und sende deine Konfiguration sowie die Adresse, die nicht funktioniert, mit.
Funktion überprüfen
Rufe https://www.yourcompany.com/help auf. Dein Help Center sollte mit allen Formatierungen geladen werden, und Links zwischen Artikeln sollten weiterhin auf deiner Domain bleiben. Falls etwas nicht stimmt, lies den Artikel Probleme mit deinem Help Center beheben.
Häufige Fragen
Das Help Center wird ohne Formatierung geladen
Auf jeder Seite wird ein 403-Fehler angezeigt
Setze passHostHeader: false für den Ferndesk-Service.
Wenn du stattdessen eine Subdomain oder andere Hosts verwenden möchtest, lies den Artikel Eine benutzerdefinierte Domain mit deinem Help Center verbinden.