Skip to content
Mintlify
Mintlify
Déployer

Proxies externes avec Vercel

Configurez des proxys inverses externes comme Cloudflare ou Nginx devant votre déploiement Vercel pour servir Mintlify sur un sous-chemin personnalisé.

Si vous utilisez un proxy externe comme Cloudflare ou AWS CloudFront devant votre déploiement Vercel, vous devez le configurer correctement afin d’éviter les conflits avec la vérification de domaine de Vercel et l’approvisionnement des certificats SSL.

Une mauvaise configuration du proxy peut empêcher Vercel d’approvisionner des certificats SSL Let’s Encrypt et entraîner des échecs de vérification de domaine.

Consultez les fournisseurs pris en charge dans la documentation Vercel.

Votre proxy externe doit autoriser le trafic vers ces chemins spécifiques sans le bloquer, le rediriger ni le mettre en cache de manière agressive :

  • /.well-known/acme-challenge/* - Requis pour la vérification de certificat Let’s Encrypt
  • /.well-known/vercel/* - Requis pour la vérification de domaine Vercel
  • /mintlify-assets/_next/static/* - Requis pour les ressources statiques

Ces chemins doivent être transmis directement à votre déploiement Vercel sans modification.

Assurez-vous que votre proxy transfère correctement l’en-tête Host. Sans un transfert correct des en-têtes, les requêtes de vérification échouent.

Pour vérifier que votre proxy est correctement configuré :

  1. Vérifiez que https://[yourdomain].com/.well-known/vercel/ renvoie une réponse.
  2. Assurez-vous que les certificats SSL sont correctement provisionnés dans votre dashboard Vercel.
  3. Vérifiez que la vérification du domaine se termine avec succès.
Was this page helpful?Suggest editsRaise issue