vercel.json Builder
Vercel Cloud Deployment & Edge Routing

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

Entwickler-Referenz für vercel.json: Edge-Routing, Rewrites, Sicherheits-Header, Serverless Functions und Cron-Jobs nach Produktionsstandard.

Vercel V2 Schema Compliant
Null Serverübertragung
Voreinstellungen:

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 Umschreibungen•1 Weiterleitungen•1 Cron-Jobs

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

デプロイ準備スコア
100 / 100•Produktionsbereit

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

セキュリティ&キャッシュ設定状況
1 Header-Blöcke•Clean URLs AKTIV

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

Zero-Knowledge Lokale Ausführung

Alle Datenverarbeitungen, Parsen und Generierungen laufen streng im lokalen Browserspeicher ab. Keine externen Server-Uploads.

Sub-Millisekunden AST-Engine

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

Production Ready Export

Clean, optimized output formats ready for immediate deployment.

Technische Referenz & Architektur-Leitfaden

Vercel構成ファイル (vercel.json) ビルダー — Referenz-Leitfaden

Entwickler-Referenz für vercel.json: Edge-Routing, Rewrites, Sicherheits-Header, Serverless Functions und Cron-Jobs nach Produktionsstandard.

Wichtige Parameter & Steuerelemente

cleanUrlsboolean | null

Entfernt automatisch .html-Dateiendungen aus URLs und leitet Pfade mit Endung per 308-Redirect auf die saubere Route um.

Standard: null
trailingSlashboolean | null

Erzwingt oder entfernt abschließende Schrägstriche konsistent über alle Pfade via automatische 308-Weiterleitungen.

Standard: null
rewritesRewriteRule[]

Array von Proxy-Routing-Regeln, die Quellpfade (source) intern auf Zielpfade (destination) umleiten, ohne die Browser-URL zu ändern.

Standard: []
headersHeaderRule[]

Regeln zur Definition benutzerdefinierter HTTP-Antwort-Header (z. B. CSP, HSTS, CORS) für übereinstimmende Pfadmuster.

Standard: []
functionsFunctionRule[]

Serverless-Konfigurationen pro Pfad zur Zuweisung von Speicher (128–3008 MB) und maximaler Ausführungsdauer (maxDuration).

Standard: []
cronsCronRule[]

Geplante Hintergrund-Aufrufe für API-Routen unter Verwendung standardmäßiger 5-teiliger POSIX-UTC-Cron-Ausdrücke.

Standard: []

Profi-Tipps & Best Practices

Strikte Rewrite-Reihenfolge

Platzieren Sie spezifische API- und Pfad-Rewrites immer vor globalen Wildcards (/(.*)). Vercel wertet Regeln sequenziell von oben nach unten aus und bricht beim ersten Treffer ab.

Globale Sicherheits-Header

Wenden Sie HSTS und CSP auf den Pfad /((?!_next).*) an, um Anwendungsseiten abzusichern, ohne das interne Asset-Caching von Next.js zu überschreiben.

Laufzeitlimits fuer Serverless

Passen Sie maxDuration an Ihr Kontingent an (10s im Hobby-Tarif, bis zu 300s auf Pro). Erhöhen Sie den Arbeitsspeicher auf 1024 MB oder mehr für rechenintensive Aufgaben.

UTC-Zeitzone fuer Cron-Jobs

Vercel führt Cron-Trigger ausschließlich in UTC aus. Berechnen Sie Zeitzonen-Offsets (z. B. UTC+1 / UTC+2 in Mitteleuropa) bei der Definition der Ausführungsstunde explizit ein.

Häufige Fallstricke & Fehlerbehebung

Endlose Weiterleitungsschleife durch trailingSlash und manuelle Redirects

Entfernen Sie manuelle Weiterleitungen, die Schrägstriche am Pfadende modifizieren, sobald trailingSlash auf true oder false gesetzt ist, da Vercels Edge-Ebene automatisch 308-Redirects erzeugt.

Cron-Ausdruck scheitert an Schemavalidierung bei 6-teiligen Werten

Vercel unterstützt ausschließlich den 5-teiligen POSIX-Standard (* * * * *). Entfernen Sie Sekunden-Angaben oder Quartz-spezifische Syntaxfragmente aus dem Cron-String.

maxDuration überschreitet das Limit des Vercel-Tarifs

Im kostenlosen Hobby-Tarif ist maxDuration auf maximal 10 Sekunden beschränkt. Reduzieren Sie den Wert auf 10 oder führen Sie ein Upgrade auf einen Pro-Workspace durch.

Häufig gestellte Fragen (FAQ)

Überschreibt vercel.json Weiterleitungen aus next.config.js?▼

Ja. Regeln in vercel.json werden direkt auf der globalen Edge-Infrastruktur verarbeitet, bevor Anfragen das Next.js-Anwendungsrouting erreichen.

Werden Konfigurationen vollständig im lokalen Browser verarbeitet?▼

Ja. Sämtliche Validierungen, Schemaprüfungen und Exporte laufen isoliert im lokalen Browser-Speicher ohne Netzwerkübertragung an externe Server.

Was unterscheidet rewrites von redirects in vercel.json?▼

Redirects antworten mit HTTP-Statuscodes (301/307/308) und aktualisieren die Browser-Adresszeile. Rewrites leiten die Anfrage transparent auf dem Server an das Ziel weiter.

Können Cron-Jobs im kostenlosen Vercel Hobby-Tarif genutzt werden?▼

Ja, allerdings erlaubt der Hobby-Tarif maximal eine Ausführung alle 24 Stunden. Kürzere Intervalle (stündlich oder minütlich) setzen einen Pro- oder Enterprise-Plan voraus.

An welcher Stelle im Projekt muss vercel.json abgelegt werden?▼

Platzieren Sie die vercel.json direkt im Wurzelverzeichnis Ihres Repositories auf derselben Ebene wie die package.json.

Verwandte Werkzeuge & Dienstprogramme

Alle Werkzeuge →