Opsi penerapan dan keluaran pembuatan apa yang didukung Next.js?

Question

Accepted Answer

Next.js mendukung beberapa target penerapan, dikontrol sebagian oleh konfigurasi **`output`**. Pilihan yang tepat tergantung pada apakah Anda memerlukan server Node, kontainer, atau hosting statis murni.

## Mode keluaran pembuatan

```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. Bawaan (server Node) — fitur lengkap

Menjalankan server Node.js, jadi Anda mendapat **semuanya**: SSR, ISR, Server Actions, Route Handlers, optimasi gambar, middleware. Ini adalah apa yang digunakan platform seperti **Vercel** (pembuat Next.js, tanpa konfigurasi) dan host Node.

## 2. output: "standalone" — untuk Docker / hosting mandiri

```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` menghasilkan folder minimal hanya dengan dependensi yang benar-benar digunakan, ideal untuk gambar Docker kecil di AWS, GCP, server Anda sendiri, dll. Anda mempertahankan semua fitur server.

## 3. output: "export" — sepenuhnya statis

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

Ekspor statis memberikan hosting termurah dan paling sederhana tetapi **menonaktifkan fitur server**: tidak ada SSR, tidak ada ISR, tidak ada Route Handlers, tidak ada Server Actions, tidak ada optimasi gambar real-time. Hanya cocok untuk situs sepenuhnya statis.

## Memilih

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

## Pertimbangan lainnya

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

## Mengapa ini penting

Penerapan bukan satu ukuran untuk semua: mode `output` menentukan fitur Next.js mana yang bertahan.

Mengetahui bahwa keluaran **bawaan/Node** mempertahankan semua kemampuan server, **standalone** mengemas mereka untuk Docker/hosting mandiri, dan **export** menukar semua fitur server untuk hosting statis murni memungkinkan Anda mencocokkan pembuatan dengan infrastruktur Anda — dan menghindari jebakan `output: "export"` yang diam-diam menghancurkan SSR/ISR/Server Actions.