Kezdés
Összes bejegyzésÚTMUTATÓ · 7 PERC OLVASÁS

Node.js alkalmazás telepítése Rivervo tárhelyre (Next.js és Nuxt).

RT
Rivervo Team · Rivervo
·
2026. április 29.
·
Frissítve 2026. november 13.
Node
ON SHARED HOSTING

Sokan azt hiszik, hogy a Node.js alkalmazásoknak VPS-en a helyük. Nem feltétlenül — minden Rivervo osztott tárhelycsomagban ott van a weboldal menüjében a Node.js és Python, amely egy Phusion Passenger folyamatot indít az alkalmazásodnak, ugyanazon Apache mögött, amely a többi oldaladat is kiszolgálja.

Ez az útmutató a teljes folyamatot végigveszi a két leggyakoribb keretrendszerre: Next.js és Nuxt 3. A végeredmény: az alkalmazásod a https://domained.hu címen (vagy bármely aldomainen), valódi Node.js folyamatként fut, túléli az újraindításokat, és egy kattintással újraindítható.

Ha még sosem telepítettél Node alkalmazást osztott tárhelyre, mindenki az indítófájlnál akad el — a Passengernek egyetlen belépési szkript kell, amely elindítja a keretrendszert. Alább mindkét keretrendszerhez adunk egyet; csak másold be, szerkeszteni nem kell.

Ami kell a kezdéshez

  • Egy Rivervo tárhelycsomag (bármelyik — a Node.js alkalmazások minden csomagon működnek)
  • Helyben 20-as vagy újabb Node.js az alkalmazás buildeléséhez
  • A lefordított alkalmazás, feltöltésre készen (keretrendszerenként leírjuk)
  • Fájlkezelő vagy SFTP-hozzáférés a fiókodhoz (mindkettő jó)

Root, sudo, systemd vagy reverse proxy beállítás nem kell. Ezt mind a Passenger intézi.

1. lépés — az alkalmazás buildelése helyben

Az elkészült alkalmazást töltöd fel, nem a forráskódot. A panel telepíti a függőségeket, de React-fordítást vagy Vite buildet nem futtat. Ezt előbb a saját gépeden végezd el.

Next.js:

npm ci
npm run build

Ez létrehozza a .next/ könyvtárat (a lefordított kimenetet). Itt ne futtasd a next start parancsot — egy perc múlva az indítófájlból indítjuk.

Nuxt 3:

npm ci
npm run build

Ez létrehozza az .output/ könyvtárat (a Nuxt univerzális build könyvtárát). Ugyanúgy — még ne futtass semmit.

2. lépés — a megfelelő fájlok feltöltése

A node_modules/ könyvtárat nem kell feltöltened. A függőségeket a panel telepíti. A gitre és a build gyorsítótárakra sincs szükség.

Töltsd fel a fiókodba, lehetőleg a public_html könyvtáron kívülre (pl. /home/<account>/myapp/). Miért kívülre? Mert a Passenger a public_html könyvtárat automatikusan az URL gyökerére csatolja, és ha ott van az alkalmazásod kódja, az nyilvánosan elérhetővé válik.

KeretrendszerEzeket töltsd felKihagyható
Next.js.next/, public/, package.json, package-lock.json, next.config.js, a server.cjs fájlod (lásd alább)node_modules/, .git/, .env.local
Nuxt 3.output/, package.json, package-lock.json, a server.cjs fájlod (lásd alább)node_modules/, .nuxt/, .git/, a forrás pages/, components/

Kétféleképpen juttathatod fel a fájlokat:

  • Weboldal → Fájlok → zip feltöltése → kicsomagolás a legegyszerűbb, ha akadozik a kapcsolatod.
  • SFTP (FileZilla, Cyberduck, rsync) gyorsabb az ismételt telepítésekhez. A szerver, a port, a felhasználónév és a jelszó a Weboldal → SSH és SFTP oldalon található.

3. lépés — az indítófájl hozzáadása

Ezt a fájlt futtatja a Passenger, amikor kérés érkezik. Tedd a package.json mellé az alkalmazás mappájában.

Next.js esetén — 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}`)
  })
})

Mit csinál:

  • Betölti a Nextet, és az aktuális könyvtárra irányítja (ahol a .next/ és a package.json van).
  • A Next belső útválasztójából kéréskezelőt készít.
  • HTTP-szervert indít a Passenger által kiosztott porton (process.env.PORT).
  • Helyi teszteléshez a 3000-es portot használja tartalékként.

A dev értéke automatikusan a NODE_ENV-ből jön — állítsd be a panelben a Production módot (a 4. lépésben megtesszük), és a Next éles módban fut.

Nuxt 3 esetén — 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}`)
    })
  })
})

Mit csinál:

  • Dinamikusan importálja a Nuxt .output/server/index.mjs fájlját (az npm run build által létrehozott belépési pontot).
  • A createApp() segítségével elkészíti a H3 szerverpéldányt.
  • A Passenger által kiosztott porton figyel.

A dinamikus import() szándékos — a .mjs modulokat nem lehet require()-rel betölteni, de egy .cjs fájl dinamikusan importálhatja őket. Ez a legtisztább minta, ami a Passenger indítójában működik.

4. lépés — az alkalmazás létrehozása a panelben

Nyisd meg a projektedet → Weboldal → Node.js és Python → Node.js alkalmazás.

MezőÉrték
Verzió20 vagy újabb
MódProduction
Mappamyapp a saját mappádban (ahová a fájlokat feltöltötted)
Címdomained.hu (vagy egy aldomain, például app.domained.hu)
Indítófájlserver.cjs

Kattints a Létrehozás gombra. A Node.js környezet a ~/nodevenv/myapp/20/ alatt jön létre.

A függőségek telepítése

Az alkalmazás létrehozása után kattints rajta a Függőségek telepítése (npm install) gombra, és figyeld a kimenetet. Ha hibát ad:

  • Ellenőrizd, hogy a package.json az alkalmazás gyökerében van-e (nem egy almappában).
  • Next.js esetén: a next a dependencies között legyen, ne a devDependencies alatt (az éles telepítés kihagyja a fejlesztői függőségeket).
  • Nuxt esetén: maga a nuxt is normál függőség legyen.

Környezeti változók hozzáadása

Az alkalmazás Beállítások → Környezeti változók → Változó hozzáadása. A Production mód már beállítja a NODE_ENV=production értéket.

A futásidőben olvasott értékeket (adatbázis URL-ek, API-kulcsok) Next.js alkalmazásoknál itt add meg. Ne tölts fel titkos adatokat tartalmazó .env fájlt — ezeknek az alkalmazás környezeti változóiban a helyük.

A beállítások mentése újraindítja az alkalmazást, így az új változók azonnal érvénybe lépnek.

5. lépés — ellenőrzés

Nyisd meg az alkalmazás URL-jét. Az alkalmazásodnak kell megjelennie.

Ha Passenger hibaoldalt látsz, nyisd le, és nézd meg az alját — szinte mindig ott egy egyértelmű stack trace. A két leggyakoribb:

Error: Cannot find module 'next' — az npm install nem futott le, vagy rossz mappában futott. Kattints újra a Függőségek telepítése (npm install) gombra.

Error: ENOENT: no such file or directory, open '.next/...' — a forráskódot feltöltötted, de a lefordított .next/ könyvtárat nem. Buildeld helyben, és töltsd fel újra.

Frissítések telepítése

Ismételd meg az 1. és 2. lépést, majd kattints az alkalmazás Újraindítás gombjára. Konkrétan:

1. Helyi build       npm run build
2. Feltöltés         .next/ vagy .output/, plusz a módosult forrás/konfiguráció
3. Panel             Az alkalmazás újraindítása

Ha módosítod a package.json fájlt, újraindítás előtt kattints a Függőségek telepítése (npm install) gombra. Inkább parancssort használnál? Weboldal → Terminál: az alkalmazás kártyáján látod a parancsot, amellyel beléphetsz a környezetébe.

Gyakori buktatók

WebSocketek: a Passenger kezeli a HTTP/1.1-et és a HTTP/2-t. A WebSocket upgrade működik a Next.js és a Nuxt beépített útvonalain. Ha külön WebSocket-szervert használsz (ws, socket.io), az ugyanazon a porton osztozik, és ugyanabból a server.cjs fájlból indul — külön beállítás nélkül.

Fájlfeltöltések / next.config.js body-parser korlátok: a Passenger alapértelmezett kéréstörzs-korlátja 10 MB. Ha nagy fájlokat töltesz fel, emeld meg a passenger_max_request_size értéket a public_html mappában lévő .htaccess fájllal:

PassengerMaxRequestSize 52428800

(50 MB bájtban.)

Cron feladatok: ha az alkalmazásodnak háttérfeladatok kellenek (hírlevélküldés, ütemezett exportok), ne a webes folyamaton belül futtasd őket. A Weboldal → Cron feladatok menüben közvetlenül hívj meg egy Node-szkriptet:

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

Folyamatmemória: a Passenger újraindítja az alkalmazásodat, ha túllépi a fiókonkénti RAM-korlátot (ez a csomagodtól függ). Egy átlagos Next.js / Nuxt alkalmazás tétlenül 100 MB alatt van. Ha eléred a korlátot, a process.memoryUsage() segítségével keress memóriaszivárgást, mielőtt nagyobb csomagra váltanál.

Saját domainek és HTTPS: a Passenger arra a címre köt, amit az alkalmazásnak beállítasz. Az SSL automatikus — külön beállítás nélkül. Másik domainhez vagy aldomainhez előbb add hozzá a Weboldal → Domainek alatt, majd válaszd ki az alkalmazás címeként.

Node-verzió: a Verzió lista minden telepített verziót mutat; az alkalmazás Beállítások oldalán válthatsz.

Mikor ne használj osztott tárhelyet Node-hoz

Őszintén — a Node.js osztott tárhelyen remekül működik portfólióoldalakhoz, blogokhoz, marketingoldalakhoz, kisebb SaaS frontendekhez, belső eszközökhöz. Nehezen boldogul viszont ezekkel:

  • Nagy áteresztőképességű API-k (tartósan >50 kérés/mp) — érezni fogod a fiókonkénti CPU-korlátot
  • Sok WebSocketet használó alkalmazások több ezer egyidejű kapcsolattal
  • Munkafolyamatokat forkoló alkalmazások (sorfeldolgozók, scraperek) — a Passenger fiókonkénti folyamatkerete ezt nehézkessé teszi
  • Bármi, ami systemd-t, Dockert vagy root hozzáférést igényel

Ezekhez a VPS-ünk a jó választás — teljes root, saját kernel, bármit futtathatsz rajta. De a legtöbb Next.js és Nuxt alkalmazáshoz, amely nem kap hatalmas forgalmat, ez az útmutató minden, amire szükséged van.

Röviden

  1. npm run build helyben
  2. Töltsd fel a .next/ (Next) vagy .output/ (Nuxt) könyvtárat + package.json + server.cjs
  3. Weboldal → Node.js és Python → Node.js alkalmazás → a mappa, indítófájl server.cjs, mód Production
  4. Függőségek telepítése (npm install), majd Újraindítás

Ha bármi rendetlenkedik, nyiss egy jegyet — másold be a Passenger hibaoldalát, és megmutatjuk, melyik sorral van a gond.

— A Rivervo csapata