Bắt đầu

Ứng dụng Node.js, Next.js và Nuxt.

Cách nhận diện và khởi chạy dự án Node.js: phiên bản Node, trình quản lý gói, Next.js và Nuxt (server hoặc tĩnh), SvelteKit, Astro, Express và các framework khác, biến PORT và migration Prisma.

3 PHÚT ĐỌC

Repository có package.json là dự án Node.js. Chúng tôi xác định framework, trình quản lý gói và phiên bản Node, build và khởi chạy — bạn chỉ cần push.

Phiên bản Node và trình quản lý gói

  • Node.js — lấy từ engines.node trong package.json hoặc từ .nvmrc: phiên bản mới nhất phù hợp trong 24, 22, 20, 18 hoặc 16. Nếu không có cả hai, dùng Node.js 22.
  • Trình quản lý gói — theo tệp lock: pnpm-lock.yaml → pnpm, yarn.lock → yarn, còn lại là npm (npm ci khi có package-lock.json).
  • Build — script build, nếu package.json có.

Framework

FrameworkCách chạy
Next.jsdưới dạng server (next start) — render phía server, API route và middleware hoạt động như bình thường
Next.js với output: 'export'dưới dạng website tĩnh từ out
Nuxtdưới dạng server (.output/server/index.mjs)
Nuxt với ssr: false và script generatedưới dạng website tĩnh từ .output/public
SvelteKitdưới dạng server với adapter-node; với adapter-static là website tĩnh
Astrodưới dạng website tĩnh; với @astrojs/node là server
NestJSdist/main.js sau khi build
Express, Fastify, Koa, Hono và các server kháctệp trong scripts.start (node server.js), nếu không thì main, nếu không thì server.js, app.js, index.js hoặc main.js

Dự án chỉ có front-end — Vite, Create React App, Angular, Vue CLI và các loại khác — được phục vụ dưới dạng website tĩnh; xem Website tĩnh.

Lắng nghe trên PORT

Server phải lắng nghe trên cổng trong biến PORT, trên mọi interface:

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

Next.js và Nuxt tự làm việc này. Nếu ứng dụng lắng nghe trên một cổng cố định, nó sẽ không nhận được lượt truy cập — khi đó lần deploy dừng ở bước kiểm tra khởi động và phiên bản trước vẫn tiếp tục chạy.

Giá trị lúc build

Biến từ tab Variables được truyền cho ứng dụng đang chạy, không truyền cho quá trình build. Các giá trị mà build ghi vào mã phía client — như NEXT_PUBLIC_… trong Next.js hoặc VITE_… — được đọc từ repository của bạn, ví dụ từ tệp .env.production đã commit. Mã phía server vẫn đọc tab Variables như bình thường.

Lệnh khởi động riêng

Nếu cách khởi động được nhận diện không như ý, hãy đặt Cài đặt → Build settings → Start command, ví dụ node dist/server.js hoặc npm run start:prod. Lệnh cài đặt và build cũng có thể đổi tại đó.

Cơ sở dữ liệu và Prisma

Thêm PostgreSQL hoặc MySQL vào dự án và đọc DATABASE_URL — biến này được đặt sẵn cho bạn. Khi có Prisma trong dependency, lệnh release được đề xuất là npx prisma migrate deploy: lệnh chạy ở mỗi lần deploy, trước khi phiên bản mới nhận lượt truy cập. Xem Deploy.

Với queue dùng BullMQ, hãy thêm Valkey và dùng REDIS_URL. Chạy queue worker như một background worker — ở tab Processes, hoặc như một service riêng có tài nguyên riêng. Xem Các service của dự án.

Tệp được giữ qua các lần deploy

Mỗi lần deploy bắt đầu từ một bản sao mới của repository. Tệp ứng dụng ghi vào /data được giữ qua các lần deploy và sao lưu hằng ngày; mọi thứ ghi ở nơi khác sẽ mất sau lần deploy tiếp theo. Với tệp tải lên và media, object storage thường là lựa chọn tốt hơn.

Monorepo

Với repository chứa nhiều dự án, hãy đặt Project folder khi tạo ứng dụng (ví dụ apps/web). Một thư mục khác trong cùng repository có thể chạy như một web service riêng — xem Các service của dự án.

Vẫn còn vướng mắc?

Chat với chúng tôi — AI trả lời ngay và kỹ sư tham gia khi cần, bất kể giờ nào trong ngày.

Liên hệ hỗ trợ