Falta el router ferndesk-assets o no coincide con tu host. Este sirve los scripts y las hojas de estilo del centro de ayuda desde la raíz de tu dominio.
Coloca tu centro de ayuda en una subcarpeta con Traefik
Publica tu centro de ayuda en una ruta de un sitio detrás de Traefik Proxy v3, como yourcompany.com/help, con dos routers y un servicio que apunte a Ferndesk.
Necesitas tener un método de pago registrado; una prueba con tarjeta cumple este requisito. Los propietarios y administradores pueden cambiar esta configuración.
Configúralo
Configura la subcarpeta en Ferndesk
En Centro de ayuda > Personalizar > Dominio personalizado, elige Subcarpeta personalizada, introduce el dominio de tu sitio y una ruta como /help, y haz clic en Configurar subdirectorio. Copia el Host del proxy que te mostramos (tiene un formato similar a yourcompany.hc.ferndesk.com). En los ejemplos siguientes usamos /help y www.yourcompany.com; sustitúyelos por los tuyos.
Añade la configuración dinámica
Añade la siguiente configuración a un archivo que cargue el proveedor de archivos de Traefik y sustituye PROXY_HOST por el host del proxy y www.yourcompany.com por el host de tu sitio. Añade el punto de entrada y la configuración TLS a ambos routers, igual que en el router de tu sitio. Traefik detecta automáticamente los cambios en los archivos cuando el proveedor los supervisa.
# 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: falseenvía el host del proxy como encabezadoHost. Con el valor predeterminado, todas las páginas muestran un error 403.Traefik ordena los routers según la longitud de sus reglas, por lo que estos tienen prioridad sobre un router que solo coincide con tu host. Si configuras las prioridades de los routers manualmente, asígnales una prioridad más alta.
Si los routers de tu sitio usan etiquetas de Docker o Kubernetes, mantén este servicio en el proveedor de archivos y haz referencia a él desde otro proveedor como
ferndesk@file.
Probamos esta configuración con Traefik 3.6 en Docker frente a un centro de ayuda de Ferndesk activo, siguiendo la documentación de servicios de Traefik. Si algo no funciona en tu configuración, escribe a [email protected] e incluye tu configuración y la dirección que falla.
Comprueba que funciona
Abre https://www.yourcompany.com/help. Tu centro de ayuda debería cargarse con sus estilos, y los enlaces entre artículos deberían permanecer en tu dominio. Si algo no funciona correctamente, consulta Solucionar problemas de tu centro de ayuda.
Preguntas frecuentes
El centro de ayuda se carga sin estilos
Todas las páginas muestran un error 403
Configura passHostHeader: false en el servicio de Ferndesk.
Si prefieres usar un subdominio o quieres configurar otros hosts, consulta Conectar un dominio personalizado a tu centro de ayuda.