SmartFlow Host

Concepts

Routage et vercel.json

Redirections, réécritures et en-têtes : comment l'edge route les requêtes vers vos fichiers.

L'edge applique le routage de votre site comme Vercel : celui du format Build Output API (.vercel/output/config.json) pour un site construit avec vercel build, et celui de vercel.json pour un site statique sans build.

vercel.json

Les options suivantes sont prises en compte. Elles sont converties par la bibliothèque de routage de Vercel elle-même, avec les mêmes règles.

OptionEffet
redirectsRedirige un chemin vers un autre, avec un code 301, 302, 307 ou 308.
rewritesSert un autre fichier sans changer l'URL affichée.
headersAjoute des en-têtes de réponse à certains chemins.
cleanUrlsSert /a-propos.html sous /a-propos.
trailingSlashAjoute ou retire la barre oblique finale, par redirection.
routesLe format de routes historique, pour les cas avancés.
vercel.json
{
  "cleanUrls": true,
  "redirects": [{ "source": "/blog/:slug", "destination": "/articles/:slug", "permanent": true }],
  "headers": [{ "source": "/assets/(.*)", "headers": [{ "key": "Cache-Control", "value": "public, max-age=31536000, immutable" }] }]
}

Chaque liste accepte 1024 entrées au plus.

Build Output API

Pour un site envoyé avec vercel deploy --prebuilt, l'edge lit .vercel/output/config.json (version 3) et sert le dossier .vercel/output/static. Les routes passent par les mêmes phases que chez Vercel : routes principales, système de fichiers, miss, rewrite, puis error. Les conditions has et missing (hôte, en-tête, cookie, paramètre) sont prises en compte.

Ce qui est filtré

  • Les en-têtes set-cookie d'une route ne sont pas servis.
  • Les fichiers et dossiers qui commencent par un point (.env, .git) ne sont jamais servis, sauf .well-known.
  • Une expression régulière jugée dangereuse (quantificateurs imbriqués comme (a+)+) ou trop longue fait échouer la publication, avec un message qui désigne la route.

Pages introuvables : un fichier 404.html à la racine du site sert de page d'erreur. Sinon, l'edge affiche sa propre page 404.