vercel.json Builder
Vercel Cloud Deployment & Edge Routing

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

Referencia técnica para desarrolladores sobre vercel.json: enrutamiento edge, rewrites, cabeceras de seguridad, funciones serverless y tareas cron.

Vercel V2 Schema Compliant
Cero transmisión al servidor
Preajustes:

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 Reescrituras•1 Redirecciones•1 Tareas Cron

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

デプロイ準備スコア
100 / 100•Listo para producción

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

セキュリティ&キャッシュ設定状況
1 Bloques de encabezado•Clean URLs ACTIVADO

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

Ejecución Local de Conocimiento Cero

Todo el procesamiento, análisis y generación de código se ejecutan estrictamente en la memoria del navegador. Cero subidas a servidores externos.

Motor Reactivo de Submilisegundos

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

Production Ready Export

Clean, optimized output formats ready for immediate deployment.

Referencia técnica y guía de arquitectura

Guía de Configuración de Vercel.json — Guía de referencia

Referencia técnica para desarrolladores sobre vercel.json: enrutamiento edge, rewrites, cabeceras de seguridad, funciones serverless y tareas cron.

Parámetros clave y controles

cleanUrlsboolean | null

Elimina automáticamente las extensiones .html de las URL y redirige solicitudes con extensión mediante 308.

Por defecto: null
trailingSlashboolean | null

Impone o elimina barras diagonales finales de manera uniforme en todas las rutas mediante redirecciones 308.

Por defecto: null
rewritesRewriteRule[]

Matriz de reglas de proxy interno que asigna patrones de origen (source) a destinos (destination) sin alterar la barra de direcciones.

Por defecto: []
headersHeaderRule[]

Reglas de cabeceras HTTP personalizadas (CSP, HSTS, CORS) inyectadas en las respuestas de rutas coincidentes.

Por defecto: []
functionsFunctionRule[]

Configuración por ruta de funciones serverless, definiendo límites de memoria (128–3008 MB) y tiempo máximo de ejecución (maxDuration).

Por defecto: []
cronsCronRule[]

Tareas programadas que ejecutan endpoints de API utilizando expresiones cron estándar POSIX de 5 campos en UTC.

Por defecto: []

Consejos profesionales y mejores prácticas

Orden Estricto en Reglas Rewrite

Ubique las reglas de API y rutas específicas antes de los comodines genéricos (/(.*)). Vercel evalúa las reglas en orden descendente y se detiene en la primera coincidencia.

Cabeceras en Rutas Globales

Aplique cabeceras de seguridad globales como HSTS usando /((?!_next).*) para evitar anular las políticas de caché de archivos internos de Next.js.

Ajuste de Memoria Serverless

Configure maxDuration respetando los límites de su plan (10s en Hobby, hasta 300s en Pro) y asigne 1024 MB o más para cargas intensivas de CPU.

Zona Horaria UTC en Cron Jobs

Las tareas cron de Vercel operan exclusivamente en UTC. Calcule la diferencia horaria de su región para programar las ejecuciones en la hora local deseada.

Errores comunes y solución de problemas

Bucle de redirección infinito con trailingSlash y reglas manuales

Elimine redirecciones personalizadas que añadan o quiten barras finales cuando trailingSlash esté activo, ya que el motor edge de Vercel gestiona los códigos 308 de forma nativa.

Error de validación de esquema por expresiones cron de 6 campos

Vercel Cron solo admite el formato POSIX estándar de 5 campos (* * * * *). Elimine los campos de segundos o sintaxis Quartz heredada de entornos Java/AWS.

El valor maxDuration supera el límite permitido por el plan

Las cuentas del plan Hobby limitan maxDuration a 10 segundos. Reduzca el valor a 10 o actualice su espacio de trabajo a Pro para procesos prolongados.

Preguntas frecuentes (FAQ)

¿Sobrescribe vercel.json las redirecciones de next.config.js?▼

Sí. Las reglas de vercel.json se procesan en la infraestructura edge antes de que la solicitud llegue a la capa de enrutamiento de la aplicación Next.js.

¿Se procesa la configuración únicamente en la memoria local del navegador?▼

Sí. Toda la generación, análisis sintáctico y validación de esquemas se ejecuta localmente en el motor V8 del navegador sin enviar credenciales a servidores externos.

¿Cuál es la diferencia entre rewrites y redirects en vercel.json?▼

Redirects devuelve un código HTTP (301/308) forzando al navegador a cambiar de URL, mientras que rewrites envía la petición al destino de forma transparente sin alterar la URL visible.

¿Se pueden ejecutar tareas Cron en el plan Hobby gratuito de Vercel?▼

Sí, pero el plan Hobby restringe la ejecución a un máximo de una vez cada 24 horas. Frecuencias mayores (cada hora o cada 10 minutos) requieren un plan Pro o Enterprise.

¿Dónde se debe colocar el archivo vercel.json en el repositorio?▼

Guarde vercel.json en el directorio raíz de su repositorio o en la raíz del proyecto dentro de un monorepo, junto a package.json.

Herramientas y utilidades relacionadas

Todas las herramientas →