Go to main content

Serwer dedykowany: 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 po stronie backendu, jak i frontendu.

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

To zapewni, ż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. Uruchom poniższe polecenie, aby pobrać najnowszy obraz Node.js 22 na swój system, gotowy do uruchamiania 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 ś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, uruchamiając

npm -v — 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 wewnątrz środowiska. 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.

Dobrze zorganizowany katalog projektu zaczyna się od pliku konfiguracyjnego, który tworzysz poleceniem:

npm init -y

To generuje plik package.json, definiujący zależności, skrypty i metadane projektu. 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ą na konfigurację prywatnych rejestrów, opcji cache lub wymuszanie konkretnej wersji Node.js. Dzięki temu Twoje aplikacje działają spójnie na różnych środowiskach.

Podsumowanie i dodatkowe zasoby

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

Masz pytania, których tu nie ma? Jeśli potrzebujesz wsparcia lub masz dodatkowe pytania, śmiało kontaktuj się z naszym zespołem wsparcia, który jest dostępny codziennie, by Ci pomóc! 🙂