Kezdés

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.

3 PERC OLVASÁS

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.json engines.node mezőjéből vagy a .nvmrc fá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 van package-lock.json).
  • Build – a build szkript, ha a package.json tartalmaz ilyet.

Keretrendszerek

KeretrendszerHogyan fut
Next.jsszerverké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ássalstatikus oldalként az out mappából
Nuxtszerverként (.output/server/index.mjs)
Nuxt ssr: false beállítással és generate szkripttelstatikus oldalként a .output/public mappából
SvelteKitszerverként adapter-node adapterrel; adapter-static adapterrel statikus oldalként
Astrostatikus oldalként; @astrojs/node csomaggal szerverként
NestJSdist/main.js a build után
Express, Fastify, Koa, Hono és más szervereka 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.

Elakadtál?

Írj nekünk chaten — az AI azonnal válaszol, és ha kell, egy mérnök is bekapcsolódik, a nap bármely szakában.

Ügyfélszolgálat