Quais opções de implementação e saídas de compilação o Next.js suporta?

Question

Accepted Answer

Next.js suporta vários destinos de implantação, controlados parcialmente pela configuração **`output`**. A escolha certa depende de você precisar de um servidor Node, contêineres ou hospedagem estática pura.

## Os modos de saída de compilação

```js
// next.config.js
module.exports = {
  // output: undefined  → default: needs a Node.js server (full features)
  // output: "standalone" → self-contained folder for Docker/containers
  // output: "export"     → pure static HTML/CSS/JS (no server)
};
```

## 1. Padrão (servidor Node) — recursos completos

Executa um servidor Node.js, então você obtém **tudo**: SSR, ISR, Server Actions, Route Handlers, otimização de imagens, middleware. Isso é o que plataformas como **Vercel** (o criador do Next.js, zero-config) e hosts Node usam.

## 2. output: "standalone" — para Docker / auto-hospedagem

```dockerfile
# Next traces only the needed files into .next/standalone → a tiny, self-contained server
COPY --from=builder /app/.next/standalone ./
CMD ["node", "server.js"]
```

`standalone` produz uma pasta mínima com apenas as dependências realmente usadas, ideal para pequenas imagens Docker em AWS, GCP, seus próprios servidores, etc. Você mantém todos os recursos do servidor.

## 3. output: "export" — totalmente estático

```text
next build → out/  (plain HTML/CSS/JS, deployable to any static host: S3, GitHub Pages, Netlify CDN)
```

A exportação estática oferece hospedagem mais barata e simples, mas **desabilita recursos do servidor**: sem SSR, sem ISR, sem Route Handlers, sem Server Actions, sem otimização de imagens em tempo real. Adequado apenas para sites totalmente estáticos.

## Escolhendo

```text
Need SSR/ISR/Server Actions, want zero-config → Vercel (or a Node host) — default output
Want containers / self-host with full features → output: "standalone" + Docker
Purely static content (docs, marketing)        → output: "export" → any static CDN
```

## Outras considerações

```text
- Runtime choice (Edge vs Node) affects where functions run
- Self-hosting ISR/caching needs persistent storage or a shared cache
- Image optimization on non-Vercel hosts may need a custom loader
```

## Por que isso importa

A implantação não é tamanho único: o modo `output` determina quais recursos Next.js sobrevivem.

Saber que a saída **padrão/Node** mantém todos os recursos do servidor, **standalone** os empacota para auto-hospedagem/Docker, e **export** troca todos os recursos do servidor por hospedagem estática pura permite que você corresponda a compilação à sua infraestrutura — e evita a armadilha de `output: "export"` silenciosamente quebrar SSR/ISR/Server Actions.