Ứ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.
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.nodetrongpackage.jsonhoặ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 cikhi cópackage-lock.json). - Build — script
build, nếupackage.jsoncó.
Framework
| Framework | Cách chạy |
|---|---|
| Next.js | dướ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 |
| Nuxt | dưới dạng server (.output/server/index.mjs) |
Nuxt với ssr: false và script generate | dưới dạng website tĩnh từ .output/public |
| SvelteKit | dưới dạng server với adapter-node; với adapter-static là website tĩnh |
| Astro | dưới dạng website tĩnh; với @astrojs/node là server |
| NestJS | dist/main.js sau khi build |
| Express, Fastify, Koa, Hono và các server khác | tệ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.