Coloca tu centro de ayuda en una subcarpeta con Vercel
Publica tu centro de ayuda en una ruta de un sitio alojado en Vercel, como yourcompany.com/help, añadiendo rutas de proxy a vercel.json.
Se necesita un método de pago registrado; una prueba con tarjeta cumple este requisito. Los propietarios y administradores pueden cambiar esta configuración.
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 se usan /help y www.yourcompany.com; sustitúyelos por los tuyos.
Añade las rutas
Añade esto a vercel.json en la raíz de tu proyecto (combínalo con lo que ya haya allí) y, a continuación, sustituye tres marcadores de posición:
__PUBLIC_HOST__: el nombre de host de producción, comowww.yourcompany.com. Usa el nombre de host de producción, no una URL de vista previa.__FERNDESK_HOST__: el host del proxy.__BASE_PATH__: tu ruta, con la barra inicial, como/help.
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"headers": [
{
"source": "/_ferndesk",
"headers": [
{ "key": "x-vercel-enable-rewrite-caching", "value": "0" }
]
},
{
"source": "/_ferndesk/:match*",
"headers": [
{ "key": "x-vercel-enable-rewrite-caching", "value": "0" }
]
},
{
"source": "__BASE_PATH__",
"headers": [
{ "key": "x-vercel-enable-rewrite-caching", "value": "0" }
]
},
{
"source": "__BASE_PATH__/:match*",
"headers": [
{ "key": "x-vercel-enable-rewrite-caching", "value": "0" }
]
}
],
"routes": [
{
"src": "/_ferndesk",
"dest": "https://__FERNDESK_HOST__/_ferndesk?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
},
{
"src": "/_ferndesk/(.*)",
"dest": "https://__FERNDESK_HOST__/_ferndesk/$1?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
},
{
"src": "__BASE_PATH__/_ferndesk",
"dest": "https://__FERNDESK_HOST__/_ferndesk?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
},
{
"src": "__BASE_PATH__/_ferndesk/(.*)",
"dest": "https://__FERNDESK_HOST__/_ferndesk/$1?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
},
{
"src": "__BASE_PATH__",
"dest": "https://__FERNDESK_HOST__/?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
},
{
"src": "__BASE_PATH__/(.*)",
"dest": "https://__FERNDESK_HOST__/$1?__bp=__BASE_PATH__",
"transforms": [
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-base-path" }, "args": "__BASE_PATH__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-forwarded-host" }, "args": "__PUBLIC_HOST__" },
{ "type": "request.headers", "op": "set", "target": { "key": "x-ferndesk-original-host" }, "args": "__PUBLIC_HOST__" }
]
}
]
}La sección headers desactiva el almacenamiento en caché de reescrituras de Vercel en estas rutas, para que una página solicitada antes de terminar la configuración no se almacene en caché como No encontrada. Implementa los cambios para aplicarlos.
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 faltan estilos justo después de la configuración, vuelve a implementar para borrar la caché de Vercel. Si algo no funciona correctamente, consulta Solucionar problemas del centro de ayuda.
Para dejar de usar la subcarpeta, haz clic en Eliminar subdirectorio en Ferndesk y elimina estas entradas de vercel.json.
Si prefieres usar un subdominio o usar otros proveedores de alojamiento, consulta Conectar un dominio personalizado al centro de ayuda.