Începe acum
Toate articoleleTUTORIAL · 7 MIN DE CITIT

Publică aplicația ta Node.js pe hostingul Rivervo (Next.js și Nuxt).

RT
Rivervo Team · Rivervo
·
29 aprilie 2026
·
Actualizat 13 noiembrie 2026
Node
ON SHARED HOSTING

Mulți cred că aplicațiile Node.js trebuie să stea pe un VPS. Nu e cazul — fiecare plan de hosting partajat Rivervo are Node.js și Python în meniul site-ului, care pornește un proces Phusion Passenger pentru aplicația ta, în spatele aceluiași Apache care îți servește și celelalte site-uri.

Ghidul acesta parcurge tot procesul pentru cele mai folosite două framework-uri: Next.js și Nuxt 3. Rezultatul final: aplicația ta la https://domeniultau.ro (sau pe orice subdomeniu), rulând într-un proces Node.js real, care rezistă la reporniri și se repornește dintr-un clic.

Dacă n-ai mai publicat niciodată o aplicație Node pe hosting partajat, partea la care se blochează toată lumea e fișierul de pornire — Passenger are nevoie de un singur script de intrare care pornește framework-ul. Mai jos îți dăm câte unul pentru fiecare framework; copiezi și lipești, fără modificări.

Ce îți trebuie înainte să începi

  • Un plan de hosting Rivervo (oricare — aplicațiile Node.js funcționează pe toate planurile)
  • Node.js v20 sau mai nou local, ca să construiești aplicația
  • Aplicația construită, gata de încărcat (explicăm pentru fiecare framework)
  • Acces la contul tău prin managerul de fișiere sau SFTP (merg amândouă)

Nu ai nevoie de root, sudo, systemd sau de configurarea unui reverse proxy. Passenger se ocupă de toate astea.

Pasul 1 — construiește aplicația local

Vei încărca aplicația construită, nu sursa. Panoul instalează dependențele, dar nu compilează React și nu rulează un build Vite. Fă asta întâi pe calculatorul tău.

Next.js:

npm ci
npm run build

Rezultatul e .next/ (aplicația construită). Nu rula next start aici — o pornim din fișierul de pornire imediat.

Nuxt 3:

npm ci
npm run build

Rezultatul e .output/ (directorul universal de build al Nuxt). La fel — nu rula nimic încă.

Pasul 2 — încarcă fișierele potrivite

Nu trebuie să încarci node_modules/. Panoul instalează dependențele pentru tine. Nu ai nevoie nici de git sau de cache-urile de build.

Încarcă fișierele în contul tău, ideal într-o cale în afara public_html (de ex. /home/<account>/myapp/). De ce în afară? Pentru că Passenger montează automat public_html la rădăcina adresei, iar dacă pui codul aplicației acolo, îl expui.

FrameworkÎncarcăSari peste
Next.js.next/, public/, package.json, package-lock.json, next.config.js, fișierul tău server.cjs (mai jos)node_modules/, .git/, .env.local
Nuxt 3.output/, package.json, package-lock.json, fișierul tău server.cjs (mai jos)node_modules/, .nuxt/, .git/, sursele pages/, components/

Două moduri de a pune fișierele acolo:

  • Site → Fișiere → încarci o arhivă zip → o dezarhivezi e cel mai simplu dacă ai o conexiune instabilă.
  • SFTP (FileZilla, Cyberduck, rsync) e mai rapid pentru publicări repetate. Serverul, portul, utilizatorul și parola sunt în Site → SSH și SFTP.

Pasul 3 — adaugă fișierul de pornire

Acesta e fișierul pe care Passenger îl execută când vine o cerere. Pune-l lângă package.json, în folderul aplicației.

Pentru 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}`)
  })
})

Ce face:

  • Încarcă Next și îl îndreaptă spre directorul curent (unde sunt .next/ și package.json).
  • Creează un handler de cereri din routerul intern al Next.
  • Pornește un server HTTP pe portul alocat de Passenger (process.env.PORT).
  • Folosește 3000 ca rezervă pentru testarea locală.

dev se deduce automat din NODE_ENV — setează modul Production în panou (o facem la Pasul 4) și Next rulează în modul de producție.

Pentru 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}`)
    })
  })
})

Ce face:

  • Importă dinamic .output/server/index.mjs al Nuxt (punctul de intrare generat de npm run build).
  • Folosește createApp() ca să creeze instanța de server H3.
  • Ascultă pe portul alocat de Passenger.

import() dinamic e intenționat — modulele .mjs nu pot fi încărcate cu require(), dar un fișier .cjs le poate importa dinamic. E cea mai curată variantă care funcționează în lansatorul Passenger.

Pasul 4 — creează aplicația în panou

Deschide proiectul → Site → Node.js și Python → Aplicație Node.js.

CâmpValoare
Versiune20 sau mai nouă
ModProduction
Foldermyapp în folderul tău principal (unde ai încărcat fișierele)
Adresădomeniultau.ro (sau un subdomeniu, de ex. app.domeniultau.ro)
Fișier de pornireserver.cjs

Apasă Creează. Se creează un mediu Node.js în ~/nodevenv/myapp/20/.

Instalează dependențele

După ce aplicația e creată, apasă pe ea Instalează dependențele (npm install) și urmărește rezultatul. Dacă eșuează:

  • Verifică dacă package.json e în rădăcina aplicației (nu într-un subfolder).
  • Pentru Next.js: confirmă că next e în dependencies, nu în devDependencies (instalarea de producție sare peste dependențele de dezvoltare).
  • Pentru Nuxt: și nuxt trebuie să fie o dependență obișnuită.

Adaugă variabilele de mediu

În aplicație: Setări → Variabile de mediu → Adaugă o variabilă. Modul Production setează deja NODE_ENV=production.

Pentru aplicațiile Next.js care citesc valori la rulare (adrese de baze de date, chei API), adaugă-le aici. Nu încărca un fișier .env cu date secrete — variabilele de mediu ale aplicației sunt locul potrivit.

Salvarea setărilor repornește aplicația, așa că noile variabile se aplică imediat.

Pasul 5 — verifică

Deschide adresa aplicației. Ar trebui să-ți vezi aplicația.

Dacă vezi o pagină de eroare Passenger, extinde-o și uită-te în partea de jos — aproape întotdeauna e acolo un stack trace clar. Cele mai frecvente două:

Error: Cannot find module 'next' — npm install nu a rulat sau a rulat în folderul greșit. Apasă din nou Instalează dependențele (npm install).

Error: ENOENT: no such file or directory, open '.next/...' — ai încărcat sursa, dar nu și directorul construit .next/. Construiește local și încarcă din nou.

Cum publici actualizări

Repetă pașii 1 și 2, apoi apasă Repornește pe aplicație. Concret:

1. Build local      npm run build
2. Încărcare        .next/ sau .output/, plus sursele/configurările modificate
3. Panou            Repornește aplicația

Dacă modifici package.json, apasă Instalează dependențele (npm install) înainte de repornire. Preferi linia de comandă? Site → Terminal: cardul aplicației îți arată comanda pentru a intra în mediul ei.

Capcane frecvente

WebSockets: Passenger lucrează cu HTTP/1.1 și HTTP/2. Upgrade-ul la WebSocket funcționează pentru rutele integrate din Next.js și Nuxt. Dacă folosești un server WebSocket separat (ws, socket.io), acesta folosește același port și pornește prin același server.cjs — fără configurare suplimentară.

Încărcări de fișiere / limitele body-parser din next.config.js: limita implicită a Passenger pentru corpul unei cereri e de 10 MB. Dacă încarci fișiere mari, mărește passenger_max_request_size prin .htaccess în public_html:

PassengerMaxRequestSize 52428800

(50 MB în octeți.)

Sarcini cron: dacă aplicația are nevoie de sarcini în fundal (trimiterea newsletterelor, exporturi programate), nu le rula în procesul web. Folosește Site → Sarcini cron ca să apelezi direct un script Node:

/home/<account>/nodevenv/myapp/20/bin/node /home/<account>/myapp/scripts/send-newsletter.js

Memoria procesului: Passenger îți repornește aplicația dacă depășește limita de RAM a contului (depinde de plan). Pentru o aplicație Next.js / Nuxt obișnuită, în repaus consumul e sub 100 MB. Dacă atingi limitele, analizează cu process.memoryUsage() și caută scurgeri de memorie înainte să presupui că ai nevoie de un plan mai mare.

Domenii proprii și HTTPS: adresa pe care o setezi pentru aplicație e cea la care se leagă Passenger. SSL-ul e automat — fără configurare suplimentară. Pentru alt domeniu sau un subdomeniu, adaugă-l întâi în Site → Domenii, apoi alege-l ca adresă a aplicației.

Versiunea Node: lista Versiune arată toate versiunile instalate; o schimbi din Setări ale aplicației.

Când să nu folosești hosting partajat pentru Node

Ca să fim direcți — Node.js pe hosting partajat merge foarte bine pentru portofolii, bloguri, pagini de marketing, interfețe de SaaS mici, instrumente interne. Are probleme cu:

  • API-uri cu trafic mare (>50 de cereri/secundă constant) — vei simți limita de CPU a contului
  • Aplicații care folosesc intens WebSockets, cu mii de conexiuni simultane
  • Aplicații care pornesc procese worker (cozi de sarcini, scrapere) — limita de procese pe cont a Passenger face asta incomod
  • Orice are nevoie de systemd, Docker sau acces root

Pentru acestea, VPS-ul nostru e alegerea potrivită — root complet, kernel propriu, rulezi ce vrei. Dar pentru majoritatea aplicațiilor Next.js și Nuxt care nu au trafic uriaș, ghidul acesta e tot ce-ți trebuie.

Pe scurt

  1. npm run build local
  2. Încarcă .next/ (Next) sau .output/ (Nuxt) + package.json + server.cjs
  3. Site → Node.js și Python → Aplicație Node.js → folderul, fișierul de pornire server.cjs, modul Production
  4. Instalează dependențele (npm install), apoi Repornește

Dacă ceva nu merge, deschide un tichet — lipește pagina de eroare Passenger și îți arătăm linia cu problema.

— Echipa Rivervo