立即開始

Node.js、Next.js 與 Nuxt 應用程式。

Node.js 專案的偵測與啟動方式:Node 版本、套件管理工具、Next.js 與 Nuxt(伺服器或靜態)、SvelteKit、Astro、Express 等框架、PORT 變數與 Prisma 遷移。

1 分鐘閱讀

含有 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)。同一儲存庫的另一個資料夾可以作為獨立的網頁服務執行——請參閱專案的服務。

還有問題嗎?

和我們對談——AI 會立即回覆,需要時由工程師加入,全天候服務。

聯絡客服