Node.js、Next.js 與 Nuxt 應用程式。
Node.js 專案的偵測與啟動方式:Node 版本、套件管理工具、Next.js 與 Nuxt(伺服器或靜態)、SvelteKit、Astro、Express 等框架、PORT 變數與 Prisma 遷移。
含有 package.json 的儲存庫即為 Node.js 專案。我們會選定框架、套件管理工具與 Node 版本,進行建置並啟動——您只需要推送。
Node 版本與套件管理工具
- Node.js——依
package.json中的engines.node或.nvmrc決定:在 24、22、20、18 或 16 中選擇符合條件的最新版本。兩者皆無時,使用 Node.js 22。 - 套件管理工具——依鎖定檔決定:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn,否則為 npm(有package-lock.json時使用npm ci)。 - 建置——
package.json有build指令碼時執行它。
框架
| 框架 | 執行方式 |
|---|---|
| Next.js | 以伺服器執行(next start)——伺服器端渲染、API 路由與中介軟體都照常運作 |
使用 output: 'export' 的 Next.js | 以 out 中的靜態網站執行 |
| Nuxt | 以伺服器執行(.output/server/index.mjs) |
使用 ssr: false 與 generate 指令碼的 Nuxt | 以 .output/public 中的靜態網站執行 |
| SvelteKit | 使用 adapter-node 時以伺服器執行;使用 adapter-static 時以靜態網站執行 |
| Astro | 以靜態網站執行;使用 @astrojs/node 時以伺服器執行 |
| NestJS | 建置後執行 dist/main.js |
| Express、Fastify、Koa、Hono 與其他伺服器 | 執行 scripts.start 中的檔案(node server.js),其次為 main,再其次為 server.js、app.js、index.js 或 main.js |
純前端專案——Vite、Create React App、Angular、Vue CLI 等——會以靜態網站提供;請參閱靜態網站。
監聽 PORT
伺服器必須在所有介面上監聽 PORT 變數中的連接埠:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js 與 Nuxt 會自行處理。若您的應用程式監聽固定的連接埠,將無法接收訪客——部署會在啟動檢查時停止,先前的版本會繼續執行。
建置時的值
變數分頁中的變數會傳給執行中的應用程式,而不是建置過程。建置時寫入用戶端程式碼的值——例如 Next.js 的 NEXT_PUBLIC_… 或 VITE_…——會從您的儲存庫讀取,例如從已提交的 .env.production 檔案。伺服器端程式碼則照常讀取變數分頁。
自訂啟動指令
若偵測到的啟動方式不符合需求,請設定設定 → 建置設定 → 啟動指令,例如 node dist/server.js 或 npm run start:prod。安裝與建置指令也可以在這裡變更。
資料庫與 Prisma
在專案中新增 PostgreSQL 或 MySQL,並讀取 DATABASE_URL——它會自動設定。若相依套件中有 Prisma,建議的發布指令是 npx prisma migrate deploy:它在每次部署時、新版本接收訪客之前執行。請參閱部署。
使用 BullMQ 處理佇列時,請新增 Valkey 並使用 REDIS_URL。將佇列工作程序作為背景工作程序執行——在程序分頁,或作為擁有自己資源的獨立服務。請參閱專案的服務。
部署後仍保留的檔案
每次部署都從儲存庫的全新副本開始。應用程式寫入 /data 的檔案會在部署之間保留並每日備份;寫入其他位置的內容會在下次部署後消失。上傳檔案與媒體通常更適合使用物件儲存。
Monorepo
若儲存庫包含多個專案,請在建立應用程式時設定專案資料夾(例如 apps/web)。同一儲存庫的另一個資料夾可以作為獨立的網頁服務執行——請參閱專案的服務。