Publică aplicația ta Node.js pe hostingul Rivervo (Next.js și Nuxt).
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 buildRezultatul e .next/ (aplicația construită). Nu rula next start aici — o pornim din fișierul de pornire imediat.
Nuxt 3:
npm ci
npm run buildRezultatul 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/șipackage.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
3000ca 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.mjsal Nuxt (punctul de intrare generat denpm 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âmp | Valoare |
|---|---|
| Versiune | 20 sau mai nouă |
| Mod | Production |
| Folder | myapp î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 pornire | server.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.jsone în rădăcina aplicației (nu într-un subfolder). - Pentru Next.js: confirmă că
nexte îndependencies, nu îndevDependencies(instalarea de producție sare peste dependențele de dezvoltare). - Pentru Nuxt: și
nuxttrebuie 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țiaDacă 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.jsMemoria 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
npm run buildlocal- Încarcă
.next/(Next) sau.output/(Nuxt) +package.json+server.cjs - Site → Node.js și Python → Aplicație Node.js → folderul, fișierul de pornire
server.cjs, modul Production - 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