Saltar al contenido principal

​
archivo vercel.json

El archivo vercel.json define cómo se compila y se implementa tu proyecto. Se ubica en el directorio raíz y controla varios aspectos de la implementación, como el enrutamiento, las redirecciones, los encabezados y la configuración de compilación. Usamos la configuración rewrites para hacer de proxy las solicitudes desde tu dominio principal hacia tu documentación. Las reescrituras mapean las solicitudes entrantes a distintos destinos sin cambiar la URL en el navegador. Cuando alguien visita yoursite.com/docs, Vercel obtendrá internamente el contenido desde your-subdomain.mintlify.dev/docs, pero la persona seguirá viendo yoursite.com/docs en su navegador. Esto difiere de las redirecciones, que enviarían a los usuarios a una URL completamente distinta. Puedes personalizar la subruta con cualquier valor que prefieras, como /docs, /help o /guides. Además, puedes usar subrutas profundamente anidadas como /product/docs.

​
Estructura del repositorio

Tus archivos de documentación deben estar organizados dentro de tu repositorio para que coincidan con la estructura de la subruta que elijas. Por ejemplo, si quieres tu documentación en yoursite.com/docs, deberías crear un directorio docs/ con todos tus archivos de documentación.

​
Configuración

Para alojar tu documentación en una subruta personalizada con Vercel, agrega la siguiente configuración a tu archivo vercel.json. Este ejemplo usa /docs, pero puedes reemplazarlo por cualquier subruta: 
{
  "rewrites": [
    {
      "source": "/docs",
      "destination": "https://[subdomain].mintlify.dev/docs"
    },
    {
      "source": "/docs/:match*",
      "destination": "https://[subdomain].mintlify.dev/docs/:match*"
    }
  ]
}
  • source: El patrón de ruta en tu domain que activa la reescritura.
  • destination: A dónde se debe enrutar por proxy la solicitud.
  • :match*: Un comodín que captura cualquier segmento de ruta después de tu subruta.
Para obtener más información, consulta Configuring projects with vercel.json: Rewrites en la documentación de Vercel.

​
Generar redirecciones

Ingresa tu subdomain y el subdirectorio personalizado para generar las redirecciones de tu archivo vercel.json.

​
Uso de proxies externos con Vercel

Si utilizas un proxy externo (como Cloudflare o AWS CloudFront) delante de tu implementación en Vercel, debes configurarlo correctamente para evitar conflictos con la verificación del domain de Vercel y el aprovisionamiento de certificados SSL. Una configuración incorrecta del proxy puede impedir que Vercel aprovisione certificados SSL de Let’s Encrypt y provocar fallos en la verificación del domain. Consulta los proveedores compatibles en la documentación de Vercel.

​
Lista obligatoria de rutas permitidas

Tu proxy externo debe permitir el tráfico a estas rutas específicas sin bloquear, redirigir ni aplicar un almacenamiento en caché agresivo:
  • /.well-known/acme-challenge/* - Obligatorio para la verificación de certificados de Let’s Encrypt
  • /.well-known/vercel/* - Obligatorio para la verificación de domain de Vercel
  • /mintlify-assets/_next/static/* - Obligatorio para los recursos estáticos
Estas rutas deben pasar directamente a tu implementación en Vercel sin modificaciones.

​
Requisitos para el reenvío de encabezados

Asegúrate de que tu proxy reenvíe correctamente el encabezado HOST. Sin un reenvío adecuado de ese encabezado, las solicitudes de verificación fallarán.

​
Probar la configuración de tu proxy

Para verificar que tu proxy esté configurado correctamente:
  1. Comprueba que https://[yourdomain].com/.well-known/vercel/ devuelva una respuesta.
  2. Asegúrate de que los certificados SSL se estén aprovisionando correctamente en tu dashboard de Vercel.
  3. Verifica que la verificación del domain se complete correctamente.