Przejdź do głównej treści

Konfiguracja Node.js na serwerze Linux - Uruchamiaj nowoczesne aplikacje JavaScript

Idealne produkty do tego poradnika

Zacznij od razu — zamów odpowiedni produkt i postępuj zgodnie z tym poradnikiem krok po kroku.

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 działających w czasie rzeczywistym.

Paradygmat „JavaScript wszędzie” pozwala deweloperom używać jednego języka zarówno po stronie backendu, jak i frontendu.

Przygotowanie

Zanim zaczniesz konfigurację 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łnione są 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 ściągnąć 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

W środku 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 z oczekiwanym wynikiem 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, by korzystać z bardziej szczegółowych komunikatów błędów 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. To centralny plik konfiguracyjny każdej aplikacji Node.js.

Zależności instalujesz komendą npm install <package>, a zależności developerskie dodajesz przez npm install <package> --save-dev. Sekcja scripts w package.json pozwala definiować własne polecenia, 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 czy wymuszanie konkretnej wersji Node.js. Dzięki temu Twoje aplikacje działają spójnie w różnych środowiskach.

Podsumowanie i dodatkowe zasoby

Gratulacje! Właśnie pomyślnie zainstalowałeś i skonfigurowałeś Node.js na swoim VPS/serwerze dedykowanym. 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 zespołem wsparcia, który jest dostępny codziennie, by Ci pomóc! 🙂