Next.js hangi dağıtım seçeneklerini ve derleme çıktılarını destekler?

Question

Accepted Answer

Next.js, **`output`** yapılandırması tarafından kısmen kontrol edilen birkaç dağıtım hedefini destekler. Doğru seçim, Node sunucusu, kapsayıcılar veya tamamen statik barındırmaya ihtiyacınız olup olmadığına bağlıdır.

## Derleme çıkış modları

```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. Varsayılan (Node sunucusu) — tam özellikler

Node.js sunucusu çalıştırırken **tümünü** elde edersiniz: SSR, ISR, Server Actions, Route Handlers, görüntü optimizasyonu, middleware. Bu, **Vercel** (Next.js'nin yaratıcısı, sıfır yapılandırması) ve Node barındırıcıları gibi platformlar tarafından kullanılır.

## 2. output: "standalone" — Docker / kendi kendine barındırma için

```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`, yalnızca gerçekten kullanılan bağımlılıkları içeren minimum bir klasör üretir, AWS, GCP, kendi sunucularınız vb. üzerinde küçük Docker görüntüleri için idealdir. Tüm sunucu özelliklerini korursunuz.

## 3. output: "export" — tamamen statik

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

Statik dışa aktarma, en ucuz, en basit barındırmayı sağlar ancak **sunucu özelliklerini devre dışı bırakır**: SSR yok, ISR yok, Route Handlers yok, Server Actions yok, anında görüntü optimizasyonu yok. Yalnızca tamamen statik siteler için uygundur.

## Seçim yapma

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

## Diğer hususlar

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

## Neden önemli

Dağıtım herkes için tek boyutlu değildir: `output` modu hangi Next.js özelliklerinin hayatta kalacağını belirler.

**varsayılan/Node** çıktısının tüm sunucu yeteneklerini koruduğunu, **standalone**'ın bunları Docker/kendi kendine barındırma için paketlediğini ve **export**'un tüm sunucu özelliklerini tamamen statik barındırma için değiş tokuş ettiğini bilmek, derlemeyi altyapınıza uymanıza olanak tanır — ve `output: "export"` öğesinin SSR/ISR/Server Actions'ı sessizce kıracağı tuzaktan kaçınır.