Next.js รองรับตัวเลือกการปรับใช้และผลผลิตการสร้างใด?

Question

Accepted Answer

Next.js รองรับเป้าหมายการปรับใช้หลายประการ ซึ่งควบคุมบางส่วนด้วยการกำหนดค่า **`output`** ตัวเลือกที่ถูกต้องขึ้นอยู่กับว่าคุณต้องการเซิร์ฟเวอร์ Node คอนเทนเนอร์ หรือการโฮสต์แบบคงที่โดยสิ้นเชิง

## โหมดเอาต์พุตการสร้าง

```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. ค่าเริ่มต้น (เซิร์ฟเวอร์ Node) — ฟีเจอร์ครบถ้วน

เรียกใช้เซิร์ฟเวอร์ Node.js ดังนั้นคุณจะได้ **ทุกอย่าง**: SSR, ISR, Server Actions, Route Handlers, การปรับปรุงรูปภาพ, middleware นี่คือสิ่งที่แพลตฟอร์มเช่น **Vercel** (ผู้สร้าง Next.js, ไม่ต้องกำหนดค่า) และโฮสต์ Node ใช้

## 2. output: "standalone" — สำหรับ Docker / โฮสต์ด้วยตนเอง

```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` สร้างโฟลเดอร์ขั้นต่ำที่มีเฉพาะการพึ่งพาที่ใช้จริง ซึ่งเหมาะสำหรับอิมเมจ Docker ขนาดเล็กบน AWS, GCP, เซิร์ฟเวอร์ของคุณเอง เป็นต้น คุณเก็บรักษาฟีเจอร์เซิร์ฟเวอร์ทั้งหมด

## 3. output: "export" — คงที่อย่างสมบูรณ์

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

การส่งออกแบบคงที่ให้การโฮสต์ที่ถูกและง่ายที่สุด แต่ **ปิดใช้ฟีเจอร์เซิร์ฟเวอร์**: ไม่มี SSR ไม่มี ISR ไม่มี Route Handlers ไม่มี Server Actions ไม่มีการปรับปรุงรูปภาพแบบทันที เหมาะเฉพาะสำหรับไซต์แบบคงที่โดยสิ้นเชิง

## การเลือก

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

## ข้อพิจารณาอื่น ๆ

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

## เหตุใดจึงสำคัญ

การปรับใช้ไม่ได้มีขนาดเดียวสำหรับทุกคน: โหมด `output` กำหนดว่าฟีเจอร์ Next.js ใดที่ยังคงอยู่

การรู้ว่าเอาต์พุต **ค่าเริ่มต้น/Node** รักษาความสามารถของเซิร์ฟเวอร์ทั้งหมด **standalone** บรรจุสำหรับ Docker/โฮสต์ด้วยตนเอง และ **export** แลกเปลี่ยนฟีเจอร์เซิร์ฟเวอร์ทั้งหมดสำหรับการโฮสต์แบบคงที่โดยสิ้นเชิง ช่วยให้คุณจับคู่การสร้างกับโครงสร้างพื้นฐานของคุณ — และหลีกเลี่ยงการติดขัดของ `output: "export"` ที่ทำลาย SSR/ISR/Server Actions โดยปsilent