cPanel tárhelyeinken Node.js alkalmazást is futtathatsz. Az alkalmazásokat a CloudLinux Node.js Selector kezeli, amely a cPanelben Setup Node.js App néven érhető el. Itt választhatod ki a Node.js verziót, és itt indíthatod, állíthatod le és indíthatod újra az alkalmazást. Az alkalmazást a Phusion Passenger futtatja, így nem kell külön portot nyitnod vagy folyamatkezelőt (például pm2-t) használnod.
Általános áttekintést a Node.js alkalmazások hosztolásáról szóló blogbejegyzésben találsz.
Az alkalmazás létrehozása
- Jelentkezz be a cPanelbe, és a Szoftver csoportban kattints a Setup Node.js App ikonra. A megnyíló Node.js oldal WEB ALKALMAZÁSOK listája mutatja a már létrehozott alkalmazásokat.
- Kattints az ALKALMAZÁS LÉTREHOZÁSA gombra.
- Töltsd ki a mezőket:
- Node.js verzió: a használni kívánt Node.js verzió. Válaszd azt, amelyre az alkalmazásodat fejlesztetted.
- Alkalmazás módja:
Production(éles) vagyDevelopment(fejlesztői) mód. Ez aNODE_ENVkörnyezeti változó értéke lesz. - Alkalmazás root: az alkalmazás könyvtára a tárhelyen, a saját könyvtáradhoz (
/home/felhasznalo) viszonyítva, példáulnodeapp. Ne apublic_htmlkönyvtárat add meg, mert így a forráskód nyilvánosan letölthető lenne. - Alkalmazás URL: a domain és az útvonal, ahol az alkalmazás elérhető lesz, például
pelda.huvagypelda.hu/api. - Alkalmazás indító fájl: az alkalmazás belépési fájlja, például
app.js. - Passenger napló fájl: ha megadsz egy fájlt, például
/home/felhasznalo/logs/nodeapp.log, ide kerülnek az alkalmazás kimenetei és hibaüzenetei.
- Kattints a jobb felső sarokban a LÉTERHOZÁS gombra (a felület így, elírva mutatja).
A cPanel létrehozza a könyvtárat, és ha a belépési fájl még nem létezik, egy egyszerű „It works!” mintaalkalmazást tesz bele. Az Alkalmazás URL címen ellenőrizheted, hogy működik-e.
Az alkalmazás feltöltése
Töltsd fel az alkalmazás fájljait az Alkalmazás root könyvtárba a Fájlkezelővel vagy FTP-n. Egy minimális Express-alkalmazás így néz ki:
const express = require('express');
const app = express();
app.get('/', (req, res) => {
res.send('Helló a Node.js alkalmazásból!');
});
app.listen(process.env.PORT || 3000);
A portot nem kell beállítanod: a Passenger átveszi az alkalmazás listen() hívását, és a beérkező kéréseket az alkalmazáshoz irányítja.
Fontos: a Passenger csak CommonJS modulokat (require) tud közvetlenül betölteni. Ha az alkalmazásod ES modulokat (import) használ, hozz létre egy app_wrapper.cjs fájlt az alábbi tartalommal, és ezt add meg belépési fájlként:
(() => import('./app.js'))();
Csomagok telepítése
A függőségeket az alkalmazás könyvtárában lévő package.json fájl alapján telepítheted:
- Töltsd fel a
package.jsonfájlt az Alkalmazás root könyvtárba. - A Setup Node.js App felületen kattints az alkalmazás melletti szerkesztés (ceruza) ikonra.
- Az Érzékelt konfigurációs fájlok részben megjelenik a
package.json. Kattints Az NPM telepítő futtatása gombra.
Fontos: a Node.js Selector a csomagokat az alkalmazás könyvtárán kívül, egy külön virtuális környezetben tárolja, és az alkalmazás könyvtárában csak egy node_modules nevű hivatkozást (symlinket) helyez el. Ezért ne tölts fel saját node_modules könyvtárat. Ha ilyen könyvtár vagy fájl van az alkalmazás gyökerében, a telepítés hibával leáll. Töröld, és telepítsd a csomagokat a fenti módon.
A JS script futtatása gombbal a package.json fájl scripts részében megadott parancsokat (például build) futtathatod.
Környezeti változók
Az alkalmazás szerkesztőoldalán a VÁLTOZÓ HOZZÁADÁSA gombbal környezeti változókat adhatsz meg, például adatbázis-hozzáférést vagy API-kulcsot. Az alkalmazás ezeket a process.env objektumon keresztül éri el, így a jelszavakat nem kell a forráskódba írnod. Mentés után indítsd újra az alkalmazást.
Újraindítás változtatás után
A Passenger a már betöltött alkalmazást futtatja tovább, ezért a fájlok módosítása után az alkalmazást újra kell indítani. Ehhez kattints a szerkesztőoldal tetején az ÚJRAINDÍTÁS gombra, vagy az alkalmazáslista Műveletek oszlopában az újraindítás ikonra. Az ALKALMAZÁS LEÁLLÍTÁSA gombbal leállíthatod, a MEGSEMMISÍT gombbal (vagy a listában a kuka ikonnal) pedig törölheted az alkalmazást.
Parancssori használat (SSH)
SSH-hozzáféréssel rendelkező csomagokban (cP Premium, cP Pro és cP Pro 100) az alkalmazás virtuális környezetébe a terminálból is beléphetsz. A pontos parancsot a Setup Node.js App felület az alkalmazás szerkesztőoldalának tetején mutatja, és így néz ki:
source /home/felhasznalo/nodevenv/nodeapp/20/bin/activate && cd /home/felhasznalo/nodeapp
Ezután a node és az npm parancs a kiválasztott verzióval fut, így például az npm install is használható. Az SSH-belépést az SSH-kulcs cPanelben való beállításáról szóló cikk írja le.
Automatizálás parancssorból (cloudlinux-selector)
SSH-hozzáféréssel rendelkező csomagokban a Setup Node.js App felület lépései a cloudlinux-selector paranccsal is elvégezhetők, így az alkalmazás létrehozása és frissítése szkriptből vagy CI/CD folyamatból is automatizálható. A parancs a saját felhasználóddal fut, root-jogosultság nem kell hozzá. A Node.js Selectorhoz nincs dokumentált webes API, és a cPanel UAPI sem kezeli ezeket az alkalmazásokat, ezért az automatizáláshoz SSH-kapcsolatra van szükség.
Az alkalmazást így hozhatod létre:
A="--json --interpreter nodejs"
R="--app-root nodeapp"
cloudlinux-selector create $A --domain pelda.hu $R --app-uri api --version 22 \
--app-mode production --startup-file app.js \
--env-vars '{"KULCS":"ertek"}' \
--passenger-log-file=/home/felhasznalo/logs/nodeapp.log
Az --interpreter nodejs kapcsolót minden parancsnál meg kell adni, mert az alapértelmezés a PHP. Az --app-root a saját könyvtáradhoz viszonyított útvonal, a --domain és az --app-uri együtt adja az Alkalmazás URL-t (itt pelda.hu/api), az --app-mode értéke production vagy development.
Ezután töltsd fel a fájlokat az Alkalmazás root könyvtárba, például SFTP-n vagy rsync paranccsal, majd telepítsd a csomagokat, futtasd a szükséges szkriptet, és indítsd újra az alkalmazást:
cloudlinux-selector install-modules $A $R
cloudlinux-selector run-script $A $R --script-name build
cloudlinux-selector restart $A $R
A többi művelet ugyanígy érhető el:
cloudlinux-selector get $A # alkalmazások és verziók listája
cloudlinux-selector set $A $R --env-vars '{"KULCS":"uj-ertek"}' --new-version 24
cloudlinux-selector set $A $R --app-mode development
cloudlinux-selector stop $A $R
cloudlinux-selector start $A $R
cloudlinux-selector destroy $A $R
Szkriptben az alábbiakra figyelj:
- Sikeres parancs után a JSON-kimenet
resultmezőjének értékesuccess. Ezt a szkriptben ellenőrizd. - A
run-scripta szkript kimenetét és visszatérési kódját base64-kódolva adja vissza adatamezőben. Abase64 -dparanccsal olvashatóvá teheted. - Ha a
setparanccsal Node.js verziót vagy környezeti változót módosítasz, az alkalmazás az újraindítás után még néhány másodpercig a korábbi értékekkel válaszolhat. Verzióváltás után ellenőrizd, hogy az alkalmazás ténylegesen melyik verzióval fut (process.version). A telepített csomagokat a verzióváltás után nem kellett újratelepíteni. - A leállított alkalmazás címe 403-as hibát ad.
- A
destroya virtuális környezetet törli, de a forráskódot nem. Az Alkalmazás root könyvtárat, a naplófájlt és a domain gyökérkönyvtárában az útvonalhoz létrejött mappát (példáulpublic_html/api, benne egy üres.htaccessfájllal) kézzel töröld, mert amíg ez a mappa megvan, a cím 403-as hibát ad.
Hibakeresés
- Ha az alkalmazás nem indul el, nézd meg a Passenger napló fájl mezőben megadott naplófájlt.
- Fejlesztés közben a
Developmentmód részletesebb hibaüzeneteket jelenít meg. Éles oldalon ne hagyd bekapcsolva. - Az alkalmazás a tárhelyfiók erőforrás-limitjein belül fut. Ha memóriahiány miatt leáll, ellenőrizd az erőforrás-használatot.

