Ανέβασε την εφαρμογή σου Node.js στο hosting της Rivervo (Next.js και Nuxt).
Πολλοί πιστεύουν ότι οι εφαρμογές Node.js πρέπει να τρέχουν σε VPS. Δεν χρειάζεται — κάθε πακέτο shared hosting της Rivervo έχει Node.js και Python στο μενού της ιστοσελίδας, που ξεκινά μια διεργασία Phusion Passenger για την εφαρμογή σου πίσω από τον ίδιο Apache που σερβίρει και τις άλλες ιστοσελίδες σου.
Ο οδηγός περνά από όλη τη διαδικασία για τα δύο πιο διαδεδομένα frameworks: Next.js και Nuxt 3. Το αποτέλεσμα: η εφαρμογή σου στο https://to-domain-sou.gr (ή σε οποιοδήποτε subdomain), σε πραγματική διεργασία Node.js, που αντέχει τις επανεκκινήσεις και ξαναξεκινά με ένα κλικ.
Αν δεν έχεις ανεβάσει ποτέ εφαρμογή Node σε shared hosting, το σημείο όπου κολλάνε όλοι είναι το αρχείο εκκίνησης — το Passenger χρειάζεται ένα μοναδικό script εισόδου που ξεκινά το framework σου. Παρακάτω δίνουμε ένα για κάθε framework· αντιγραφή-επικόλληση, χωρίς αλλαγές.
Τι χρειάζεσαι πριν ξεκινήσεις
- Ένα πακέτο hosting της Rivervo (οποιοδήποτε — οι εφαρμογές Node.js δουλεύουν σε όλα τα πακέτα)
- Node.js v20 ή νεότερο τοπικά για το build της εφαρμογής
- Το έτοιμο build, για να το ανεβάσεις (το εξηγούμε για κάθε framework)
- Πρόσβαση στον λογαριασμό σου μέσω διαχείρισης αρχείων ή SFTP (δουλεύουν και τα δύο)
Δεν χρειάζεσαι root, sudo, systemd ή ρυθμίσεις reverse proxy. Το Passenger τα αναλαμβάνει όλα.
Βήμα 1 — Κάνε build την εφαρμογή τοπικά
Θα ανεβάσεις μια έτοιμη εφαρμογή, όχι τον πηγαίο κώδικα. Το panel εγκαθιστά τις εξαρτήσεις, αλλά δεν κάνει compile το React ούτε τρέχει build με Vite. Κάν' το πρώτα στον υπολογιστή σου.
Next.js:
npm ci
npm run buildΑυτό παράγει το .next/ (το έτοιμο build). Μην τρέξεις next start εδώ — θα την ξεκινήσουμε από το αρχείο εκκίνησης σε λίγο.
Nuxt 3:
npm ci
npm run buildΑυτό παράγει το .output/ (τον φάκελο universal build του Nuxt). Το ίδιο κι εδώ — μην τρέξεις τίποτα ακόμη.
Βήμα 2 — Ανέβασε τα σωστά αρχεία
Δεν χρειάζεται να ανεβάσεις το node_modules/. Το panel εγκαθιστά τις εξαρτήσεις για σένα. Δεν χρειάζεσαι επίσης git ή cache του build.
Ανέβασέ τα στον λογαριασμό σου, ιδανικά σε διαδρομή έξω από το public_html (π.χ. /home/<account>/myapp/). Γιατί έξω; Επειδή το Passenger σερβίρει αυτόματα το public_html στη ρίζα της διεύθυνσης, και αν βάλεις εκεί τον κώδικα της εφαρμογής, τον εκθέτεις.
| Framework | Ανέβασε αυτά | Παράλειψε |
|---|---|---|
| Next.js | .next/, public/, package.json, package-lock.json, next.config.js, το server.cjs σου (παρακάτω) | node_modules/, .git/, .env.local |
| Nuxt 3 | .output/, package.json, package-lock.json, το server.cjs σου (παρακάτω) | node_modules/, .nuxt/, .git/, πηγαίο pages/, components/ |
Δύο τρόποι να ανεβάσεις τα αρχεία:
- Ιστοσελίδα → Αρχεία → ανέβασε ένα zip → αποσυμπίεσέ το είναι το πιο εύκολο αν η σύνδεσή σου δεν είναι σταθερή.
- SFTP (FileZilla, Cyberduck,
rsync) είναι πιο γρήγορο για επαναλαμβανόμενα deploy. Ο server, η θύρα, ο χρήστης και ο κωδικός βρίσκονται στο Ιστοσελίδα → SSH και SFTP.
Βήμα 3 — Πρόσθεσε το αρχείο εκκίνησης
Αυτό είναι το αρχείο που εκτελεί το Passenger όταν έρχεται ένα αίτημα. Βάλ' το δίπλα στο package.json στον φάκελο της εφαρμογής.
Για Next.js — server.cjs
const next = require('next')
const http = require('http')
const port = process.env.PORT || 3000
const dev = process.env.NODE_ENV !== 'production'
const app = next({ dev, dir: __dirname })
const handle = app.getRequestHandler()
app.prepare().then(() => {
http.createServer((req, res) => handle(req, res)).listen(port, () => {
console.log(`Next.js server listening on port ${port}`)
})
})Τι κάνει:
- Φορτώνει το Next και το στρέφει στον τρέχοντα φάκελο (εκεί όπου βρίσκονται το
.next/και τοpackage.json). - Φτιάχνει έναν χειριστή αιτημάτων από τον εσωτερικό router του Next.
- Ξεκινά έναν HTTP server στη θύρα που ορίζει το Passenger (
process.env.PORT). - Χρησιμοποιεί τη θύρα
3000για τοπικές δοκιμές.
Το dev βγαίνει αυτόματα από το NODE_ENV — όρισε τη λειτουργία Production στο panel (θα το κάνουμε στο Βήμα 4) και το Next τρέχει σε λειτουργία παραγωγής.
Για Nuxt 3 — server.cjs
import('./.output/server/index.mjs').then(({ createApp }) => {
createApp().then(({ app }) => {
const port = process.env.PORT || 3000
app.listen(port, () => {
console.log(`Nuxt server listening on port ${port}`)
})
})
})Τι κάνει:
- Φορτώνει δυναμικά το
.output/server/index.mjsτου Nuxt (το σημείο εισόδου που παράγει τοnpm run build). - Χρησιμοποιεί το
createApp()για να φτιάξει τον server H3. - Ακούει στη θύρα που ορίζει το Passenger.
Το δυναμικό import() είναι σκόπιμο — τα modules .mjs δεν φορτώνονται με require(), αλλά ένα αρχείο .cjs μπορεί να τα κάνει import δυναμικά. Είναι ο πιο καθαρός τρόπος που δουλεύει μέσα στον launcher του Passenger.
Βήμα 4 — Δημιούργησε την εφαρμογή στο panel
Άνοιξε το project σου → Ιστοσελίδα → Node.js και Python → Εφαρμογή Node.js.
| Πεδίο | Τιμή |
|---|---|
| Έκδοση | 20 ή νεότερη |
| Λειτουργία | Production |
| Φάκελος | myapp στον αρχικό σου φάκελο (εκεί όπου ανέβασες τα αρχεία) |
| Διεύθυνση | to-domain-sou.gr (ή ένα subdomain όπως app.to-domain-sou.gr) |
| Αρχείο εκκίνησης | server.cjs |
Πάτα Δημιουργία. Δημιουργείται ένα περιβάλλον Node.js στο ~/nodevenv/myapp/20/.
Εγκατάσταση εξαρτήσεων
Μόλις δημιουργηθεί η εφαρμογή, πάτα Εγκατάσταση εξαρτήσεων (npm install) και παρακολούθησε την έξοδο. Αν αποτύχει:
- Έλεγξε ότι το
package.jsonβρίσκεται στη ρίζα της εφαρμογής (όχι σε υποφάκελο). - Για Next.js: βεβαιώσου ότι το
nextείναι σταdependenciesκαι όχι σταdevDependencies(η εγκατάσταση παραγωγής παραλείπει τα dev deps). - Για Nuxt: και το ίδιο το
nuxtπρέπει να είναι κανονική εξάρτηση.
Πρόσθεσε μεταβλητές περιβάλλοντος
Στις Ρυθμίσεις της εφαρμογής → Μεταβλητές περιβάλλοντος → Προσθήκη μεταβλητής. Η λειτουργία Production ορίζει ήδη το NODE_ENV=production.
Για εφαρμογές Next.js που διαβάζουν τιμές κατά την εκτέλεση (διευθύνσεις βάσεων δεδομένων, κλειδιά API), πρόσθεσέ τες εδώ. Μην ανεβάζεις αρχείο .env με μυστικά — οι μεταβλητές περιβάλλοντος της εφαρμογής είναι το σωστό σημείο.
Η αποθήκευση των ρυθμίσεων κάνει επανεκκίνηση της εφαρμογής, οπότε οι νέες μεταβλητές ισχύουν αμέσως.
Βήμα 5 — Επαλήθευση
Άνοιξε τη διεύθυνση της εφαρμογής. Θα πρέπει να δεις την εφαρμογή σου.
Αν δεις σελίδα σφάλματος του Passenger, άνοιξέ τη και κοίτα στο κάτω μέρος — σχεδόν πάντα υπάρχει ένα σαφές stack trace. Τα δύο πιο συνηθισμένα:
Error: Cannot find module 'next' — το npm install δεν έτρεξε ή έτρεξε σε λάθος φάκελο. Πάτα ξανά Εγκατάσταση εξαρτήσεων (npm install).
Error: ENOENT: no such file or directory, open '.next/...' — ανέβασες τον πηγαίο κώδικα αλλά όχι τον έτοιμο φάκελο .next/. Κάνε build τοπικά και ανέβασέ τον ξανά.
Πώς ανεβάζεις ενημερώσεις
Επανάλαβε τα βήματα 1 και 2 και πάτα Επανεκκίνηση στην εφαρμογή. Συγκεκριμένα:
1. Build locally npm run build
2. Upload .next/ or .output/, plus any changed source/config
3. Panel Restart the appΑν αλλάξεις το package.json, πάτα Εγκατάσταση εξαρτήσεων (npm install) πριν από την επανεκκίνηση. Προτιμάς τη γραμμή εντολών; Ιστοσελίδα → Τερματικό: η κάρτα της εφαρμογής δείχνει την εντολή για να μπεις στο περιβάλλον της.
Συνηθισμένες παγίδες
WebSockets: Το Passenger χειρίζεται HTTP/1.1 και HTTP/2. Το WebSocket upgrade δουλεύει για τις ενσωματωμένες routes του Next.js και του Nuxt. Αν χρησιμοποιείς ξεχωριστό WebSocket server (ws, socket.io), μοιράζεται την ίδια θύρα και ξεκινά από το ίδιο server.cjs — χωρίς επιπλέον ρυθμίσεις.
Uploads αρχείων / όρια body-parser στο next.config.js: Το προεπιλεγμένο όριο μεγέθους αιτήματος του Passenger είναι 10 MB. Αν ανεβάζεις μεγάλα αρχεία, ανέβασε το passenger_max_request_size μέσω .htaccess στο public_html:
PassengerMaxRequestSize 52428800(50 MB σε bytes.)
Εργασίες cron: αν η εφαρμογή σου χρειάζεται εργασίες στο παρασκήνιο (αποστολές newsletter, προγραμματισμένες εξαγωγές), μην τις τρέχεις μέσα στη διεργασία web. Χρησιμοποίησε το Ιστοσελίδα → Εργασίες cron για να καλείς απευθείας ένα script Node:
/home/<account>/nodevenv/myapp/20/bin/node /home/<account>/myapp/scripts/send-newsletter.jsΜνήμη διεργασίας: Το Passenger κάνει επανεκκίνηση της εφαρμογής σου αν ξεπεράσει το όριο RAM του λογαριασμού (εξαρτάται από το πακέτο σου). Μια τυπική εφαρμογή Next.js / Nuxt σε αδράνεια χρειάζεται λιγότερα από 100 MB. Αν φτάνεις στα όρια, κάνε profiling με το process.memoryUsage() και ψάξε για διαρροές πριν υποθέσεις ότι χρειάζεσαι μεγαλύτερο πακέτο.
Δικά σου domain και HTTPS: η διεύθυνση που ορίζεις για την εφαρμογή είναι αυτή στην οποία συνδέεται το Passenger. Το SSL είναι αυτόματο — χωρίς επιπλέον ρυθμίσεις. Για άλλο domain ή subdomain, πρόσθεσέ το πρώτα στο Ιστοσελίδα → Domains και μετά διάλεξέ το ως διεύθυνση της εφαρμογής.
Έκδοση Node: η λίστα Έκδοση δείχνει όλες τις εγκατεστημένες εκδόσεις· την αλλάζεις στις Ρυθμίσεις της εφαρμογής.
Πότε να μη χρησιμοποιείς shared hosting για Node
Για να είμαστε ειλικρινείς — το Node.js σε shared hosting δουλεύει άψογα για ιστοσελίδες portfolio, blogs, σελίδες marketing, μικρά frontends SaaS και εσωτερικά εργαλεία. Δυσκολεύεται με:
- APIs υψηλού φόρτου (>50 req/sec σταθερά) — θα νιώσεις το όριο CPU του λογαριασμού
- Εφαρμογές με πολλά WebSockets και χιλιάδες ταυτόχρονες συνδέσεις
- Εφαρμογές που ξεκινούν worker διεργασίες (queue workers, scrapers) — το όριο διεργασιών του Passenger ανά λογαριασμό το κάνει δύσκολο
- Οτιδήποτε χρειάζεται systemd, Docker ή πρόσβαση root
Για αυτά, το VPS μας είναι η σωστή επιλογή — πλήρες root, δικός σου kernel, τρέχεις ό,τι θέλεις. Για τις περισσότερες εφαρμογές Next.js και Nuxt όμως που δεν έχουν τεράστια κίνηση, αυτός ο οδηγός είναι ό,τι χρειάζεσαι.
Με λίγα λόγια
npm run buildτοπικά- Ανέβασε το
.next/(Next) ή το.output/(Nuxt) +package.json+server.cjs - Ιστοσελίδα → Node.js και Python → Εφαρμογή Node.js → ο φάκελος, αρχείο εκκίνησης
server.cjs, λειτουργία Production - Εγκατάσταση εξαρτήσεων (npm install) και μετά Επανεκκίνηση
Αν κάτι δεν πάει καλά, άνοιξε ένα αίτημα υποστήριξης — επικόλλησε τη σελίδα σφάλματος του Passenger και θα σου δείξουμε τη γραμμή που φταίει.
— Η ομάδα της Rivervo