不用寫 Dockerfile
平台從 package.json 認出 Next.js，自動決定建置與啟動指令，並列出程式讀的環境變數。
Next.js 部署教學 · Agent Lab 部署
Next.js 部署，
說一句就上線。
Next.js 專案原樣上傳，不用寫 Dockerfile，或直接跟 Claude Code、Codex、Cursor 說「部署上去」。Agent Lab 把它建成web service，全站靜態時則是放在 CDN 的網頁，每一版都有預覽網址、可以回退，上傳時先檢查外洩的金鑰；App 與資料庫跑在 Google Cloud 台灣。
> 把這個 Next.js 專案部署上去
sites_createmy-nextjs
sites_deploy偵測到 Next.js
sites_deploy_status建置完成 · 金鑰檢查通過
已上線：my-nextjs--acme.hosting.agentlab.run
為什麼把 Next.js 放在 Agent Lab
不用自己顧主機，Next.js 就能上線
JavaScript／TypeScript 專案，直接從原始碼建置、不用 Dockerfile，部署成web service，全站靜態時則是放在 CDN 的網頁。
預覽、上線、回退
每次上傳都是新的一版，有自己的網址。先看過再上線，出問題一鍵切回任何一版。
外洩金鑰先擋下
上線前先檢查 API 金鑰與憑證；機密放在主控台，不放在程式碼裡。
一鍵加 PostgreSQL
建好資料庫接上去，連線自動寫進 App 的環境變數，密碼不會顯示。
怎麼選
Next.js 放 Agent Lab，還是自己租 VPS
表格可以左右滑動。
| 你在意的事 | Agent Lab 部署 | 自己租 VPS |
|---|---|---|
| 設定方式 | 上傳或說一句話，不用 Dockerfile | SSH、裝執行環境、程序管理、反向代理 |
| HTTPS 與網域 | 自動；付費方案可接自訂網域 | 自己弄 Certbot 與 DNS |
| 預覽與回退 | 每一版都有自己的網址，一鍵回退 | 自己寫腳本 |
| 上線前檢查 | 上傳時檢查外洩的金鑰 | 自己沒設就沒有 |
| 資料庫 | 一鍵建 PostgreSQL，連線自動寫進 App | 自己安裝、自己備份 |
| 起步費用 | Free 方案 NT$0，1 個 S 應用程式（閒置休眠） | VPS 每月約 NT$200–600，加上你的時間 |
步驟
四步把 Next.js 部署上線
準備專案
package.json 放在專案最上層，lockfile 要一起提交；不要帶 node_modules、.git、dist、.env。
上傳或說一句
把資料夾拖進專案的部署分頁、從 GitHub 推送，或透過 Agent Lab MCP 叫 AI 工具做。
建置與檢查
平台建置這一版並檢查外洩金鑰；它列出的機密到設定頁填。
預覽並上線
第一版建好就上線；之後每一版先有預覽網址，確認後再上線。
設定
Agent Lab 怎麼跑 Next.js
有 API route、Server Actions 或 SSR 的專案會變成 web service；設了 output: "export" 的會變成放在 CDN 的靜態網頁。 NEXT_PUBLIC_ 開頭的變數在建置時就寫死，改了要重新建置一版。 Monorepo（Turborepo、Nx）把整個 repo 上傳，在建置設定把 Root Directory 設成 apps/web。
建置與啟動
# Agent Lab 偵測到 Next.js 後執行
# What Agent Lab runs once it detects Next.js
npm ci # 依 lockfile 選 npm / pnpm / Yarn / Bun
npm run build # next build
npm start # next start，監聽 $PORT（預設 8080）
# next.config.js 設 output: "export" → 改成靜態網頁，放 CDNPORT平台給的埠號（預設 8080），伺服器要監聽它。NEXT_PUBLIC_*建置時寫進網頁，任何人都看得到，不能放金鑰。AUTH_SECRET用 Auth.js 時，在主控台一鍵產生隨機值。DATABASE_URL接上 Agent Lab 的 PostgreSQL 時自動寫入。
或叫 AI 工具做
讀 https://app.agentlab.cresclab.com/agent/deploy.md，把這個 Next.js 專案部署到 Agent Lab。先給我建置計畫和需要的環境變數，機密告訴我去主控台哪裡填，上線前等我確認。常見問題
Next.js 部署常見問題
部署 Next.js 需要 Dockerfile 嗎？
不用。Next.js 專案帶著 package.json 上傳，Agent Lab 會自動偵測、建置與啟動；如果最上層有 Dockerfile，就改用你的 Dockerfile。 看文件 →
Next.js 的 Image Optimization、Middleware 能用嗎？
以 web service 部署時，next start 本身就提供圖片最佳化與 Middleware，不需要另外設定。只用 output: "export" 的靜態網頁沒有伺服器，這兩個功能就不能用。
API 金鑰這類機密要放哪？
放在專案設定的 Secrets，程式用環境變數讀。session secret 這類隨機值可以在主控台直接產生，沒有人看得到。上傳裡如果被找到金鑰，會在上線前擋下來。
可以用 Claude Code 或 Codex 部署 Next.js 嗎？
可以。先接上 Agent Lab MCP（一行指令、瀏覽器登入、不用 API 金鑰），然後說「把這個 Next.js 專案部署上去」。工具會建專案、上傳、等建置完成，上線前先問你。 接上 MCP →
Next.js 可以免費部署嗎？
Free 方案 NT$0：1 個 S 應用程式（閒置 15 分鐘休眠）、1 個 S 資料庫、3 個靜態網頁、每月 100 分鐘建構、5 GB 流量，到上限就暫停、不會收費。要常駐、接自訂網域，Pro 每月 NT$990（未稅）。 看定價 →