Máte hotovou Node.js aplikaci a potřebujete ji dostat z počítače na server, kde poběží nonstop? Tento návod vás provede nasazením krok za krokem — od nahrání kódu přes spuštění procesu až po napojení na doménu. Předpokládáme spravovaný Node.js hosting nebo VPS s přístupem k terminálu; pokud teprve vybíráte, projděte si nejdřív, na co u Node.js hostingu koukat.
Než začnete: co budete potřebovat
Připravte si tři věci: hosting s podporou Node.js (a verzí, kterou vaše aplikace potřebuje), SSH přístup k serveru a kód v gitu (ideálně) nebo připravený k nahrání. Ověřte si taky, jaký process manager hosting nabízí — nejčastěji PM2.
1. Nahrání kódu na server
Nejčistší cesta je git clone přímo na serveru: přihlaste se přes SSH, přejděte do složky aplikace a naklonujte repozitář. Alternativně nahrajete soubory přes SFTP — ale složku node_modules nikdy nenahrávejte, závislosti nainstalujete až na serveru. Nezapomeňte na .env soubor s produkčními proměnnými (ten do gitu nepatří, vytvořte ho ručně).
2. Instalace závislostí
Ve složce aplikace spusťte npm install --production (nebo npm ci, pokud máte package-lock.json — je rychlejší a spolehlivější). Pokud aplikace vyžaduje build krok (TypeScript, frontend framework), spusťte i npm run build. Zkontrolujte, že běží správná verze Node: node -v.
3. Spuštění aplikace přes PM2
Aplikaci nespouštějte přes node app.js — po odhlášení nebo pádu by skončila. Použijte PM2: pm2 start app.js --name mojeapp. Pak pm2 save a pm2 startup, aby se aplikace sama nastartovala po rebootu serveru. Stav zkontrolujete přes pm2 status a logy přes pm2 logs.
4. Reverse proxy a doména
Node aplikace běží na nějakém portu (třeba 3000), ale návštěvníci chodí na port 80/443. Mezi ně patří reverse proxy — obvykle nginx nebo Passenger — která požadavky z vaší domény přepošle na port aplikace a vyřídí HTTPS certifikát. Na spravovaném hostingu tohle často nastavíte pár kliky v panelu; na čistém VPS si nginx nakonfigurujete sami.
Časté problémy
- Špatná verze Node — moderní balíčky spadnou na staré verzi; přepněte verzi v panelu nebo přes nvm.
- Aplikace nejede po rebootu — zapomněli jste
pm2 save+pm2 startup. - Chybí proměnné prostředí —
.envna serveru neexistuje nebo ho aplikace nenačítá. - Port je obsazený — jiná aplikace už na daném portu běží; změňte port v
.env.
Shrnutí
Nasazení Node.js aplikace je čtyřkrokový proces: nahrát kód → nainstalovat závislosti → spustit přes PM2 → napojit doménu přes reverse proxy. Nejvíc problémů dělá verze Node a trvalý běh procesu — obojí vyřešíte, když si předem ověříte, že hosting Node.js a PM2 opravdu podporuje. Vhodné poskytovatele najdete v naší kategorii Node.js hosting.
