Proxies externos con Vercel

Configura proxies inversos externos como Cloudflare o Nginx delante de tu despliegue de Vercel para servir documentación de Mintlify en una subruta personalizada.

Si tienes 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 de dominio 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 errores en la verificación del dominio.

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 del dominio de Vercel
• /mintlify-assets/_next/static/* - Obligatorio para los recursos estáticos

Estas rutas se deben enrutar directamente a tu implementación de Vercel sin modificaciones.

​

Requisitos de reenvío de encabezados

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

​

Probar la configuración de tu proxy

Para verificar que tu proxy esté configurado correctamente:

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