【Next.js】 部署模式總覽

下面整理 Next.js 的主要部署類型、每種模式的特性與常見應用場景，並特別解釋 standalone 是什麼以及它適合的情境。

1️⃣ Next.js 部署模式總覽

註：模式之間可以組合，例如 Node Server + Standalone、Vercel Serverless + Edge Middleware。

2️⃣ 各模式詳解

① Node Server (預設)

• 啟動：next build && next start

• 產物：.next/ 目錄

• 特性：完整支援 SSR、ISR、API Routes。

• 適用：自行管理伺服器（EC2、Kubernetes、Docker Swarm、Heroku…）。

• 優缺：最彈性，但部署包體積較大，需要完整 node_modules。

② Standalone ⭐

• 設定：

  // next.config.js
  module.exports = {
    output: 'standalone',
  }
  

• 產物：

  .next/standalone      # 精簡 Node 專案，可直接 node server.js
  .next/static          # 靜態資源
  

• 原理：

  • next build 會分析依賴，只把執行需要的檔案、node_modules 打包進 standalone。

  • 不再需要完整專案原始碼，也不必把整個 node_modules 打進 Docker。

• 適用場景：

  • Docker / 容器化：
    只複製 .next/standalone + .next/static，image 更小、build 更快。

  • Kubernetes / ECS：
    配合多階段 Docker build，把 RUN npm ci 階段與最終執行環境分離。

• 功能：與 Node Server 相同（SSR / ISR / API Routes 全支援）。

③ Static Export

• 指令：next build && next export

• 產物：out/ 完全靜態

• 限制：無 SSR、無 API Routes、無 ISR。

• 適用：

  • 部落格、說明文件、Landing Page

  • 部署到任何靜態空間（S3+CloudFront、GitHub Pages、Netlify）。

④ Edge Runtime / Middleware

• 用法：在頁面或 route handler 中 export const runtime = 'edge'

• 部署：Vercel Edge Functions、Cloudflare Workers、Deno Deploy。

• 特性：全球節點極低延遲；不能用 Node built-ins。

• 適用：

  • 驗證/權限檢查

  • A/B 測試、URL 轉向

  • 即時 Header/Cookie 操作

⑤ Serverless Functions (Vercel / AWS Lambda)

• 部署：Vercel 自動化，或 serverless-http 將 Next 整包轉為 Lambda。

• 特性：

  • 每個頁面/路由轉成獨立 Lambda。

  • 自動擴展、免維運。

• 適用：

  • 高併發但流量不穩定。

  • 只需 Node 短期計算、不需長連線。

⑥ Custom Server

• 方式：建立 server.js

  const express = require('express')
  const next = require('next')
  const app = next({ dev: false })
  const handle = app.getRequestHandler()
  app.prepare().then(() => {
    const server = express()
    server.get('/health', (req, res) => res.send('ok'))
    server.all('*', (req, res) => handle(req, res))
    server.listen(3000)
  })
  

• 適用：

  • 需要與既有 Node 架構整合。

  • 自訂路由、中介層或 WebSocket。

3️⃣ 如何選擇

✅ 總結

• Standalone 是 Node Server 模式的輕量化打包，非常適合容器化部署。

• 如果要保留完整 SSR、ISR、API Routes，又希望 映像檔小、啟動快，選 Standalone 幾乎是最佳解。

• 其他模式（Static Export、Edge、Serverless）則依你的應用是否需要即時運算、全球分佈或純靜態內容來決定。

📊 Next.js 部署模式功能支援度

📌 補充說明

• Static Export：因為沒有 Node 伺服器 → 無法即時渲染（SSR）、無法再生（ISR）、無 API Routes。

• Edge Runtime：

  • 可以做 SSR（例如 Server Components 即時抓資料），但無 Node API（不能用 fs、原生 DB drivers）。

  • 適合處理 Header、Cookie、權限驗證、低延遲資料讀取。

• Serverless Functions：Vercel/AWS 會把 SSR/ISR/API Route 拆成獨立 Function → 自動擴展，但要注意冷啟動與 DB 連線池。

🎯 總結

• 要完整功能（SSR/ISR/API Routes） → 用 Node Server 或 Standalone。

• 要純靜態內容 → 用 Static Export。

• 要全球低延遲 → 用 Edge Runtime（但功能有限制）。

• 要免維運，自動擴展 → 用 Serverless Functions（Vercel、AWS Lambda）。