Alojamiento en subruta
Aloja tus docs en yoursite.com/docs en lugar de un subdominio. Incluye configuraciones para Vercel, CloudFront, Cloudflare y proxy inverso.
Aloja tus docs en yoursite.com/docs en lugar de un subdominio separado. Para conocer todas las opciones de despliegue, consulta Resumen de despliegue.
¿Por qué usar una subruta?
Alojar los docs 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 simple - Sin cambios de contexto entre dominios
Cómo funciona
Tu servidor web o CDN redirige las solicitudes de /docs/* a tu sitio Jamdesk mientras conserva la URL original en el navegador:
El proxy envía el header X-Jamdesk-Forwarded-Host con tu dominio. Jamdesk lo usa para:
- Verificar tu dominio está autorizado a 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 los ajustes en el dashboard, el proxy no necesita actualizarse.
Configuración por proveedor
Elige tu proveedor de hosting para empezar:
Requisitos previos
Antes de configurar tu proxy:
- Habilita el alojamiento en subruta en tu dashboard de Jamdesk en Settings → Custom Domain
- Activa "Host at /docs"
- Agrega tu dominio (por ejemplo,
yoursite.com)
Tu subdominio de Jamdesk (por ejemplo, acme.jamdesk.app) se mostrará en el dashboard - lo necesitarás para la configuración de tu proxy.
Activar o desactivar "Host at /docs" desencadena 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, pruébalo visitando https://yoursite.com/docs. Tu documentación debería cargar con todos los recursos y enlaces funcionando correctamente.
¿Necesito ocultar el subdominio jamdesk.app?
No. Tu subdominio [slug].jamdesk.app sigue siendo accesible (es el origen
al que tu proxy redirige las solicitudes), pero no competirá con tu sitio en
los resultados de búsqueda:
- Con tu dominio registrado, cada página servida directamente desde el subdominio incluye un enlace canónico que apunta a la misma página en tu dominio, de modo que los motores de búsqueda consolidan ahí todas las señales de ranking.
- Antes de registrar un dominio, las páginas del subdominio en modo subruta
se marcan como
noindex, por lo que nunca entran al índice.
Si también quieres que el contenido en sí sea inaccesible en el subdominio (no solo no indexado), habilita Protección con contraseña: el subdominio entonces mostrará una pantalla de desbloqueo en lugar de tus docs.