vercel.json Builder
Vercel Cloud Deployment & Edge Routing

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

Referência técnica de vercel.json para desenvolvedores: roteamento de borda, rewrites, cabeçalhos de segurança, funções serverless e rotinas cron.

Vercel V2 Schema Compliant
Zero transmissão ao servidor
Predefinições:

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 Reescritas•1 Redirecionamentos•1 Tarefas Cron

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

デプロイ準備スコア
100 / 100•Pronto para produção

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

セキュリティ&キャッシュ設定状況
1 Blocos de cabeçalho•Clean URLs ATIVADO

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

Execução Local Zero-Knowledge

Todo o processamento, análise e geração de código ocorrem estritamente na memória do seu navegador. Zero uploads para servidores externos.

Motor Reativo de Submilissegundos

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

Production Ready Export

Clean, optimized output formats ready for immediate deployment.

Referência técnica e guia de arquitetura

Vercel構成ファイル (vercel.json) ビルダー — Guia de referência

Referência técnica de vercel.json para desenvolvedores: roteamento de borda, rewrites, cabeçalhos de segurança, funções serverless e rotinas cron.

Parâmetros principais e controles

cleanUrlsboolean | null

Remove extensões .html das URLs e redireciona automaticamente requisições com extensão para rotas limpas via HTTP 308.

Padrão: null
trailingSlashboolean | null

Aplica ou remove barras finais em todas as URLs por meio de redirecionamentos 308 automáticos na rede de borda.

Padrão: null
rewritesRewriteRule[]

Lista de regras de proxy que mapeiam origens (source) para destinos internos (destination) sem alterar a barra de endereços.

Padrão: []
headersHeaderRule[]

Regras de cabeçalhos HTTP personalizados (como CSP, HSTS e CORS) injetados nas respostas de rotas correspondentes.

Padrão: []
functionsFunctionRule[]

Configurações individuais de funções serverless, definindo alocação de memória (128–3008 MB) e tempo limite (maxDuration).

Padrão: []
cronsCronRule[]

Agendamentos automáticos de tarefas em segundo plano para rotas de API utilizando a sintaxe cron POSIX padrão de 5 campos em UTC.

Padrão: []

Dicas profissionais e melhores práticas

Ordem Estrita de Regras Rewrite

Declare rotas específicas e proxies de API antes de padrões genéricos (/(.*)). A Vercel processa as regras de cima para baixo e interrompe a avaliação na primeira correspondência.

Cabecalhos HTTP com Wildcard

Configure cabeçalhos como Strict-Transport-Security no padrão /((?!_next).*) para proteger páginas sem interferir no cache dos arquivos internos do Next.js.

Ajuste de Memoria Serverless

Respeite o limite do seu plano para maxDuration (10s no Hobby, até 300s no Pro) e dimensione a memória para 1024 MB ou mais em operações intensivas de CPU.

Fuso Horario UTC no Cron Job

Todas as expressões cron na Vercel usam UTC. Calcule o deslocamento de fuso da sua região para garantir a execução no horário local esperado.

Problemas comuns e solução de problemas

Loop de redirecionamento infinito com trailingSlash e regras manuais

Remova regras manuais de redirecionamento que manipulem barras finais quando trailingSlash estiver configurado, pois a borda da Vercel aplica códigos 308 de forma nativa.

Falha de validação de esquema com expressões cron de 6 campos

O Vercel Cron aceita unicamente o padrão POSIX de 5 campos (* * * * *). Exclua colunas de segundos ou expressões específicas do Quartz/AWS.

Valor maxDuration excede a cota do plano Vercel atual

Contas Hobby limitam maxDuration a 10 segundos. Ajuste o valor para no máximo 10 ou realize upgrade para o plano Pro para rotinas mais longas.

Perguntas frequentes (FAQ)

O vercel.json tem prioridade sobre as rotas do next.config.js?▼

Sim. Regras declaradas no vercel.json são avaliadas na camada edge de infraestrutura antes que as requisições cheguem ao roteamento interno do Next.js.

As configurações são geradas e validadas localmente no navegador?▼

Sim. Todo o processamento, validação de esquemas e exportação ocorrem inteiramente na memória do navegador sem envio de parâmetros a servidores externos.

Qual a diferença prática entre rewrites e redirects no vercel.json?▼

Redirects retornam status HTTP (301/308) fazendo o navegador mudar a URL visível, enquanto rewrites repassam a requisição ao destino de forma transparente sem alterar a URL.

É possível executar Vercel Cron jobs no plano Hobby gratuito?▼

Sim, porém o plano Hobby restringe a execução para no máximo uma vez a cada 24 horas. Frequências menores exigem contratação de plano Pro ou Enterprise.

Onde o arquivo vercel.json deve ser salvo no repositório?▼

Salve o arquivo vercel.json no diretório raiz do repositório ou na raiz do pacote de um monorepo, no mesmo nível do package.json.

Ferramentas e utilitários relacionados

Todas as ferramentas →