Započnite
Svi tekstoviUPUTSTVO · 7 MIN ČITANJA

Postavite Node.js aplikaciju na Rivervo hosting (Next.js i Nuxt).

RT
Rivervo Team · Rivervo
·
29. april 2026.
·
Ažurirano 13. novembar 2026.
Node
ON SHARED HOSTING

Mnogi misle da Node.js aplikacije moraju da budu na VPS-u. Ne moraju — svaki Rivervo paket deljenog hostinga ima Node.js i Python u meniju sajta, što pokreće Phusion Passenger proces za vašu aplikaciju iza istog Apache servera koji opslužuje i vaše ostale sajtove.

Ovo uputstvo prolazi kroz ceo postupak za dva najčešća frejmvorka: Next.js i Nuxt 3. Krajnji rezultat: vaša aplikacija na https://vasdomen.rs (ili bilo kom poddomenu), radi u pravom Node.js procesu, preživljava ponovna pokretanja servera i restartuje se jednim klikom.

Ako nikada niste postavljali Node aplikaciju na deljeni hosting, deo na kom se svi zaglave je početni fajl — Passenger-u treba jedna ulazna skripta koja pokreće vaš frejmvork. U nastavku dajemo po jednu za svaki frejmvork; kopirajte i nalepite, bez izmena.

Šta vam treba pre početka

  • Rivervo hosting paket (bilo koji — Node.js aplikacije rade na svim paketima)
  • Node.js v20 ili noviji lokalno, za build aplikacije
  • Spreman build aplikacije za otpremanje (objašnjavamo za svaki frejmvork)
  • Pristup nalogu preko upravljača fajlovima ili SFTP-a (oba rade)

Ne treba vam root, sudo, systemd niti podešavanje reverse proxy-ja. Passenger sve to rešava.

Korak 1 — napravite build aplikacije lokalno

Otpremate buildovanu aplikaciju, a ne izvorni kod. Panel instalira zavisnosti, ali neće kompajlirati React niti pokrenuti Vite build. To prvo uradite na svom računaru.

Next.js:

npm ci
npm run build

Time nastaje .next/ (rezultat build-a). Ne pokrećite next start ovde — aplikaciju ćemo za minut pokrenuti iz početnog fajla.

Nuxt 3:

npm ci
npm run build

Time nastaje .output/ (Nuxt-ov univerzalni build direktorijum). Isto — za sada ništa ne pokrećite.

Korak 2 — otpremite prave fajlove

Ne treba da otpremate node_modules/. Panel instalira zavisnosti umesto vas. Ne trebaju vam ni git ni keš build-a.

Otpremite na svoj nalog, najbolje u putanju izvan public_html (npr. /home/<nalog>/myapp/). Zašto izvan? Zato što Passenger automatski postavlja public_html na koren URL-a, pa bi kod aplikacije u njemu bio izložen.

FrejmvorkOtpremitePreskočite
Next.js.next/, public/, package.json, package-lock.json, next.config.js, vaš server.cjs (ispod)node_modules/, .git/, .env.local
Nuxt 3.output/, package.json, package-lock.json, vaš server.cjs (ispod)node_modules/, .nuxt/, .git/, izvorni pages/, components/

Dva načina da prebacite fajlove:

  • Sajt → Fajlovi → otpremite zip → raspakujte ga je najlakše ako vam je veza nestabilna.
  • SFTP (FileZilla, Cyberduck, rsync) je brži za ponovljena postavljanja. Server, port, korisnik i lozinka nalaze se u Sajt → SSH i SFTP.

Korak 3 — dodajte početni fajl

Ovo je fajl koji Passenger izvršava kada stigne zahtev. Stavite ga pored package.json u folderu aplikacije.

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

Šta radi:

  • Učitava Next i usmerava ga na trenutni direktorijum (gde su vaši .next/ i package.json).
  • Pravi obrađivač zahteva iz Next-ovog internog rutera.
  • Pokreće HTTP server na portu koji dodeljuje Passenger (process.env.PORT).
  • Za lokalno testiranje koristi 3000.

dev se automatski izvodi iz NODE_ENV — u panelu podesite režim Production (to radimo u Koraku 4) i Next radi u produkcijskom režimu.

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

Šta radi:

  • Dinamički uvozi Nuxt-ov .output/server/index.mjs (ulaz koji pravi npm run build).
  • Koristi createApp() da napravi instancu H3 servera.
  • Sluša na portu koji je dodelio Passenger.

Dinamički import() je namerno tu — .mjs moduli ne mogu da se učitaju sa require(), ali .cjs fajl može dinamički da ih uveze. Ovo je najčistiji obrazac koji radi unutar Passenger-ovog pokretača.

Korak 4 — napravite aplikaciju u panelu

Otvorite svoj projekat → Sajt → Node.js i Python → Node.js aplikacija.

PoljeVrednost
Verzija20 ili novija
RežimProduction
Foldermyapp u vašem početnom folderu (gde ste otpremili fajlove)
Adresavasdomen.rs (ili poddomen kao app.vasdomen.rs)
Početni fajlserver.cjs

Kliknite Kreiraj. Node.js okruženje se pravi u ~/nodevenv/myapp/20/.

Instalirajte zavisnosti

Kada je aplikacija napravljena, kliknite na njoj Instaliraj zavisnosti (npm install) i pratite izlaz. Ako ne uspe:

  • Proverite da li je package.json u korenu aplikacije (a ne u podfolderu).
  • Za Next.js: proverite da li je next u dependencies, a ne u devDependencies (produkcijska instalacija preskače razvojne zavisnosti).
  • Za Nuxt: i sam nuxt treba da bude obična zavisnost.

Dodajte promenljive okruženja

Podešavanja aplikacije → Promenljive okruženja → Dodaj promenljivu. Režim Production već postavlja NODE_ENV=production.

Za Next.js aplikacije koje čitaju vrednosti pri izvršavanju (URL-ove baza, API ključeve), dodajte ih ovde. Ne isporučujte .env fajl sa tajnim podacima — promenljive okruženja aplikacije su pravo mesto za to.

Čuvanje podešavanja restartuje aplikaciju, pa nove promenljive odmah važe.

Korak 5 — proverite

Otvorite URL aplikacije. Trebalo bi da vidite svoju aplikaciju.

Ako vidite Passenger stranicu sa greškom, proširite je i pogledajte dno — skoro uvek postoji jasan stack trace. Dve najčešće greške:

Error: Cannot find module 'next' — npm install nije pokrenut ili je pokrenut u pogrešnom folderu. Ponovo kliknite Instaliraj zavisnosti (npm install).

Error: ENOENT: no such file or directory, open '.next/...' — otpremili ste izvorni kod, ali ne i buildovani direktorijum .next/. Napravite build lokalno i ponovo otpremite.

Kako da postavite izmene

Ponovite korake 1 i 2 i kliknite Restartuj na aplikaciji. Konkretno:

1. Lokalni build    npm run build
2. Otpremanje      .next/ ili .output/, plus izmenjeni izvorni kod/konfiguracija
3. Panel          Restartujte aplikaciju

Ako menjate package.json, pre restartovanja kliknite Instaliraj zavisnosti (npm install). Više volite komandnu liniju? Sajt → Terminal: kartica aplikacije prikazuje komandu za ulazak u njeno okruženje.

Česte zamke

WebSockets: Passenger podržava HTTP/1.1 i HTTP/2. WebSocket upgrade radi za ugrađene rute Next.js-a i Nuxt-a. Ako koristite poseban WebSocket server (ws, socket.io), on deli isti port i pokreće se preko istog server.cjs — bez dodatnog podešavanja.

Otpremanje fajlova / body-parser ograničenja u next.config.js: podrazumevano ograničenje veličine zahteva u Passenger-u je 10 MB. Ako otpremate velike fajlove, povećajte passenger_max_request_size preko .htaccess u public_html:

PassengerMaxRequestSize 52428800

(50 MB u bajtovima.)

Cron zadaci: ako vašoj aplikaciji trebaju pozadinski zadaci (slanje biltena, zakazani izvozi), ne pokrećite ih u veb procesu. Koristite Sajt → Cron zadaci da direktno pozovete Node skriptu:

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

Memorija procesa: Passenger restartuje aplikaciju ako pređe ograničenje RAM-a po nalogu (zavisi od paketa). Tipična Next.js / Nuxt aplikacija u mirovanju troši manje od 100 MB. Ako dostižete ograničenja, analizirajte potrošnju sa process.memoryUsage() i potražite curenje memorije pre nego što zaključite da vam treba veći paket.

Sopstveni domeni i HTTPS: adresa koju podesite za aplikaciju je ono na šta se Passenger vezuje. SSL je automatski — bez dodatnog podešavanja. Za drugi domen ili poddomen prvo ga dodajte u Sajt → Domeni, pa ga izaberite kao adresu aplikacije.

Verzija Node-a: lista Verzija prikazuje sve instalirane verzije; menjate je u Podešavanjima aplikacije.

Kada ne koristiti deljeni hosting za Node

Da budemo iskreni — Node.js na deljenom hostingu odlično radi za portfolio sajtove, blogove, marketinške stranice, manje SaaS frontende i interne alate. Muči se sa:

  • API-jima sa velikim protokom (>50 zahteva/s stalno) — osetićete ograničenje procesora po nalogu
  • Aplikacijama sa mnogo WebSocket veza, sa hiljadama istovremenih konekcija
  • Aplikacijama koje pokreću radne procese (obrađivači redova, skreperi) — Passenger-ovo ograničenje procesa po nalogu to otežava
  • Svime što zahteva systemd, Docker ili root pristup

Za to je pravi izbor naš VPS — pun root pristup, sopstveno jezgro, pokreće šta god želite. Ali za većinu Next.js i Nuxt aplikacija koje nemaju ogroman saobraćaj, ovo uputstvo je sve što vam treba.

Ukratko

  1. npm run build lokalno
  2. Otpremite .next/ (Next) ili .output/ (Nuxt) + package.json + server.cjs
  3. Sajt → Node.js i Python → Node.js aplikacija → folder, početni fajl server.cjs, režim Production
  4. Instaliraj zavisnosti (npm install), pa Restartuj

Ako nešto ne radi kako treba, otvorite tiket — nalepite Passenger stranicu sa greškom i pokazaćemo vam tačnu liniju.

— Rivervo tim