Mnohí si myslia, že aplikácie Node.js musia bežať na VPS. Nemusia – každý balík zdieľaného hostingu Rivervo má v menu webu Node.js a Python, kde sa pre vašu aplikáciu spustí proces Phusion Passenger za tým istým Apache, ktorý obsluhuje vaše ostatné weby.
Tento návod prechádza celý postup pre dva najbežnejšie frameworky: Next.js a Nuxt 3. Výsledok: vaša aplikácia na https://vasadomena.sk (alebo na ľubovoľnej subdoméne), bežiaca v skutočnom procese Node.js, ktorý prežije reštart servera a dá sa reštartovať jedným kliknutím.
Ak ste ešte nikdy nenasadzovali aplikáciu Node na zdieľaný hosting, všetci sa zaseknú na spúšťacom súbore – Passenger potrebuje jeden vstupný skript, ktorý spustí váš framework. Nižšie nájdete jeden pre každý framework; stačí ho skopírovať, bez úprav.
Čo potrebujete na začiatok
- hostingový balík Rivervo (akýkoľvek – aplikácie Node.js fungujú na všetkých balíkoch)
- lokálne Node.js v20 alebo novší na zostavenie aplikácie
- zostavenú aplikáciu pripravenú na nahratie (pre každý framework ju popíšeme)
- prístup k účtu cez správcu súborov alebo SFTP (funguje oboje)
Nepotrebujete root, sudo, systemd ani konfiguráciu reverzného proxy. O všetko sa postará Passenger.
Krok 1 – zostavte aplikáciu lokálne
Nahrávate zostavenú aplikáciu, nie zdrojový kód. Panel nainštaluje závislosti, ale React neskompiluje ani nespustí build cez Vite. Urobte to najprv na svojom počítači.
Next.js:
npm ci
npm run buildVznikne .next/ (zostavený výstup). Nespúšťajte tu next start – aplikáciu o chvíľu spustíme zo spúšťacieho súboru.
Nuxt 3:
npm ci
npm run buildVznikne .output/ (univerzálny adresár buildu Nuxtu). Rovnako – zatiaľ nič nespúšťajte.
Krok 2 – nahrajte správne súbory
node_modules/ nahrávať nemusíte. Závislosti za vás nainštaluje panel. Netreba ani git či cache z buildu.
Nahrajte súbory do svojho účtu, ideálne do priečinka mimo public_html (napr. /home/<účet>/myapp/). Prečo mimo? Pretože Passenger automaticky pripojí public_html ku koreňu adresy a kód aplikácie by tam bol verejne dostupný.
| Framework | Nahrajte | Vynechajte |
|---|---|---|
| Next.js | .next/, public/, package.json, package-lock.json, next.config.js, váš server.cjs (nižšie) | node_modules/, .git/, .env.local |
| Nuxt 3 | .output/, package.json, package-lock.json, váš server.cjs (nižšie) | node_modules/, .nuxt/, .git/, zdrojové pages/, components/ |
Súbory tam dostanete dvoma spôsobmi:
- Web → Súbory → nahrať zip → rozbaliť je najjednoduchšie, ak máte nestabilné pripojenie.
- SFTP (FileZilla, Cyberduck,
rsync) je rýchlejšie pri opakovanom nasadzovaní. Server, port, používateľa a heslo nájdete v časti Web → SSH a SFTP.
Krok 3 – pridajte spúšťací súbor
Toto je súbor, ktorý Passenger spustí, keď príde požiadavka. Vložte ho vedľa package.json v priečinku aplikácie.
Pre 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}`)
})
})Čo robí:
- Načíta Next a nasmeruje ho na aktuálny priečinok (kde sú
.next/apackage.json). - Vytvorí obsluhu požiadaviek z interného smerovača Nextu.
- Spustí HTTP server na porte, ktorý pridelí Passenger (
process.env.PORT). - Na lokálne testovanie použije náhradný port
3000.
dev sa odvodí z NODE_ENV – v paneli nastavte režim Production (urobíme to v kroku 4) a Next pobeží v produkčnom režime.
Pre 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}`)
})
})
})Čo robí:
- Dynamicky importuje
.output/server/index.mjsz Nuxtu (vstupný bod, ktorý vytvorínpm run build). - Pomocou
createApp()vytvorí inštanciu servera H3. - Počúva na porte, ktorý pridelí Passenger.
Dynamický import() je zámerný – moduly .mjs sa nedajú načítať cez require(), ale súbor .cjs ich dokáže dynamicky importovať. Je to najčistejší spôsob, ktorý funguje v spúšťači Passengera.
Krok 4 – vytvorte aplikáciu v paneli
Otvorte svoj projekt → Web → Node.js a Python → Aplikácia Node.js.
| Pole | Hodnota |
|---|---|
| Verzia | 20 alebo novšia |
| Režim | Production |
| Priečinok | myapp vo vašom domovskom priečinku (kam ste nahrali súbory) |
| Adresa | vasadomena.sk (alebo subdoména, napríklad app.vasadomena.sk) |
| Spúšťací súbor | server.cjs |
Kliknite na Vytvoriť. Prostredie Node.js sa vytvorí v ~/nodevenv/myapp/20/.
Nainštalujte závislosti
Keď je aplikácia vytvorená, kliknite pri nej na Nainštalovať závislosti (npm install) a sledujte výstup. Ak to zlyhá:
- Skontrolujte, či je
package.jsonv koreni aplikácie (nie vnorený). - Pri Next.js: overte, že
nextje vdependencies, nie vdevDependencies(produkčná inštalácia vývojové závislosti vynecháva). - Pri Nuxte: aj samotný
nuxtmá byť bežná závislosť.
Pridajte premenné prostredia
V aplikácii Nastavenia → Premenné prostredia → Pridať premennú. Režim Production už nastavuje NODE_ENV=production.
Ak aplikácie Next.js čítajú hodnoty za behu (adresy databáz, kľúče API), pridajte ich sem. Nenahrávajte súbor .env s tajnými údajmi – správne miesto sú premenné prostredia aplikácie.
Uloženie nastavení aplikáciu reštartuje, takže nové premenné platia okamžite.
Krok 5 – overte
Otvorte adresu aplikácie. Mali by ste vidieť svoju aplikáciu.
Ak uvidíte chybovú stránku Passengera, rozbaľte ju a pozrite sa na spodok – takmer vždy tam je jasný výpis zásobníka. Dve najčastejšie chyby:
Error: Cannot find module 'next' – npm install neprebehol alebo prebehol v nesprávnom priečinku. Znova kliknite na Nainštalovať závislosti (npm install).
Error: ENOENT: no such file or directory, open '.next/...' – nahrali ste zdrojový kód, ale nie zostavený adresár .next/. Zostavte aplikáciu lokálne a nahrajte ju znova.
Ako nasadzovať aktualizácie
Zopakujte kroky 1 a 2 a pri aplikácii kliknite na Reštartovať. Konkrétne:
1. Build locally npm run build
2. Upload .next/ or .output/, plus any changed source/config
3. Panel Restart the appAk zmeníte package.json, pred reštartom kliknite na Nainštalovať závislosti (npm install). Radšej príkazový riadok? Web → Terminál: na karte aplikácie nájdete príkaz na vstup do jej prostredia.
Časté nástrahy
WebSockety: Passenger zvláda HTTP/1.1 aj HTTP/2. Prechod na WebSocket funguje pre vstavané trasy Next.js aj Nuxtu. Ak používate samostatný WebSocket server (ws, socket.io), zdieľa ten istý port a spúšťa sa cez ten istý server.cjs – bez ďalšej konfigurácie.
Nahrávanie súborov / limity body-parser v next.config.js: predvolený limit veľkosti požiadavky v Passengeri je 10 MB. Ak nahrávate veľké súbory, zvýšte passenger_max_request_size cez .htaccess v public_html:
PassengerMaxRequestSize 52428800(50 MB v bajtoch.)
Úlohy cron: ak aplikácia potrebuje úlohy na pozadí (rozosielanie newslettera, plánované exporty), nespúšťajte ich vo webovom procese. Použite Web → Úlohy cron a spúšťajte skript Node priamo:
/home/<účet>/nodevenv/myapp/20/bin/node /home/<účet>/myapp/scripts/send-newsletter.jsPamäť procesu: Passenger aplikáciu reštartuje, ak prekročí limit RAM na účet (závisí od balíka). Typická aplikácia Next.js / Nuxt v nečinnosti zaberá menej ako 100 MB. Ak narážate na limity, profilujte pomocou process.memoryUsage() a hľadajte úniky pamäte skôr, ako usúdite, že potrebujete väčší balík.
Vlastné domény a HTTPS: Passenger sa viaže na adresu, ktorú pre aplikáciu nastavíte. SSL je automatické – bez ďalšej konfigurácie. Inú doménu alebo subdoménu najprv pridajte v časti Web → Domény a potom ju vyberte ako adresu aplikácie.
Verzia Node: zoznam Verzia ukazuje všetky nainštalované verzie; prepnete ju v Nastaveniach aplikácie.
Kedy nepoužívať zdieľaný hosting pre Node
Úprimne – Node.js na zdieľanom hostingu výborne funguje pre portfóliá, blogy, marketingové stránky, frontendy malých SaaS a interné nástroje. Má problém pri:
- API s vysokou priepustnosťou (trvalo >50 požiadaviek/s) – pocítite limit CPU na účet
- aplikáciách postavených na WebSocketoch s tisíckami súbežných spojení
- aplikáciách, ktoré spúšťajú pracovné procesy (spracovanie frontov, scrapery) – limit procesov na účet v Passengeri to komplikuje
- čomkoľvek, čo potrebuje systemd, Docker alebo prístup root
Na to je správnou voľbou náš VPS – plný root, vlastné jadro, spustíte, čo chcete. Pre väčšinu aplikácií Next.js a Nuxt, ktoré neobsluhujú obrovskú návštevnosť, vám však tento návod stačí.
Zhrnutie
- lokálne
npm run build - nahrajte
.next/(Next) alebo.output/(Nuxt) +package.json+server.cjs - Web → Node.js a Python → Aplikácia Node.js → priečinok, spúšťací súbor
server.cjs, režim Production - Nainštalovať závislosti (npm install) a potom Reštartovať
Ak niečo nefunguje, otvorte tiket – vložte chybovú stránku Passengera a ukážeme vám na konkrétny riadok.
— Tím Rivervo