Jak zainstalować Node.js na moim VPS-ie?
W tym artykule
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 zapt 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 zlibnode-dev. Usuń go poleceniami z sekcji Przygotowanie i ponownie wykonajsudo apt install -y nodejs.node -vnadal pokazuje starą wersję: powłoka pamięta starą ścieżkę. Wpiszhash -ralbo zaloguj się ponownie. Poleceniewhich -a nodepokaże, jakie instalacje Node.js istnieją; ta w~/.nvmma 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ę poleceniemsudo 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.
Uruchom swój serwer w 60 sekund na naszym własnym sprzęcie.