Jaké možnosti nasazení a výstupy buildů Next.js podporuje?

Question

Accepted Answer

Next.js podporuje několik cílů nasazení, které jsou částečně řízeny konfigurací **`output`**. Správná volba závisí na tom, zda potřebujete Node server, kontejnery nebo čistě statický hosting.

## Režimy výstupu buildů

```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. Výchozí (Node server) — plné funkce

Spouští Node.js server, takže máte **všechno**: SSR, ISR, Server Actions, Route Handlers, optimalizaci obrázků, middleware. To je to, co používají platformy jako **Vercel** (tvůrce Next.js, bez konfigurace) a Node hosty.

## 2. output: "standalone" — pro Docker / vlastní 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` vytvoří minimální složku pouze se skutečně používanými závislostmi, ideální pro malé Docker image na AWS, GCP, vašich vlastních serverech atd. Zachováváte všechny serverové funkce.

## 3. output: "export" — zcela statický

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

Statické exportování poskytuje nejlevnější a nejjednodušší hosting, ale **vypíná serverové funkce**: žádné SSR, žádné ISR, žádné Route Handlers, žádné Server Actions, žádná optimalizace obrázků za chodu. Vhodné pouze pro zcela statické weby.

## Výběr

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

## Další úvahy

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

## Proč na tom záleží

Nasazení není jednotné řešení: režim `output` určuje, které funkce Next.js zůstávají.

Vědomí, že výstup **default/Node** zachovává všechny serverové schopnosti, **standalone** je balí pro Docker/vlastní hosting a **export** vyměňuje všechny serverové funkce za čistě statický hosting vám umožňuje přizpůsobit build vaší infrastruktuře — a vyhnout se pasti `output: "export"`, která tiše přeruší SSR/ISR/Server Actions.