Go to main content

VPS: Instalacja Node.js na Linux

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

Zapewnia to, że Twój system ma 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 uruchomić kontener z interaktywną powłoką. Opcja --rm usuwa kontener automatycznie po wyjściu, dzięki czemu środowisko hosta pozostaje czyste.

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

Wewnątrz kontenera sprawdź wersję Node.js poleceniem node -v, które powinno wyświetlić v22.19.0. Możesz też potwierdzić wersję npm poleceniem 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 dostosowując logowanie. Do celów deweloperskich możesz ustawić NODE_ENV=development, aby korzystać z bardziej szczegółowych komunikatów o błędach i funkcji debugowania.

Ważne jest też dobrze zorganizowane drzewo projektu, zaczynając 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 deweloperskie 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ą konfigurować prywatne rejestry, opcje cache lub wymuszać konkretną wersję Node.js. Dzięki temu aplikacje działają spójnie w różnych środowiskach.

Podsumowanie i dodatkowe zasoby

Gratulacje! Właśnie zainstalowałeś i skonfigurowałeś Node.js na swoim VPS. Polecamy też zapoznać się z poniższymi zasobami, które mogą pomóc i wesprzeć Cię podczas konfiguracji serwera:

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