Ako nasadiť Node.js aplikáciu na hosting: krok za krokom

Máte hotovú Node.js aplikáciu a potrebujete ju dostať z počítača na server, kde pobeží nonstop? Tento návod vás prevedie nasadením krok za krokom — od nahrania kódu cez spustenie procesu až po napojenie na doménu. Predpokladáme spravovaný Node.js hosting alebo VPS s prístupom k terminálu; ak ešte len vyberáte, prejdite si najskôr, na čo pri Node.js hostingu pozerať.

Než začnete: čo budete potrebovať

Pripravte si tri veci: hosting s podporou Node.js (a verziou, ktorú vaša aplikácia potrebuje), SSH prístup k serveru a kód v gite (ideálne) alebo pripravený na nahranie. Overte si tiež, aký process manager hosting ponúka — najčastejšie PM2.

1. Nahranie kódu na server

Najčistejšia cesta je git clone priamo na serveri: prihláste sa cez SSH, prejdite do priečinka aplikácie a naklonujte repozitár. Alternatívne nahráte súbory cez SFTP — ale priečinok node_modules nikdy nenahrávajte, závislosti nainštalujete až na serveri. Nezabudnite na .env súbor s produkčnými premennými (ten do gitu nepatrí, vytvorte ho ručne).

2. Inštalácia závislostí

V priečinku aplikácie spustite npm install --production (alebo npm ci, ak máte package-lock.json — je rýchlejšie a spoľahlivejšie). Ak aplikácia vyžaduje build krok (TypeScript, frontend framework), spustite aj npm run build. Skontrolujte, že beží správna verzia Node: node -v.

3. Spustenie aplikácie cez PM2

Aplikáciu nespúšťajte cez node app.js — po odhlásení alebo páde by skončila. Použite PM2: pm2 start app.js --name mojaapp. Potom pm2 save a pm2 startup, aby sa aplikácia sama naštartovala po reboote servera. Stav skontrolujete cez pm2 status a logy cez pm2 logs.

4. Reverse proxy a doména

Node aplikácia beží na nejakom porte (napr. 3000), ale návštevníci chodia na port 80/443. Medzi ne patrí reverse proxy — obvykle nginx alebo Passenger — ktorá požiadavky z vašej domény prepošle na port aplikácie a vybaví HTTPS certifikát. Na spravovanom hostingu toto často nastavíte pár klikmi v paneli; na čistom VPS si nginx nakonfigurujete sami.

Časté problémy

1. Zlá verzia Node — moderné balíčky spadnú na starej verzii; prepnite verziu v paneli alebo cez nvm.
2. Aplikácia nejde po reboote — zabudli ste pm2 save + pm2 startup.
3. Chýbajú premenné prostredia — .env na serveri neexistuje alebo ho aplikácia nenačíta.
4. Port je obsadený — iná aplikácia už na danom porte beží; zmeňte port v .env.

Zhrnutie

Nasadenie Node.js aplikácie je štvorkrokový proces: nahrať kód → nainštalovať závislosti → spustiť cez PM2 → napojiť doménu cez reverse proxy. Najviac problémov robí verzia Node a trvalý beh procesu — oboje vyriešite, keď si vopred overíte, že hosting Node.js a PM2 naozaj podporuje. Vhodných poskytovateľov nájdete v našej kategórii Node.js hosting.