Mulakan

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.

3 MIN BACAAN

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.node dalam package.json atau 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 ci apabila ada package-lock.json).
  • Binaan — skrip build, apabila package.json mempunyainya.

Rangka kerja

Rangka kerjaCara ia dijalankan
Next.jssebagai pelayan (next start) — pemaparan pelayan, laluan API dan middleware berfungsi seperti biasa
Next.js dengan output: 'export'sebagai laman statik daripada out
Nuxtsebagai pelayan (.output/server/index.mjs)
Nuxt dengan ssr: false dan skrip generatesebagai laman statik daripada .output/public
SvelteKitsebagai pelayan dengan adapter-node; dengan adapter-static, sebagai laman statik
Astrosebagai laman statik; dengan @astrojs/node, sebagai pelayan
NestJSdist/main.js selepas binaan
Express, Fastify, Koa, Hono dan pelayan lainfail 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.

Masih perlukan bantuan?

Bersembang dengan kami — AI menjawab serta-merta dan jurutera menyertai apabila perlu, pada bila-bila masa.

Hubungi sokongan