Next.js hỗ trợ những tùy chọn deployment và build output nào?

Question

Accepted Answer

Next.js hỗ trợ vài đích deployment, được điều khiển một phần bởi cấu hình **`output`**. Lựa chọn đúng phụ thuộc vào việc bạn cần Node server, container, hay hosting tĩnh thuần.

## Các chế độ build output

```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. Mặc định (Node server) — đầy đủ tính năng

Chạy một Node.js server, nên bạn có **mọi thứ**: SSR, ISR, Server Actions, Route Handlers, tối ưu image, middleware. Đây là cái mà các nền tảng như **Vercel** (nhà làm ra Next.js, zero-config) và các Node host dùng.

## 2. output: "standalone" — cho Docker / self-hosting

```dockerfile
# Next trace chỉ các file cần thiết vào .next/standalone → một server nhỏ gọn, tự chứa
COPY --from=builder /app/.next/standalone ./
CMD ["node", "server.js"]
```

`standalone` tạo ra một thư mục tối thiểu chỉ với các dependency thực sự được dùng, lý tưởng cho các image Docker nhỏ trên AWS, GCP, server của bạn, v.v. Bạn giữ tất cả tính năng server.

## 3. output: "export" — tĩnh hoàn toàn

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

Static export cho hosting rẻ nhất, đơn giản nhất nhưng **tắt các tính năng server**: không SSR, không ISR, không Route Handlers, không Server Actions, không tối ưu image on-the-fly. Chỉ phù hợp cho các site hoàn toàn tĩnh.

## Chọn lựa

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

## Các cân nhắc khác

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

## Tại sao điều này quan trọng

Deployment không phải một cỡ vừa cho tất cả: chế độ `output` quyết định tính năng Next.js nào sống sót.

Biết rằng output **mặc định/Node** giữ mọi khả năng server, **standalone** đóng gói chúng cho Docker/self-hosting, và **export** đánh đổi mọi tính năng server lấy hosting tĩnh thuần cho phép bạn khớp build với hạ tầng của mình — và tránh cái bẫy `output: "export"` âm thầm phá vỡ SSR/ISR/Server Actions.