不用寫 Dockerfile
平台從 package.json 認出 Nuxt,自動決定建置與啟動指令,並列出程式讀的環境變數。
Nuxt 部署教學 · Agent Lab 部署
Nuxt 專案原樣上傳,不用寫 Dockerfile,或直接跟 Claude Code、Codex、Cursor 說「部署上去」。Agent Lab 把它建成web service,全站靜態時則是放在 CDN 的網頁,每一版都有預覽網址、可以回退,上傳時先檢查外洩的金鑰;App 與資料庫跑在 Google Cloud 台灣。
> 把這個 Nuxt 專案部署上去
sites_createmy-nuxt
sites_deploy偵測到 Nuxt
sites_deploy_status建置完成 · 金鑰檢查通過
已上線:my-nuxt--acme.hosting.agentlab.run
為什麼把 Nuxt 放在 Agent Lab
JavaScript/TypeScript 專案,直接從原始碼建置、不用 Dockerfile,部署成web service,全站靜態時則是放在 CDN 的網頁。
平台從 package.json 認出 Nuxt,自動決定建置與啟動指令,並列出程式讀的環境變數。
每次上傳都是新的一版,有自己的網址。先看過再上線,出問題一鍵切回任何一版。
上線前先檢查 API 金鑰與憑證;機密放在主控台,不放在程式碼裡。
建好資料庫接上去,連線自動寫進 App 的環境變數,密碼不會顯示。
怎麼選
表格可以左右滑動。
| 你在意的事 | Agent Lab 部署 | 自己租 VPS |
|---|---|---|
| 設定方式 | 上傳或說一句話,不用 Dockerfile | SSH、裝執行環境、程序管理、反向代理 |
| HTTPS 與網域 | 自動;付費方案可接自訂網域 | 自己弄 Certbot 與 DNS |
| 預覽與回退 | 每一版都有自己的網址,一鍵回退 | 自己寫腳本 |
| 上線前檢查 | 上傳時檢查外洩的金鑰 | 自己沒設就沒有 |
| 資料庫 | 一鍵建 PostgreSQL,連線自動寫進 App | 自己安裝、自己備份 |
| 起步費用 | Free 方案 NT$0,1 個 S 應用程式(閒置休眠) | VPS 每月約 NT$200–600,加上你的時間 |
步驟
package.json 放在專案最上層,lockfile 要一起提交;不要帶 node_modules、.git、dist、.env。
把資料夾拖進專案的部署分頁、從 GitHub 推送,或透過 Agent Lab MCP 叫 AI 工具做。
平台建置這一版並檢查外洩金鑰;它列出的機密到設定頁填。
第一版建好就上線;之後每一版先有預覽網址,確認後再上線。
設定
平台會讀 nuxt.config 的 runtimeConfig,列出程式需要的環境變數,哪些是機密、哪些要建置時就給,部署前一目了然。 NUXT_PUBLIC_ 開頭的值會送到瀏覽器,不能放金鑰。
# Agent Lab 偵測到 Nuxt 後執行
# What Agent Lab runs once it detects Nuxt
npm ci
npm run build # nuxt build(Nitro node-server)
node .output/server/index.mjs # 監聽 $PORT(預設 8080)
# nuxt generate 的純靜態網站 → 改成靜態網頁,放 CDNPORT 平台給的埠號(預設 8080),伺服器要監聽它。NUXT_* runtimeConfig 的鍵會自動對應,例如 runtimeConfig.apiSecret → NUXT_API_SECRET。NUXT_SESSION_PASSWORD 用 nuxt-auth-utils 時,在主控台一鍵產生(至少 32 字元)。DATABASE_URL 接上 Agent Lab 的 PostgreSQL 時自動寫入。讀 https://app.agentlab.cresclab.com/agent/deploy.md,把這個 Nuxt 專案部署到 Agent Lab。先給我建置計畫和需要的環境變數,機密告訴我去主控台哪裡填,上線前等我確認。常見問題