/
mc-node.net →
VPS

Jak zainstalować Node.js na moim VPS-ie?

Zaktualizowano 07/11/20264 min czytania
W tym artykule
  1. Którą wersję wybrać?
  2. Przygotowanie: usuń starą wersję
  3. Metoda 1: NodeSource (zalecana)
  4. Metoda 2: nvm (dla jednego użytkownika)
  5. Sprawdź wersję
  6. Aktualizacja
  7. Najczęstsze problemy
  8. Potrzebujesz pomocy?

Node.js przyda się m.in. do botów Discord, aplikacji webowych i nowoczesnych narzędzi, takich jak agenci AI. Oczywiste apt install nodejs to jednak zły pomysł: Ubuntu i Debian instalują w ten sposób starą wersję. Na Ubuntu 24.04 dostaniesz Node.js 18, a na Ubuntu 22.04 nawet Node.js 12. Żadna z nich nie jest już wspierana przez projekt Node.js. Wiele aktualnych programów w ogóle się na nich nie uruchomi; OpenClaw wymaga na przykład co najmniej Node.js 24.16. W tym poradniku zainstalujesz aktualną wersję LTS w oficjalny sposób i sprawdzisz wersję. Kroki dotyczą VPS-a z Linuksem (Ubuntu lub Debian); na VPS-ie z Windowsem użyj instalatora ze strony nodejs.org.

Którą wersję wybrać?

Wybierz wersję LTS (Long Term Support): przez lata dostaje poprawki bezpieczeństwa. Od 28 października 2026 r. jest to Node.js 26 i ta wersja występuje w poleceniach poniżej. Node.js 24 jest jeszcze utrzymywany do 30 kwietnia 2028 r.; jeśli program wymaga właśnie wersji 24, zamień 26 na 24. Które wersje są obecnie LTS, sprawdzisz na nodejs.org.

Są dwie oficjalne drogi. Wybierz jedną: mieszanie obu prowadzi do zamieszania, który node właściwie działa.

  • NodeSource (zalecane na serwerze): Node.js trafia jako zwykły pakiet do /usr/bin/node, dla wszystkich użytkowników i usług, a aktualizacje przychodzą razem z apt upgrade.
  • nvm (Node Version Manager): instaluje Node.js osobno dla każdego użytkownika w jego katalogu domowym. Przydaje się, gdy chcesz mieć kilka wersji obok siebie. Tę metodę pokazuje też strona pobierania nodejs.org.

Przygotowanie: usuń starą wersję

Połącz się z VPS-em przez SSH (zobacz łączenie z VPS-em przez SSH). Jeśli jesteś zalogowany jako root, sudo przed poleceniami możesz po prostu zostawić. Najpierw sprawdź, czy Node.js jest już zainstalowany:

node -v

Jeśli widzisz command not found, przejdź od razu do jednej z metod. Jeśli widzisz starą wersję, np. v18.19.1 lub v12.22.9, najpierw ją usuń. W przeciwnym razie instalacja zatrzyma się na konflikcie z pakietem libnode-dev:

sudo apt remove -y nodejs npm libnode-dev
sudo apt autoremove -y

Metoda 1: NodeSource (zalecana)

Wykonaj te polecenia po kolei:

sudo apt update
sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_26.x -o nodesource_setup.sh
sudo -E bash nodesource_setup.sh
sudo apt install -y nodejs

Skrypt NodeSource dodaje do apt ich repozytorium pakietów i klucz podpisu; ostatnia linia instaluje Node.js. npm jest już w zestawie, nie instaluj go osobno. Jeśli chcesz najpierw zobaczyć, co robi skrypt, przed czwartą linią obejrzyj go poleceniem less nodesource_setup.sh.

Metoda 2: nvm (dla jednego użytkownika)

Zaloguj się jako użytkownik, który będzie korzystał z Node.js, bo nvm zapisuje wszystko w jego katalogu domowym. W minimalnej instalacji czasem brakuje curl i libatomic1 (bez tej drugiej Node.js się nie uruchomi), dlatego pierwsza linia je instaluje:

sudo apt install -y curl libatomic1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 26

Trzecia linia od razu wczytuje nvm do bieżącej sesji; przy kolejnym logowaniu dzieje się to automatycznie. Najnowszy numer wersji nvm (tutaj v0.41.0) znajdziesz na GitHubie.

Uwaga: Node.js z nvm znajduje się tylko w twoim katalogu domowym. Usługa systemd ani inny użytkownik nie znajdą go automatycznie. Jeśli bot lub aplikacja ma działać jako usługa, wygodniejszy jest NodeSource.

Sprawdź wersję

node -v
npm -v

Zobaczysz teraz na przykład v26.13.0 i 11.20.0. Jeśli wersja Node zaczyna się od v26 (albo v24, jeśli ją wybrałeś), wszystko gotowe.

Aktualizacja

W przypadku NodeSource nowe wydania w tej samej linii (np. z 26.13 na 26.14) przychodzą razem z sudo apt update && sudo apt upgrade. Na nową wersję główną przejdziesz, uruchamiając skrypt instalacyjny tej wersji, a potem ponownie sudo apt install -y nodejs. W nvm polecenie nvm install 26 pobiera najnowszą wersję 26.x.

Najczęstsze problemy

  • trying to overwrite '/usr/include/node/common.gypi': stary Node.js z Ubuntu jest nadal zainstalowany, razem z libnode-dev. Usuń go poleceniami z sekcji Przygotowanie i ponownie wykonaj sudo apt install -y nodejs.
  • node -v nadal pokazuje starą wersję: powłoka pamięta starą ścieżkę. Wpisz hash -r albo zaloguj się ponownie. Polecenie which -a node pokaże, jakie instalacje Node.js istnieją; ta w ~/.nvm ma pierwszeństwo przed wersją z NodeSource.
  • nvm: command not found: bieżąca sesja nie zna jeszcze nvm. Zaloguj się ponownie albo wykonaj \. "$HOME/.nvm/nvm.sh".
  • error while loading shared libraries: libatomic.so.1: zainstaluj brakującą bibliotekę poleceniem sudo apt install -y libatomic1.
  • Tani VPS (OpenVZ): oficjalne kompilacje Node.js są przeznaczone dla jądra Linux 4.18 lub nowszego. W OpenVZ dzielisz jądro z hostem; sprawdzisz je poleceniem uname -r. Jeśli jest starsze, Node.js może działać, ale nie jest to oficjalnie wspierane. Do wymagających aplikacji Node bezpieczniejszym wyborem jest VPS KVM.

Potrzebujesz pomocy?

Nie możesz sobie poradzić? Otwórz zgłoszenie na naszej stronie wsparcia i dołącz wynik node -v oraz pełny komunikat błędu.