Jak wdrożyć aplikację Node.js na VPS

Jak wdrożyć aplikację Node.js na VPS

Stworzyłeś API dla aplikacji mobilnej, usługi rezerwacji online lub małego sklepu internetowego, który idealnie działa na twoim komputerze. Jednak nikt go nie widzi, a za każdym razem, gdy wyłączasz laptopa, oprogramowanie przestaje działać. Aby mogli z niego korzystać inni ludzie, potrzebny jest serwer, który działa 24/7, ma stały adres IP, domenę i HTTPS. Aby zaoszczędzić twój czas, przygotowaliśmy krok po kroku instrukcję, jak wdrożyć aplikację Node.js na VPS: od pustego serwera do działającego programu pod twoim adresem.

Krok po kroku instrukcja tworzenia aplikacji Node.js na VPS

Co przygotować przed wdrożeniem

Na początek musisz wynająć sam wirtualny serwer. Przy wynajmie VPS domyślnie instalowany jest Ubuntu 24.04, pod które napisane są wszystkie polecenia w tym artykule. Dla jednej małej aplikacji wystarczy 2 GB pamięci RAM, jeśli obok będzie działać baza danych — 4 GB, dla ciężkich stron na Next.js — 8 GB.

Od razu dodaj w panelu zarządzania domeną rekord A z adresem IP serwera, który otrzymasz na e-mail po aktywacji. Aktualizacja DNS zajmuje czas, więc podczas gdy konfigurujesz serwer, rekord zdąży się aktywować. Kod aplikacji załaduj na GitHub razem z plikiem package-lock.json, w którym zapisane są dokładne wersje bibliotek.

Razem z adresem IP na e-mail przyjdzie hasło użytkownika root. Połącz się z serwerem przez SSH poleceniem, które jest takie samo na Windows 10/11, macOS i Linux:

ssh root@adres-IP-serwera

Następnie musisz stworzyć nowego użytkownika i nadać mu prawo do korzystania z sudo (przydomek, który włącza uprawnienia administratora dla jednego polecenia):

adduser deploy

usermod -aG sudo deploy

Po tym połącz się jako ssh deploy@adres-IP-serwera i dalej pracuj w imieniu tego użytkownika.

Przeczytaj także: Czym jest SSH i podstawowe sposoby pracy z nim

Jak zainstalować Node.js na serwerze

Na VPS nie ma nic z twojego laptopa, więc Node.js trzeba zainstalować na nowo, przy czym tej samej wersji, na której rozwijałeś aplikację. W przeciwnym razie część kodu lub bibliotek może nie działać. 

Najpierw sprawdź wersję na komputerze poleceniem node -v. Do pracy w internecie oficjalna dokumentacja zaleca tylko wersje LTS. Z harmonogramu wydań obecnie to Node.js 22, 24 i 26 (status LTS od 28 października 2026 roku). Jeśli masz 18 lub 20, najpierw zaktualizuj Node.js na komputerze i sprawdź, czy twój projekt działa.

Ważne! Nie używaj polecenia sudo apt install nodejs. W Ubuntu 24.04 zainstaluje to Node.js 18, którego wsparcie już zostało zakończone. Potrzebną wersję lepiej wziąć z repozytorium NodeSource. 

Aby zainstalować wersję 24, użyj polecenia:

curl -fsSL https://deb.nodesource.com/setup_24.x -o nodesource_setup.sh

sudo -E bash nodesource_setup.sh

sudo apt install -y nodejs

node -v

Ostatnie polecenie powinno pokazać tę samą wersję, co na komputerze. Razem z Node.js instalowany jest npm, a aktualizacje zabezpieczeń będą przychodzić z sudo apt upgrade.

Jak uruchomić aplikację Node.js na VPS

Najpierw skopiuj kod na serwer i zainstaluj biblioteki:

git clone https://github.com/twoje-konto/myapp.git

cd myapp

npm ci --omit=dev

Polecenie npm ci instaluje biblioteki z listy z package-lock.json, a --omit=dev pomija narzędzia deweloperskie. Jeśli aplikacja musi być kompilowana, na przykład w TypeScript lub Next.js, zamiast tego wykonaj npm ci i npm run build.

Hasła i klucze API są przechowywane w pliku .env, który nie trafia do Gita, więc stwórz go na serwerze poleceniem nano .env i wpisz te same linie, co lokalnie. Zapisz plik kombinacją Ctrl+O i Enter, wyjdź przez Ctrl+X i zamknij dostęp dla osób trzecich poleceniem chmod 600 .env.

Następnie sprawdź, na jakim adresie działa twój projekt. Aplikacja powinna przyjmować zapytania tylko z wewnątrz serwera, a odwiedzających do niej przepuszczać Nginx, którego skonfigurujemy dalej. W tym celu w kodzie musi być podany adres 127.0.0.1. Dla frameworka Express wygląda to tak:

app.listen(3000, '127.0.0.1');

Jeśli uruchomisz aplikację zwykłym poleceniem node server.js, zatrzyma się ona razem z połączeniem SSH lub po pierwszym błędzie. Dlatego skorzystaj z menedżera procesów PM2, który restartuje aplikację po awarii i ponownym uruchomieniu serwera:

sudo npm install -g pm2

pm2 start server.js --name myapp --node-args="--env-file=.env"

pm2 startup

pm2 save

Zamiast server.js podaj główny plik aplikacji. Parametr --node-args przekazuje flagę --env-file, aby aplikacja mogła uzyskać sekrety (hasła Bazy Danych, klucze systemów płatniczych) z .env. Polecenie pm2 startup wyświetli jeszcze jedno polecenie, które należy skopiować i wykonać, aby włączyć autostart. Na koniec sprawdź wynik przez pm2 status: obok myapp powinno stać online.

Krok po kroku uruchomienie aplikacji Node.js na VPS

Jak otworzyć aplikację dla odwiedzających przez Nginx

Aby każdy chętny mógł widzieć i korzystać z twojej aplikacji, użyj Nginx — serwera, który przyjmuje odwiedzających na portach 80 i 443, i przekazuje zapytania do aplikacji. Zainstaluj go i stwórz plik konfiguracyjny:

sudo apt install -y nginx

sudo nano /etc/nginx/sites-available/myapp

Wstaw do niego taki tekst, zastępując example.com swoją domeną:

server {

    listen 80;

    server_name example.com www.example.com;

    location / {

        proxy_pass http://127.0.0.1:3000;

        proxy_http_version 1.1;

        proxy_set_header Upgrade $http_upgrade;

        proxy_set_header Connection 'upgrade';

        proxy_set_header Host $host;

        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        proxy_set_header X-Forwarded-Proto $scheme;

    }

}

Linia proxy_pass przekazuje zapytania aplikacji na port 3000, a Upgrade i Connection są potrzebne dla WebSocket, na którym działają czaty i powiadomienia w czasie rzeczywistym. Włącz konfigurację i sprawdź ją poleceniem:

sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/

sudo nginx -t

sudo systemctl reload nginx

Jeśli nginx -t poinformował, że nie ma błędów, otwórz http://twoja-domena.com w przeglądarce, gdzie powinna pojawić się twoja aplikacja. Dla każdego kolejnego projektu na tym serwerze twórz oddzielny taki plik ze swoją domeną i portem.

Jak podłączyć darmowy HTTPS

Certyfikat dla HTTPS bezpłatnie wydaje Let’s Encrypt. Na zwykłym hostingu wydaje go i odnawia dostawca, a na VPS tę pracę wykonuje Certbot. Programiści zalecają instalować go przez snap:

sudo snap install --classic certbot

sudo ln -s /snap/bin/certbot /usr/local/bin/certbot

sudo certbot --nginx -d example.com -d www.example.com

sudo certbot renew --dry-run

Certbot poprosi o e-mail do powiadomień i sam skonfiguruje Nginx na https://. Ostatnie polecenie sprawdza automatyczne odnawianie: jeśli nie ma błędów, certyfikat będzie odnawiany automatycznie.

Ważne! Let’s Encrypt sprawdza domenę przez port 80. Jeśli Certbot zgłasza błąd, sprawdź, czy rekord A już wskazuje na adres IP serwera, a port 80 jest otwarty w Firewall w panelu VPS.

Podłączenie darmowego HTTPS do VPS dla aplikacji Node.js

Jak zamknąć zbędne porty

HTTPS chroni dane w drodze do serwera, a zapora chroni sam serwer. Zamknie wszystkie porty, z wyjątkiem potrzebnych: 22 dla SSH, 80 i 443 dla strony. 

Aby nie stracić dostępu przez SSH, włącz wbudowaną w Ubuntu zaporę UFW w następującej kolejności:

sudo ufw allow OpenSSH

sudo ufw allow 'Nginx Full'

sudo ufw enable

Zewnętrzny Firewall w panelu VPS-UP filtruje ruch jeszcze przed serwerem i nie koliduje z UFW. Otwórz w nim te same trzy porty, aby uzyskać dwa poziomy ochrony.

Przeczytaj także: Atak DDoS: metody ochrony serwerów i stron

Jak aktualizować aplikację Node.js po uruchomieniu

Nad aplikacją dalej pracujesz na swoim komputerze, a serwer sam nic nie aktualizuje. Nowa wersja trafia do użytkowników tylko wtedy, gdy ją opublikujesz:

  1. Wprowadź zmiany w kodzie i sprawdź je na localhost.

  2. Wyślij zmiany na GitHub poleceniem git push.

  3. Połącz się z serwerem przez SSH i przejdź do folderu projektu.

  4. Pobierz nową wersję kodu poleceniem git pull.

  5. Zaktualizuj biblioteki poleceniem npm ci --omit=dev.

  6. Zrestartuj aplikację poleceniem pm2 reload myapp.

Jeśli nowa wersja nie uruchamia się, polecenie pm2 logs myapp pokaże błąd. Przywrócenie działającej wersji pomoże git revert HEAD na komputerze: wyślij wynik na GitHub i powtórz kroki 3-6. Przed zmianami samego serwera, na przykład aktualizacją Node.js czy Ubuntu, stwórz Snapshot w panelu, aby w razie potrzeby przywrócić VPS do zapisanego stanu.

Na koniec zrestartuj serwer poleceniem sudo reboot i po minucie otwórz stronę z telefonu. Jeśli aplikacja uruchomiła się sama i otwiera się przez HTTPS, jest gotowa dla realnych użytkowników. A gdy obciążenie przekroczy możliwości VPS, będziesz mógł przejść na dedykowany serwer i powtórzyć te same kroki.

Autor

Богдана Гайворонська

Журналіст (з 2003 року), IT-копірайтер (з 2013 року), контент-маркетолог Cityhost.ua. Спеціалізується на статтях про технології, створення та просування сайтів.