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.

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.

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.
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:
-
Wprowadź zmiany w kodzie i sprawdź je na localhost.
-
Wyślij zmiany na GitHub poleceniem git push.
-
Połącz się z serwerem przez SSH i przejdź do folderu projektu.
-
Pobierz nową wersję kodu poleceniem git pull.
-
Zaktualizuj biblioteki poleceniem npm ci --omit=dev.
-
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.
