Postavite Node.js aplikaciju na Rivervo hosting (Next.js i Nuxt).
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 buildTime 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 buildTime 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.
| Frejmvork | Otpremite | Preskoč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/ipackage.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 pravinpm 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.
| Polje | Vrednost |
|---|---|
| Verzija | 20 ili novija |
| Režim | Production |
| Folder | myapp u vašem početnom folderu (gde ste otpremili fajlove) |
| Adresa | vasdomen.rs (ili poddomen kao app.vasdomen.rs) |
| Početni fajl | server.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.jsonu korenu aplikacije (a ne u podfolderu). - Za Next.js: proverite da li je
nextudependencies, a ne udevDependencies(produkcijska instalacija preskače razvojne zavisnosti). - Za Nuxt: i sam
nuxttreba 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 aplikacijuAko 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.jsMemorija 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
npm run buildlokalno- Otpremite
.next/(Next) ili.output/(Nuxt) +package.json+server.cjs - Sajt → Node.js i Python → Node.js aplikacija → folder, početni fajl
server.cjs, režim Production - 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