Instalacja Node.js i npm na VPS Linux - Dokumentacja Infrawire

Ten przewodnik opisuje instalację Node.js (środowisko uruchomieniowe JavaScript) i npm (menedżer pakietów) na VPS z Ubuntu lub Debian, aby uruchamiać aplikacje WWW (Express, NestJS, narzędzia build itd.).

Wymagania

VPS Linux z dostępem SSH sudo lub root
Ubuntu 20.04+ lub Debian 11+ (64-bit)
Działające połączenie SSH

Rekomendacja

Przy częstych buildach (npm install, kompilacje) wybierz VPS z szybkim dyskiem, np. VPS NVMe.

Zalecana metoda: NodeSource (LTS)

1. Aktualizacja systemu


Bash
sudo apt update && sudo apt upgrade -y

2. Pakiety wstępne


Bash
sudo apt install -y ca-certificates curl gnupg

3. Klucz i repozytorium NodeSource (przykład: Node.js 22.x LTS)

Zamień 22.x na wybraną gałąź LTS według dokumentacji NodeSource.


Bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

4. Instalacja Node.js


Bash
sudo apt install -y nodejs

5. Weryfikacja


Bash
node -v
npm -v

Szybka alternatywa: pakiety dystrybucji


Bash
sudo apt install -y nodejs npm

Wersje mogą być starsze niż z NodeSource. W produkcji lepiej NodeSource lub menedżer wersji (nvm).

Aktualizacja npm (opcjonalnie)


Bash
sudo npm install -g npm@latest

Dobre praktyki

Nie uruchamiaj npm w projekcie jako root: osobny użytkownik lub sudo -u mojuser.
W produkcji rozważ PM2 lub jednostkę systemd, aby aplikacja wstawała po restarcie.
Otwieraj tylko potrzebne porty (firewall, Nginx jako reverse proxy przed aplikacją).

Rozwiązywanie problemów

Permission denied przy globalnym npm install -g: katalog globalny u użytkownika lub nvm.
Command not found po instalacji: ponowne połączenie SSH lub nowa powłoka.

Dalsze kroki: zabezpieczenie SSH oraz Nginx + Certbot pod HTTPS.