vercel.json Builder
Vercel Cloud Deployment & Edge Routing

Vercel構成ファイル (vercel.json) ビルダー

Référence technique pour vercel.json : routage edge, réécritures, en-têtes de sécurité, fonctions serverless et planification cron en production.

Vercel V2 Schema Compliant
Zéro transmission au serveur
Préréglages :

Automatically strip .html extensions from page URLs

Enforce or redirect URLs ending with a trailing slash

{
  "$schema": "https://openapi.vercel.sh/vercel.json",
  "cleanUrls": true,
  "trailingSlash": false,
  "framework": "nextjs",
  "regions": [
    "iad1"
  ],
  "rewrites": [
    {
      "source": "/api/proxy/:path*",
      "destination": "https://backend-api.example.com/:path*"
    }
  ],
  "redirects": [
    {
      "source": "/old-blog/:slug",
      "destination": "/blog/:slug",
      "statusCode": 308
    }
  ],
  "headers": [
    {
      "source": "/(.*)",
      "headers": [
        {
          "key": "X-Content-Type-Options",
          "value": "nosniff"
        },
        {
          "key": "X-Frame-Options",
          "value": "DENY"
        },
        {
          "key": "Referrer-Policy",
          "value": "strict-origin-when-cross-origin"
        },
        {
          "key": "Strict-Transport-Security",
          "value": "max-age=63072000; includeSubDomains; preload"
        }
      ]
    }
  ],
  "crons": [
    {
      "path": "/api/cron/nightly-sync",
      "schedule": "0 4 * * *"
    }
  ],
  "functions": {
    "api/**/*.ts": {
      "runtime": "nodejs20.x",
      "memory": 1024,
      "maxDuration": 60
    }
  }
}
アクティブルーティング&Cron数
1 Réécritures•1 Redirections•1 Tâches Cron

リライト、リダイレクト、ヘッダー、関数、Cronの合計値。

デプロイ準備スコア
100 / 100•Prêt pour la production

Vercel公式のルーティング規則およびタイムアウト制限に基づいて評価。

セキュリティ&キャッシュ設定状況
1 Blocs d'en-tête•Clean URLs ACTIVÉ

静的アセットおよびAPIルートに適用されたHTTPセキュリティヘッダー。

Exécution Locale Zero-Knowledge

Tous les traitements, analyses et générations s'exécutent strictement dans la mémoire de votre navigateur. Zéro transmission vers un serveur externe.

Moteur Réactif Submilliseconde

All data payloads remain strictly local with zero external server communication.

Production Ready Export

Clean, optimized output formats ready for immediate deployment.

Référence technique et guide d'architecture

Vercel構成ファイル (vercel.json) ビルダー — Guide de référence

Référence technique pour vercel.json : routage edge, réécritures, en-têtes de sécurité, fonctions serverless et planification cron en production.

Paramètres clés et contrôles

cleanUrlsboolean | null

Supprime automatiquement les extensions .html des URL et redirige les requêtes avec extension vers les chemins propres via HTTP 308.

Par défaut : null
trailingSlashboolean | null

Force ou supprime de manière cohérente les barres obliques finales sur tous les chemins via des redirections 308 automatiques.

Par défaut : null
rewritesRewriteRule[]

Tableau de règles proxy internes associant un modèle source (source) à une destination (destination) sans modifier la barre d'adresse.

Par défaut : []
headersHeaderRule[]

Règles d'en-têtes HTTP personnalisés (CSP, HSTS, CORS) appliqués aux réponses correspondant aux modèles de chemins.

Par défaut : []
functionsFunctionRule[]

Configuration par chemin des fonctions serverless, définissant l'allocation mémoire (128–3008 Mo) et la durée maximale (maxDuration).

Par défaut : []
cronsCronRule[]

Tâches planifiées exécutant des points d'accès API selon la syntaxe POSIX standard à 5 champs en fuseau UTC.

Par défaut : []

Conseils de pro et bonnes practices

Ordre Strict des Regles Rewrite

Placez les réécritures spécifiques d'API avant les motifs génériques (/(.*)). Vercel évalue les règles de haut en bas et s'arrête à la première correspondance.

En-tetes de Securite Globaux

Appliquez les en-têtes globaux comme HSTS sur /((?!_next).*) pour sécuriser les pages sans écraser les en-têtes de cache des ressources internes de Next.js.

Optimisation Memoire Fonctions

Ajustez maxDuration selon votre forfait (10s en Hobby, jusqu'à 300s en Pro) et allouez au moins 1024 Mo de mémoire pour accélérer les calculs intensifs.

Fuseau Horaire UTC pour Cron

Les planifications Cron Vercel utilisent strictement l'heure UTC. Calculez le décalage horaire local pour planifier l'exécution à l'heure souhaitée.

Pièges courants et dépannage

Boucle de redirection infinie avec trailingSlash et règles manuelles

Supprimez les règles manuelles modifiant les barres finales lorsque trailingSlash est défini, car l'infrastructure edge de Vercel gère nativement les redirections 308.

Erreur de validation de schéma avec expression cron à 6 champs

Vercel Cron accepte uniquement le format POSIX standard à 5 champs (* * * * *). Retirez le champ des secondes ou la syntaxe Quartz propre à Java/AWS.

Valeur maxDuration supérieure à la limite du forfait Vercel

Le forfait gratuit Hobby limite maxDuration à 10 secondes. Réduisez cette valeur à 10 ou passez à un compte Pro pour exécuter des traitements plus longs.

Foire aux questions (FAQ)

Le fichier vercel.json prévaut-il sur next.config.js ?▼

Oui. Les règles définies dans vercel.json sont appliquées au niveau du réseau edge avant même que la requête n'atteigne le moteur de routage de Next.js.

Les configurations sont-elles traitées uniquement dans le navigateur ?▼

Oui. L'analyse syntaxique, la validation du schéma et l'exportation JSON s'exécutent intégralement en mémoire dans le navigateur sans transmission réseau externe.

Quelle est la différence entre rewrites et redirects dans vercel.json ?▼

Les redirects renvoient un code HTTP (301/308) incitant le navigateur à changer d'URL, tandis que les rewrites relaient la requête en arrière-plan sans modifier l'URL visible.

Peut-on utiliser les tâches Cron avec le forfait Hobby gratuit ?▼

Oui, mais le forfait Hobby restreint l'exécution à une fois toutes les 24 heures. Les fréquences plus élevées (horaires ou par minutes) nécessitent un forfait Pro ou Enterprise.

Où doit-on placer le fichier vercel.json dans le projet ?▼

Placez vercel.json à la racine de votre dépôt ou à la racine du projet au sein d'un monorepo, au même niveau que le fichier package.json.

Outils et utilitaires connexes

Tous les outils →