Node.js alkalmazás telepítése Rivervo tárhelyre (Next.js és Nuxt).
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 buildEz 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 buildEz 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.
| Keretrendszer | Ezeket töltsd fel | Kihagyható |
|---|---|---|
| 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 apackage.jsonvan). - 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.mjsfájlját (aznpm 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ód | Production |
| Mappa | myapp a saját mappádban (ahová a fájlokat feltöltötted) |
| Cím | domained.hu (vagy egy aldomain, például app.domained.hu) |
| Indítófájl | server.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.jsonaz alkalmazás gyökerében van-e (nem egy almappában). - Next.js esetén: a
nextadependenciesközött legyen, ne adevDependenciesalatt (az éles telepítés kihagyja a fejlesztői függőségeket). - Nuxt esetén: maga a
nuxtis 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ásaHa 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.jsFolyamatmemó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
npm run buildhelyben- Töltsd fel a
.next/(Next) vagy.output/(Nuxt) könyvtárat +package.json+server.cjs - Weboldal → Node.js és Python → Node.js alkalmazás → a mappa, indítófájl
server.cjs, mód Production - 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