Započnite
Svi članciUPUTE · 7 MIN ČITANJA

Objavite svoju Node.js aplikaciju na Rivervo hostingu (Next.js i Nuxt).

RT
Rivervo Team · Rivervo
·
29. travnja 2026.
·
Ažurirano 13. studenoga 2026.
Node
ON SHARED HOSTING

Mnogi misle da Node.js aplikacije moraju biti na VPS-u. Ne moraju — svaki Rivervo paket dijeljenog hostinga u izborniku web stranice ima Node.js i Python, koji za vašu aplikaciju pokreće Phusion Passenger proces iza istog Apache poslužitelja koji poslužuje i vaše ostale stranice.

Ovaj vodič prolazi kroz cijeli postupak za dva najčešća frameworka: Next.js i Nuxt 3. Krajnji rezultat: vaša aplikacija na https://vasadomena.hr (ili bilo kojoj poddomeni), pokrenuta u pravom Node.js procesu, otporna na ponovna pokretanja servera i s mogućnošću ponovnog pokretanja jednim klikom.

Ako nikad niste objavili Node aplikaciju na dijeljenom hostingu, svi zapnu na početnoj datoteci — Passenger treba jednu ulaznu skriptu koja pokreće vaš framework. U nastavku dajemo po jednu za svaki framework; kopirajte i zalijepite, bez izmjena.

Što vam treba prije početka

  • Rivervo paket hostinga (bilo koji — Node.js aplikacije rade na svim paketima)
  • Node.js v20 ili noviji lokalno, za izradu aplikacije
  • Izgrađena aplikacija, spremna za učitavanje (objašnjavamo za svaki framework)
  • Pristup računu preko upravitelja datoteka ili SFTP-a (oboje radi)

Root, sudo, systemd ni konfiguracija reverse proxyja vam ne trebaju. Passenger sve to rješava.

1. korak — izgradite aplikaciju lokalno

Učitavate izgrađenu aplikaciju, a ne izvorni kod. Panel instalira ovisnosti, ali neće kompajlirati React ni pokrenuti Vite build. To najprije napravite na svom računalu.

Next.js:

npm ci
npm run build

Time nastaje .next/ (izgrađeni rezultat). Ovdje ne pokrećite next start — aplikaciju ćemo uskoro pokrenuti iz početne datoteke.

Nuxt 3:

npm ci
npm run build

Time nastaje .output/ (Nuxtova univerzalna mapa s buildom). Isto vrijedi — zasad ništa ne pokrećite.

2. korak — učitajte prave datoteke

node_modules/ ne trebate učitavati. Panel instalira ovisnosti umjesto vas. Ne trebaju vam ni git ni predmemorija builda.

Učitajte datoteke na svoj račun, najbolje u putanju izvan public_html (npr. /home/<racun>/myapp/). Zašto izvan? Zato što Passenger automatski postavlja public_html na korijen URL-a, pa bi kod aplikacije u njemu bio izložen.

FrameworkUčitajtePreskočite
Next.js.next/, public/, package.json, package-lock.json, next.config.js, vaš server.cjs (u nastavku)node_modules/, .git/, .env.local
Nuxt 3.output/, package.json, package-lock.json, vaš server.cjs (u nastavku)node_modules/, .nuxt/, .git/, izvorne pages/, components/

Dva načina da prenesete datoteke:

  • Web stranica → Datoteke → učitajte zip → raspakirajte ga najjednostavnije je ako vam je veza nestabilna.
  • SFTP (FileZilla, Cyberduck, rsync) brži je za ponovljene objave. Server, port, korisničko ime i lozinka nalaze se u Web stranica → SSH i SFTP.

3. korak — dodajte početnu datoteku

Ovo je datoteka koju Passenger izvršava kad stigne zahtjev. Stavite je pokraj package.json u mapi 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}`)
  })
})

Što radi:

  • Učitava Next i usmjerava ga na trenutačnu mapu (gdje su vaši .next/ i package.json).
  • Iz Nextova internog usmjerivača gradi obrađivač zahtjeva.
  • Pokreće HTTP server na portu koji dodjeljuje Passenger (process.env.PORT).
  • Za lokalno testiranje koristi 3000.

dev se automatski određuje iz NODE_ENV — u panelu postavite način Produkcija (to radimo u 4. koraku) i Next radi u produkcijskom načinu.

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

Što radi:

  • Dinamički uvozi Nuxtov .output/server/index.mjs (ulaznu točku koju stvara npm run build).
  • Pomoću createApp() gradi instancu H3 servera.
  • Sluša na portu koji dodjeljuje Passenger.

Dinamički import() je namjeran — .mjs moduli ne mogu se učitati s require(), ali .cjs datoteka ih može dinamički uvesti. To je najčišći obrazac koji radi unutar Passengerova pokretača.

4. korak — izradite aplikaciju u panelu

Otvorite svoj projekt → Web stranica → Node.js i Python → Node.js aplikacija.

PoljeVrijednost
Verzija20 ili novija
NačinProdukcija
Mapamyapp u vašoj početnoj mapi (gdje ste učitali datoteke)
Adresavasadomena.hr (ili poddomena poput app.vasadomena.hr)
Početna datotekaserver.cjs

Kliknite Stvori. Node.js okruženje nastaje u ~/nodevenv/myapp/20/.

Instalirajte ovisnosti

Kad je aplikacija izrađena, na njoj kliknite Instaliraj ovisnosti (npm install) i pratite ispis. Ako ne uspije:

  • Provjerite je li package.json u korijenu aplikacije (a ne u podmapi).
  • Za Next.js: provjerite je li next u dependencies, a ne u devDependencies (produkcijska instalacija preskače razvojne ovisnosti).
  • Za Nuxt: i sam nuxt treba biti obična ovisnost.

Dodajte varijable okruženja

U aplikaciji: Postavke → Varijable okruženja → Dodaj varijablu. Način Produkcija već postavlja NODE_ENV=production.

Za Next.js aplikacije koje vrijednosti čitaju tijekom rada (URL-ovi baza podataka, API ključevi) dodajte ih ovdje. Ne objavljujte datoteku .env s tajnim podacima — varijable okruženja aplikacije pravo su mjesto za njih.

Spremanje postavki ponovno pokreće aplikaciju, pa nove varijable odmah vrijede.

5. korak — provjerite

Otvorite URL svoje aplikacije. Trebali biste vidjeti aplikaciju.

Ako vidite stranicu s pogreškom Passengera, proširite je i pogledajte dno — gotovo uvijek postoji jasan stack trace. Dvije najčešće pogreške:

Error: Cannot find module 'next' — npm install se nije pokrenuo ili se pokrenuo u pogrešnoj mapi. Ponovno kliknite Instaliraj ovisnosti (npm install).

Error: ENOENT: no such file or directory, open '.next/...' — učitali ste izvorni kod, ali ne i izgrađenu mapu .next/. Izgradite aplikaciju lokalno i ponovno je učitajte.

Kako objavljivati ažuriranja

Ponovite 1. i 2. korak te na aplikaciji kliknite Ponovno pokreni. Konkretno:

1. Build lokalno    npm run build
2. Učitavanje      .next/ ili .output/, plus promijenjeni izvorni kod/konfiguracija
3. Panel          Ponovno pokrenite aplikaciju

Ako promijenite package.json, prije ponovnog pokretanja kliknite Instaliraj ovisnosti (npm install). Radije koristite naredbeni redak? Web stranica → Terminal: kartica aplikacije prikazuje naredbu za ulazak u njezino 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 Nuxta. Ako koristite zaseban WebSocket server (ws, socket.io), on dijeli isti port i pokreće se preko istog server.cjs — bez dodatne konfiguracije.

Učitavanje datoteka / ograničenja body-parser u next.config.js: zadano Passengerovo ograničenje veličine zahtjeva je 10 MB. Ako učitavate velike datoteke, povećajte passenger_max_request_size putem .htaccess u public_html:

PassengerMaxRequestSize 52428800

(50 MB u bajtovima.)

Cron zadaci: ako vaša aplikacija treba pozadinske zadatke (slanje newslettera, zakazani izvozi), ne pokrećite ih unutar web procesa. Upotrijebite Web stranica → Cron zadaci da izravno pokrenete Node skriptu:

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

Memorija procesa: Passenger ponovno pokreće aplikaciju ako premaši ograničenje RAM-a po računu (ovisi o paketu). Tipična Next.js / Nuxt aplikacija u mirovanju troši manje od 100 MB. Ako dosežete ograničenja, prije nego što zaključite da vam treba veći paket, profilirajte s process.memoryUsage() i potražite curenja memorije.

Vlastite domene i HTTPS: adresa koju postavite za aplikaciju je ono na što se Passenger veže. SSL je automatski — bez dodatne konfiguracije. Za drugu domenu ili poddomenu najprije je dodajte u Web stranica → Domene, a zatim je odaberite kao adresu aplikacije.

Verzija Node.js-a: popis Verzija prikazuje sve instalirane verzije; promijenite je u Postavkama aplikacije.

Kada Node ne koristiti na dijeljenom hostingu

Iskreno — Node.js na dijeljenom hostingu odlično radi za portfelje, blogove, marketinške stranice, frontende manjih SaaS proizvoda i interne alate. Teško mu je s:

  • API-jima s velikim protokom (>50 zahtjeva/s trajno) — osjetit ćete ograničenje CPU-a po računu
  • aplikacijama s puno WebSocketa i tisućama istodobnih veza
  • aplikacijama koje pokreću radne procese (queue workeri, scraperi) — Passengerovo ograničenje procesa po računu to otežava
  • svime što treba systemd, Docker ili root pristup

Za to je pravi izbor naš VPS — puni root, vlastiti kernel, pokreće što god želite. Ali za većinu Next.js i Nuxt aplikacija koje nemaju golem promet ovaj vodič je sve što vam treba.

Ukratko

  1. npm run build lokalno
  2. Učitajte .next/ (Next) ili .output/ (Nuxt) + package.json + server.cjs
  3. Web stranica → Node.js i Python → Node.js aplikacija → mapa, početna datoteka server.cjs, način Produkcija
  4. Instaliraj ovisnosti (npm install), zatim Ponovno pokreni

Ako nešto ne radi kako treba, otvorite upit — zalijepite stranicu s Passengerovom pogreškom i pokazat ćemo vam točan redak.

— Tim Rivervo