Node.js-, Next.js- és Nuxt-alkalmazások.
Hogyan ismerjük fel és indítjuk a Node.js-projekteket: Node-verzió, csomagkezelő, Next.js és Nuxt (szerver vagy statikus), SvelteKit, Astro, Express és társai, a PORT változó és a Prisma-migrációk.
Egy package.json fájlt tartalmazó tároló Node.js-projekt. Kiválasztjuk a keretrendszert, a csomagkezelőt és a Node-verziót, felépítjük és elindítjuk – neked csak pusholnod kell.
Node-verzió és csomagkezelő
- Node.js – a
package.jsonengines.nodemezőjéből vagy a.nvmrcfájlból: a 24, 22, 20, 18 és 16 közül a legújabb, amely megfelel. Ha egyik sincs, Node.js 22. - Csomagkezelő – a lock fájl alapján:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, egyébként npm (npm ci, ha vanpackage-lock.json). - Build – a
buildszkript, ha apackage.jsontartalmaz ilyet.
Keretrendszerek
| Keretrendszer | Hogyan fut |
|---|---|
| Next.js | szerverként (next start) – a szerveroldali renderelés, az API-útvonalak és a middleware a megszokott módon működik |
Next.js output: 'export' beállítással | statikus oldalként az out mappából |
| Nuxt | szerverként (.output/server/index.mjs) |
Nuxt ssr: false beállítással és generate szkripttel | statikus oldalként a .output/public mappából |
| SvelteKit | szerverként adapter-node adapterrel; adapter-static adapterrel statikus oldalként |
| Astro | statikus oldalként; @astrojs/node csomaggal szerverként |
| NestJS | dist/main.js a build után |
| Express, Fastify, Koa, Hono és más szerverek | a scripts.start fájlja (node server.js), különben a main, különben server.js, app.js, index.js vagy main.js |
A csak front-endes projekteket – Vite, Create React App, Angular, Vue CLI és mások – statikus oldalként szolgáljuk ki; lásd: Statikus oldalak.
Figyelés a PORT-on
A szervernek a PORT változóban megadott porton kell figyelnie, minden interfészen:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')A Next.js és a Nuxt ezt magától megteszi. Ha az alkalmazásod fix porton figyel, nem kap látogatókat – a telepítés ilyenkor megáll az indítási ellenőrzésnél, és az előző verzió fut tovább.
Buildidejű értékek
A Változók fül változói a futó alkalmazáshoz jutnak el, a buildhez nem. Azokat az értékeket, amelyeket a build beleír a kliensoldali kódba – például a Next.js NEXT_PUBLIC_… vagy a VITE_… változóit –, a tárolódból olvassuk, például egy commitolt .env.production fájlból. A szerveroldali kód a megszokott módon a Változók fület olvassa.
Saját indítóparancs
Ha a felismert indítás nem az, amit szeretnél, állítsd be a Beállítások → Build-beállítások → Indítóparancs értékét, például node dist/server.js vagy npm run start:prod. A telepítő és a build parancsokat is itt módosíthatod.
Adatbázisok és Prisma
Adj PostgreSQL-t vagy MySQL-t a projekthez, és olvasd a DATABASE_URL változót – helyetted beállítjuk. Ha a függőségeid között van Prisma, az ajánlott kiadási parancs az npx prisma migrate deploy: minden telepítéskor lefut, mielőtt az új verzió látogatókat kapna. Lásd: Telepítések.
BullMQ-sorokhoz adj hozzá Valkeyt, és használd a REDIS_URL változót. A sorfeldolgozót háttérfolyamatként futtasd – a Folyamatok fülön, vagy külön szolgáltatásként, saját erőforrásokkal. Lásd: Egy projekt szolgáltatásai.
Telepítést túlélő fájlok
Minden telepítés a tárolód friss másolatával indul. Az alkalmazásod által a /data mappába írt fájlok megmaradnak a telepítések között, és naponta mentjük őket; ami máshová kerül, az a következő telepítés után elvész. Feltöltésekhez és médiafájlokhoz általában az objektumtár a jobb választás.
Monorepók
Több projektet tartalmazó tárolónál az alkalmazás létrehozásakor add meg a Projektmappa értékét (például apps/web). Ugyanannak a tárolónak egy másik mappája külön webszolgáltatásként futhat – lásd: Egy projekt szolgáltatásai.