Objavite svoju Node.js aplikaciju na Rivervo hostingu (Next.js i Nuxt).
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 buildTime 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 buildTime 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.
| Framework | Učitajte | Preskoč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/ipackage.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 stvaranpm 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.
| Polje | Vrijednost |
|---|---|
| Verzija | 20 ili novija |
| Način | Produkcija |
| Mapa | myapp u vašoj početnoj mapi (gdje ste učitali datoteke) |
| Adresa | vasadomena.hr (ili poddomena poput app.vasadomena.hr) |
| Početna datoteka | server.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.jsonu korijenu aplikacije (a ne u podmapi). - Za Next.js: provjerite je li
nextudependencies, a ne udevDependencies(produkcijska instalacija preskače razvojne ovisnosti). - Za Nuxt: i sam
nuxttreba 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 aplikacijuAko 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.jsMemorija 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
npm run buildlokalno- Učitajte
.next/(Next) ili.output/(Nuxt) +package.json+server.cjs - Web stranica → Node.js i Python → Node.js aplikacija → mapa, početna datoteka
server.cjs, način Produkcija - 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