Go to main content

VPS: Instalacja Node.js na Windows

Ten poradnik został stworzony z wykorzystaniem następujących produktów:

(Szczegóły mogą się różnić w zależności od produktów różnych dostawców, ale główne koncepcje pozostają takie same)

Wprowadzenie

Node.js to wieloplatformowe, open-source środowisko uruchomieniowe JavaScript, które wykonuje kod JavaScript poza przeglądarką, np. na serwerach lub w narzędziach wiersza poleceń. Oparte na silniku V8, wspiera asynchroniczne, zdarzeniowe operacje I/O, co czyni je bardzo wydajnym do budowy skalowalnych aplikacji sieciowych i czasu rzeczywistego.

Paradygmat „JavaScript wszędzie” pozwala deweloperom używać jednego języka zarówno na backendzie, jak i frontendzie.

Przygotowanie

Zanim zaczniesz instalować Node.js, musisz przygotować swój system. Obejmuje to aktualizację systemu operacyjnego do najnowszej wersji oraz instalację wszystkich wymaganych zależności. Te przygotowania zapewniają stabilne środowisko i pomagają uniknąć problemów podczas lub po instalacji.

Aktualizacja systemu

Aby mieć pewność, że Twój system działa na najnowszym oprogramowaniu i z poprawkami bezpieczeństwa, zawsze zacznij od aktualizacji systemu. Wykonaj następujące polecenie:

sudo apt update && sudo apt upgrade -y

Dzięki temu Twój system będzie miał najnowsze poprawki bezpieczeństwa i wersje oprogramowania przed dalszymi krokami.

Instalacja zależności

Po zakończeniu aktualizacji możesz przejść do instalacji zależności. Node.js będzie uruchamiany na Twojej maszynie w kontenerach Docker, więc najpierw musisz zainstalować Dockera. Wykonaj poniższe polecenia:

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

Pełny poradnik instalacji i korzystania z Dockera znajdziesz w naszym poradniku Docker.

Instalacja

Gdy spełnisz wszystkie wymagania i przygotowania, możesz przejść do instalacji aplikacji Node.js.

Aby używać Node.js w izolowanym środowisku, najpierw pobierz oficjalny obraz oparty na Alpine. Wykonaj polecenie, aby pobrać najnowszy obraz Node.js 22 na swój system, gotowy do uruchomienia kontenerów:

docker pull node:22-alpine

Następnie uruchom kontener na bazie tego obrazu i otwórz w nim sesję powłoki. Użyj tego polecenia, aby wystartować kontener z interaktywną powłoką. Opcja --rm usuwa kontener automatycznie po wyjściu, dzięki czemu Twój system pozostaje czysty.

docker run -it --rm --entrypoint sh node:22-alpine

W środku kontenera sprawdź wersję Node.js poleceniem node -v, które powinno wyświetlić v22.19.0. Możesz też potwierdzić wersję npm, wpisując

npm -v, a oczekiwany wynik to 10.9.3. To potwierdza, że obraz zawiera odpowiednie wersje Node.js i npm, gotowe do użycia.

Konfiguracja

Po uruchomieniu kontenera Node.js warto skonfigurować podstawowe ustawienia Node.js bezpośrednio w środowisku. Popularnym rozwiązaniem jest definiowanie zmiennych środowiskowych, np.:

export NODE_ENV=production

To włącza tryb produkcyjny, aktywując optymalizacje wydajności i zmieniając sposób logowania. Do celów deweloperskich możesz ustawić NODE_ENV=development, aby korzystać z bardziej szczegółowych komunikatów o błędach i funkcji debugowania.

Dobrze zorganizowany katalog projektu zaczyna się od pliku konfiguracyjnego utworzonego poleceniem:

npm init -y

To generuje plik package.json, który definiuje zależności, skrypty i metadane projektu. Jest to centralny plik konfiguracyjny każdej aplikacji Node.js.

Zależności instalujesz poleceniem npm install <package>, a zależności developerskie dodajesz przez npm install <package> --save-dev. Sekcja scripts w package.json pozwala definiować własne komendy, np. npm start lub npm run build, co ułatwia uruchamianie i zarządzanie projektem.

Dla bardziej zaawansowanych konfiguracji Node.js można dostosować za pomocą plików .npmrc lub .nvmrc, które pozwalają ustawić prywatne rejestry, opcje cache lub wymusić konkretną wersję Node.js. Dzięki temu Twoje aplikacje działają spójnie na różnych środowiskach.

Podsumowanie i dodatkowe zasoby

Gratulacje! Właśnie pomyślnie zainstalowałeś i skonfigurowałeś Node.js na swoim VPS. Polecamy też rzucić okiem na poniższe materiały, które mogą Ci pomóc i wesprzeć podczas konfiguracji serwera:

Masz pytania, które nie zostały tu poruszone? Jeśli potrzebujesz dalszej pomocy, śmiało kontaktuj się z naszym supportem, który jest dostępny codziennie, by Ci pomóc! 🙂