Ξεκίνα

Εφαρμογές Node.js, Next.js και Nuxt.

Πώς αναγνωρίζονται και ξεκινούν τα projects Node.js: έκδοση Node, package manager, Next.js και Nuxt (server ή στατικά), SvelteKit, Astro, Express και παρόμοια, η μεταβλητή PORT και τα migrations του Prisma.

3 ΛΕΠΤΑ ΑΝΑΓΝΩΣΗΣ

Ένα repository με package.json είναι project Node.js. Επιλέγουμε το framework, τον package manager και την έκδοση Node, κάνουμε το build και το ξεκινάμε — εσύ απλώς κάνεις push.

Έκδοση Node και package manager

  • Node.js — από το engines.node στο package.json ή από το .nvmrc: η νεότερη από 24, 22, 20, 18 ή 16 που ταιριάζει. Χωρίς κανένα από τα δύο, Node.js 22.
  • Package manager — από το lock file: pnpm-lock.yaml → pnpm, yarn.lock → yarn, αλλιώς npm (npm ci όταν υπάρχει package-lock.json).
  • Build — το script build, όταν το package.json έχει.

Frameworks

FrameworkΠώς τρέχει
Next.jsως server (next start) — server rendering, API routes και middleware λειτουργούν κανονικά
Next.js με output: 'export'ως στατική ιστοσελίδα από το out
Nuxtως server (.output/server/index.mjs)
Nuxt με ssr: false και script generateως στατική ιστοσελίδα από το .output/public
SvelteKitως server με adapter-node· με adapter-static, ως στατική ιστοσελίδα
Astroως στατική ιστοσελίδα· με @astrojs/node, ως server
NestJSdist/main.js μετά το build
Express, Fastify, Koa, Hono και άλλοι serversτο αρχείο στο scripts.start (node server.js), αλλιώς το main, αλλιώς server.js, app.js, index.js ή main.js

Τα projects μόνο front-end — Vite, Create React App, Angular, Vue CLI και άλλα — σερβίρονται ως στατικές ιστοσελίδες· δες Στατικές ιστοσελίδες.

Άκουσε στο PORT

Ένας server πρέπει να ακούει στη θύρα της μεταβλητής PORT, σε όλα τα interfaces:

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

Το Next.js και το Nuxt το κάνουν μόνα τους. Αν η εφαρμογή σου ακούει σε σταθερή θύρα, δεν θα δέχεται επισκέπτες — τότε το deploy σταματά στον έλεγχο εκκίνησης και η προηγούμενη έκδοση συνεχίζει να τρέχει.

Τιμές κατά το build

Οι μεταβλητές από την καρτέλα Μεταβλητές φτάνουν στην εφαρμογή που τρέχει, όχι στο build. Οι τιμές που το build γράφει μέσα στον κώδικα του client — όπως NEXT_PUBLIC_… στο Next.js ή VITE_… — διαβάζονται από το repository σου, για παράδειγμα από ένα αρχείο .env.production που έχεις κάνει commit. Ο κώδικας στον server διαβάζει την καρτέλα Μεταβλητές κανονικά.

Δική σου εντολή εκκίνησης

Αν η εκκίνηση που εντοπίσαμε δεν είναι αυτή που θέλεις, όρισε Ρυθμίσεις → Ρυθμίσεις build → Εντολή εκκίνησης, π.χ. node dist/server.js ή npm run start:prod. Εκεί αλλάζουν και οι εντολές εγκατάστασης και build.

Βάσεις δεδομένων και Prisma

Πρόσθεσε PostgreSQL ή MySQL στο project και διάβασε το DATABASE_URL — ορίζεται για σένα. Με το Prisma στις εξαρτήσεις σου, η προτεινόμενη εντολή release είναι npx prisma migrate deploy: τρέχει σε κάθε deploy πριν η νέα έκδοση δεχτεί επισκέπτες. Δες Deploys.

Για ουρές με BullMQ, πρόσθεσε Valkey και χρησιμοποίησε το REDIS_URL. Τρέξε τον queue worker ως background worker — στην καρτέλα Διεργασίες ή ως ξεχωριστή υπηρεσία με δικούς της πόρους. Δες Υπηρεσίες ενός project.

Αρχεία που διατηρούνται μετά το deploy

Κάθε deploy ξεκινά από ένα φρέσκο αντίγραφο του repository σου. Τα αρχεία που γράφει η εφαρμογή σου στο /data διατηρούνται ανάμεσα στα deploys και γίνεται backup τους κάθε μέρα· ό,τι γράφεται αλλού χάνεται μετά το επόμενο deploy. Για uploads και πολυμέσα, ο χώρος αποθήκευσης αντικειμένων είναι συνήθως η καλύτερη επιλογή.

Monorepos

Για repository με πολλά projects, όρισε τον Φάκελο project όταν δημιουργείς την εφαρμογή (π.χ. apps/web). Ένας άλλος φάκελος του ίδιου repository μπορεί να τρέχει ως ξεχωριστή web υπηρεσία — δες Υπηρεσίες ενός project.

Χρειάζεσαι ακόμα βοήθεια;

Γράψε μας στο chat — το AI απαντά αμέσως και ένας μηχανικός μπαίνει όταν χρειαστεί, οποιαδήποτε ώρα της μέρας.

Επικοινωνία με την υποστήριξη