Aplikasi Node.js, Next.js dan Nuxt.
Cara projek Node.js dikesan dan dimulakan: versi Node, pengurus pakej, Next.js dan Nuxt (pelayan atau statik), SvelteKit, Astro, Express dan lain-lain, pemboleh ubah PORT dan migrasi Prisma.
Repositori dengan package.json ialah projek Node.js. Kami memilih rangka kerja, pengurus pakej dan versi Node, membinanya dan memulakannya — anda hanya perlu push.
Versi Node dan pengurus pakej
- Node.js — diambil daripada
engines.nodedalampackage.jsonatau daripada.nvmrc: versi terbaharu antara 24, 22, 20, 18 atau 16 yang sesuai. Tanpa kedua-duanya, Node.js 22. - Pengurus pakej — mengikut fail lock:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, jika tidak npm (npm ciapabila adapackage-lock.json). - Binaan — skrip
build, apabilapackage.jsonmempunyainya.
Rangka kerja
| Rangka kerja | Cara ia dijalankan |
|---|---|
| Next.js | sebagai pelayan (next start) — pemaparan pelayan, laluan API dan middleware berfungsi seperti biasa |
Next.js dengan output: 'export' | sebagai laman statik daripada out |
| Nuxt | sebagai pelayan (.output/server/index.mjs) |
Nuxt dengan ssr: false dan skrip generate | sebagai laman statik daripada .output/public |
| SvelteKit | sebagai pelayan dengan adapter-node; dengan adapter-static, sebagai laman statik |
| Astro | sebagai laman statik; dengan @astrojs/node, sebagai pelayan |
| NestJS | dist/main.js selepas binaan |
| Express, Fastify, Koa, Hono dan pelayan lain | fail dalam scripts.start (node server.js), jika tiada main, jika tiada server.js, app.js, index.js atau main.js |
Projek front-end sahaja — Vite, Create React App, Angular, Vue CLI dan lain-lain — disajikan sebagai laman statik; lihat Laman statik.
Dengar pada PORT
Pelayan mesti mendengar pada port dalam pemboleh ubah PORT, pada semua antara muka:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js dan Nuxt melakukannya dengan sendiri. Jika aplikasi anda mendengar pada port tetap, ia tidak akan menerima pelawat — deploy kemudian berhenti pada semakan permulaan dan versi sebelumnya terus berjalan.
Nilai masa binaan
Pemboleh ubah daripada tab Pemboleh ubah sampai ke aplikasi yang sedang berjalan, bukan ke binaan. Nilai yang ditulis oleh binaan ke dalam kod klien — seperti NEXT_PUBLIC_… dalam Next.js atau VITE_… — dibaca daripada repositori anda, contohnya daripada fail .env.production yang di-commit. Kod sebelah pelayan membaca tab Pemboleh ubah seperti biasa.
Arahan mula anda sendiri
Jika cara permulaan yang dikesan bukan yang anda mahu, tetapkan Tetapan → Tetapan binaan → Arahan mula, contohnya node dist/server.js atau npm run start:prod. Arahan pemasangan dan binaan juga boleh ditukar di situ.
Pangkalan data dan Prisma
Tambahkan PostgreSQL atau MySQL pada projek dan baca DATABASE_URL — ia ditetapkan untuk anda. Dengan Prisma dalam kebergantungan anda, arahan keluaran yang disyorkan ialah npx prisma migrate deploy: ia dijalankan pada setiap deploy sebelum versi baharu menerima pelawat. Lihat Deploy.
Untuk baris gilir dengan BullMQ, tambahkan Valkey dan gunakan REDIS_URL. Jalankan pekerja baris gilir sebagai pekerja latar belakang — pada tab Proses, atau sebagai perkhidmatan berasingan dengan sumbernya sendiri. Lihat Perkhidmatan projek.
Fail yang kekal selepas deploy
Setiap deploy bermula daripada salinan baharu repositori anda. Fail yang ditulis oleh aplikasi anda ke /data disimpan antara deploy dan disandarkan setiap hari; apa-apa yang ditulis di tempat lain hilang selepas deploy seterusnya. Untuk muat naik dan media, storan objek biasanya pilihan yang lebih baik.
Monorepo
Untuk repositori dengan beberapa projek, tetapkan Folder projek semasa anda mencipta aplikasi (contohnya apps/web). Folder lain dalam repositori yang sama boleh dijalankan sebagai perkhidmatan web berasingan — lihat Perkhidmatan projek.