Alojamiento en Subpath
Aloja tu documentación en yoursite.com/docs en lugar de un subdominio separado. Incluye configuraciones para Vercel, CloudFront, Cloudflare y reverse proxy.
Aloja tu documentación en yoursite.com/docs en lugar de un subdominio separado. Para todas las opciones de despliegue, consulta Descripción general del despliegue.
¿Por qué usar un subpath?
Alojar la documentación en yoursite.com/docs en lugar de un subdominio como docs.yoursite.com ofrece:
- Mejor SEO - Las páginas de documentación contribuyen a la autoridad de tu dominio principal
- Experiencia unificada - Los usuarios permanecen en tu dominio principal
- Navegación más sencilla - Sin cambio de contexto entre dominios
Cómo funciona
Tu servidor web o CDN redirige las solicitudes de /docs/* a tu sitio de Jamdesk preservando la URL original en el navegador:
El proxy pasa el encabezado X-Jamdesk-Forwarded-Host con tu dominio. Jamdesk lo utiliza para:
- Verificar que tu dominio está autorizado para servir el contenido
- Aplicar tu configuración desde el dashboard
Esto significa que la configuración de tu proxy es una configuración única — si cambias ajustes en el dashboard, el proxy no necesita actualizarse.
Configuración por proveedor
Elige tu proveedor de alojamiento para comenzar:
Requisitos previos
Antes de configurar tu proxy:
- Activa el alojamiento en subpath en tu dashboard de Jamdesk en Ajustes → Dominio personalizado
- Activa "Host at /docs"
- Añade tu dominio (p. ej.,
yoursite.com)
Tu subdominio de Jamdesk (p. ej., acme.jamdesk.app) se mostrará en el dashboard — lo necesitarás para la configuración de tu proxy.
Activar o desactivar "Host at /docs" activa una reconstrucción automática de tu documentación. Esto es necesario porque la estructura de URL cambia entre /introduction y /docs/introduction.
Una vez que hayas configurado tu proxy, comprueba el resultado visitando https://yoursite.com/docs. Tu documentación debe cargarse correctamente con todos los recursos y enlaces funcionando.