Capítulo 292 de 456

Deploying

Core Idea

Next.js pode ser deployado como servidor Node.js, container Docker, static export, ou via Adapter API pra plataformas customizadas, cada opção com suporte de feature diferente.

Key Concepts

  • Node.js server: next build + next start; suporta todas as features do Next.js. Requer scripts build/start no package.json.
  • Docker: suporta todas as features; recomenda-se output: "standalone" pra imagem mínima. Em dev no Mac/Windows, preferir next dev local em vez de Docker por performance.
  • Static export: gera HTML/CSS/JS estático servível em qualquer host (S3, Nginx, Apache); suporte limitado (não roda features que exigem servidor).
  • Adapters (Deployment Adapter API): permite plataformas customizarem build/deploy; "Verified Adapters" (Vercel, Bun) são open source e rodam a suite de compatibilidade oficial.

Reference Tables

Deployment OptionFeature Support
Node.js serverAll
Docker containerAll
Static exportLimited
AdaptersVaries (verified adapters run the test suite)

Anti-patterns

  • Usar Docker pra dev diário no Mac/Windows: performance pior que next dev local; Docker é recomendado pra produção.
  • Esperar suporte total em static export: features que exigem servidor (rotas dinâmicas server-side, etc.) não funcionam.

Key Takeaways

  1. Node.js server e Docker são as únicas opções com suporte total a todas as features.
  2. Static export é o caminho pra hospedagem puramente estática, mas com trade-off de features.
  3. Verified Adapters (Vercel, Bun) passam pela suite oficial de compatibilidade; outras integrações (Cloudflare, Netlify) não são verificadas pelo time Next.js.

Connects To

  • ch293 Guides (index): Self-Hosting e Static Exports detalham cada opção citada aqui.
AnteriorCSSPróximoGuides