Welche Deployment-Optionen und Build-Ausgaben unterstützt Next.js?

Question

Accepted Answer

Next.js unterstützt mehrere Deployment-Ziele, teilweise gesteuert durch die **`output`**-Konfiguration. Die richtige Wahl hängt davon ab, ob Sie den Node-Server, Container oder reines statisches Hosting benötigen.

## Warum es wichtig ist

Deployment ist nicht universell: Der `output`-Modus bestimmt, welche Next.js-Features überleben.

Wenn Sie wissen, dass die **Standard/Node**-Ausgabe alle Server-Funktionen behält, **standalone** sie für Docker/Self-Hosting verpackt und **export** alle Server-Features gegen reines statisches Hosting austauscht, können Sie den Build an Ihre Infrastruktur anpassen — und vermeiden Sie die Falle von `output: "export"`, das SSR/ISR/Server Actions stillschweigend bricht.

## Die Build-Output-Modi

```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. Standard (Node-Server) — volle Funktionen

Führt einen Node.js-Server aus, daher erhalten Sie **alles**: SSR, ISR, Server Actions, Route Handlers, Bildoptimierung, Middleware. Dies ist das, was Plattformen wie **Vercel** (der Hersteller von Next.js, Zero-Config) und Node-Hosts verwenden.

## 2. output: "standalone" — für Docker / Self-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` erstellt einen minimalen Ordner mit nur den tatsächlich verwendeten Abhängigkeiten, ideal für kleine Docker-Images auf AWS, GCP, Ihren eigenen Servern usw. Sie behalten alle Server-Features.

## 3. output: "export" — vollständig statisch

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

Statischer Export bietet das billigste, einfachste Hosting, **deaktiviert aber Server-Features**: kein SSR, kein ISR, keine Route Handlers, keine Server Actions, keine On-the-fly-Bildoptimierung. Nur für völlig statische Websites geeignet.

## Auswahl

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

## Weitere Überlegungen

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