Ce opțiuni de implementare și ieșiri de compilare suportă Next.js?

Question

Accepted Answer

Next.js suportă mai multe ținte de implementare, controlate parțial de configurația **`output`**. Alegerea corectă depinde de faptul că aveți nevoie de server Node, containere sau gazdare pur statică.

## Modurile de ieșire de compilare

```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. Implicit (server Node) — caracteristici complete

Rulează un server Node.js, deci obțineți **totul**: SSR, ISR, Server Actions, Route Handlers, optimizare imagine, middleware. Aceasta este ceea ce folosesc platforme precum **Vercel** (creatorul Next.js, zero-config) și gazdele Node.

## 2. output: "standalone" — pentru Docker / auto-hosting

```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` produce un folder minimal cu doar dependențele efectiv utilizate, ideal pentru imagini Docker mici pe AWS, GCP, propriile servere, etc. Păstrați toate caracteristicile serverului.

## 3. output: "export" — complet static

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

Exportul static oferă cel mai ieftin, cel mai simplu hosting, dar **dezactivează caracteristicile serverului**: fără SSR, fără ISR, fără Route Handlers, fără Server Actions, fără optimizare imagine în timp real. Potrivit doar pentru site-uri complet statice.

## Alegere

```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
```

## Alte considerații

```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
```

## De ce este important

Implementarea nu este "o mărime pentru toți": modul `output` determină care caracteristici Next.js supraviețuiesc.

Știind că ieșirea **implicită/Node** păstrează toate capacitățile serverului, **standalone** le împachetează pentru auto-hosting/Docker, iar **export** schimbă toate caracteristicile serverului pentru gazdare pur statică, vă permite să potriviți compilarea infrastructurii dumneavoastră — și evitați capcana ca `output: "export"` să rupă în tăcere SSR/ISR/Server Actions.