Začať
Všetky článkyNÁVOD · 7 MIN. ČÍTANIA

Nasadenie aplikácie Node.js na hosting Rivervo (Next.js a Nuxt).

RT
Rivervo Team · Rivervo
·
29. apríla 2026
·
Aktualizované 13. novembra 2026
Node
ON SHARED HOSTING

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 build

Vznikne .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 build

Vznikne .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ý.

FrameworkNahrajteVynechajte
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/ a package.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.mjs z 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.

PoleHodnota
Verzia20 alebo novšia
RežimProduction
Priečinokmyapp vo vašom domovskom priečinku (kam ste nahrali súbory)
Adresavasadomena.sk (alebo subdoména, napríklad app.vasadomena.sk)
Spúšťací súborserver.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.json v koreni aplikácie (nie vnorený).
  • Pri Next.js: overte, že next je v dependencies, nie v devDependencies (produkčná inštalácia vývojové závislosti vynecháva).
  • Pri Nuxte: aj samotný nuxt má 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 app

Ak 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.js

Pamäť 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

  1. lokálne npm run build
  2. nahrajte .next/ (Next) alebo .output/ (Nuxt) + package.json + server.cjs
  3. Web → Node.js a Python → Aplikácia Node.js → priečinok, spúšťací súbor server.cjs, režim Production
  4. 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