Începe acum

Aplicații Node.js, Next.js și Nuxt.

Cum sunt detectate și pornite proiectele Node.js: versiunea Node, managerul de pachete, Next.js și Nuxt (server sau static), SvelteKit, Astro, Express și altele, variabila PORT și migrările Prisma.

3 MIN DE CITIT

Un repository cu package.json este un proiect Node.js. Noi alegem frameworkul, managerul de pachete și versiunea Node, îl construim și îl pornim — tu doar faci push.

Versiunea Node și managerul de pachete

  • Node.js — luată din engines.node din package.json sau din .nvmrc: cea mai nouă dintre 24, 22, 20, 18 sau 16 care se potrivește. Fără niciuna dintre ele, Node.js 22.
  • Managerul de pachete — după fișierul lock: pnpm-lock.yaml → pnpm, yarn.lock → yarn, altfel npm (npm ci când există un package-lock.json).
  • Build — scriptul build, dacă package.json are unul.

Frameworkuri

FrameworkCum rulează
Next.jsca server (next start) — randarea pe server, rutele API și middleware-ul funcționează ca de obicei
Next.js cu output: 'export'ca site static din out
Nuxtca server (.output/server/index.mjs)
Nuxt cu ssr: false și un script generateca site static din .output/public
SvelteKitca server cu adapter-node; cu adapter-static, ca site static
Astroca site static; cu @astrojs/node, ca server
NestJSdist/main.js după build
Express, Fastify, Koa, Hono și alte serverefișierul din scripts.start (node server.js), altfel main, altfel server.js, app.js, index.js sau main.js

Proiectele doar de front-end — Vite, Create React App, Angular, Vue CLI și altele — sunt servite ca site-uri statice; vezi Site-uri statice.

Ascultă pe PORT

Un server trebuie să asculte pe portul din variabila PORT, pe toate interfețele:

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

Next.js și Nuxt fac asta singure. Dacă aplicația ta ascultă pe un port fix, nu va primi vizitatori — publicarea se oprește atunci la verificarea de pornire, iar versiunea anterioară continuă să ruleze.

Valori din timpul build-ului

Variabilele din fila Variabile ajung în aplicația care rulează, nu în build. Valorile pe care build-ul le scrie în codul pentru client — cum ar fi NEXT_PUBLIC_… în Next.js sau VITE_… — sunt citite din repository-ul tău, de exemplu dintr-un fișier .env.production adăugat în commit. Codul de pe server citește fila Variabile ca de obicei.

Propria comandă de pornire

Dacă pornirea detectată nu e cea pe care o vrei, setează Setări → Setări de build → Comandă de pornire, de exemplu node dist/server.js sau npm run start:prod. Tot acolo poți schimba și comenzile de instalare și de build.

Baze de date și Prisma

Adaugă PostgreSQL sau MySQL în proiect și citește DATABASE_URL — este setată pentru tine. Cu Prisma printre dependențe, comanda de lansare recomandată este npx prisma migrate deploy: rulează la fiecare publicare, înainte ca noua versiune să primească vizitatori. Vezi Publicări.

Pentru cozi cu BullMQ, adaugă Valkey și folosește REDIS_URL. Rulează workerul de coadă ca worker de fundal — în fila Procese sau ca serviciu separat, cu resurse proprii. Vezi Serviciile unui proiect.

Fișiere care rămân după o publicare

Fiecare publicare pornește de la o copie nouă a repository-ului. Fișierele pe care aplicația le scrie în /data se păstrează între publicări și au backup zilnic; orice e scris în altă parte dispare la următoarea publicare. Pentru fișiere încărcate și media, stocarea de obiecte este de obicei alegerea mai bună.

Monorepo-uri

Pentru un repository cu mai multe proiecte, setează Folder proiect când creezi aplicația (de exemplu apps/web). Un alt folder din același repository poate rula ca serviciu web separat — vezi Serviciile unui proiect.

Încă ai întrebări?

Scrie-ne în chat — asistentul AI răspunde imediat, iar un inginer intervine când e nevoie, la orice oră.

Contactează suportul