Кратко: самый простой и безопасный способ получить актуальный Node.js (ветка 22+ и выше) на Ubuntu 24.04 и в WSL — добавить официальный репозиторий NodeSource или поставить через менеджер версий nvm. В статье — оба варианта, а также частые ошибки и полезные настройки.
📋 Требования
- Ubuntu 24.04 (Native или WSL)
- Права
sudo - Интернет-доступ
Вариант 1 — NodeSource (быстро для продакшена)
Шаг 1. Обновление системы
sudo apt update && sudo apt upgrade -y
Шаг 2. Базовые зависимости
sudo apt install -y ca-certificates curl gnupg
Шаг 3. Подключение репозитория NodeSource
Установить Node.js 22.x:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
Или последующую ветку (например, 23.x), если нужна новее 22:
curl -fsSL https://deb.nodesource.com/setup_23.x | sudo -E bash -
Шаг 4. Установка Node.js
sudo apt install -y nodejs
Проверка
node -v
npm -v
Ожидаемо: v22.x.x и npm >=10.
Вариант 2 — NVM (гибко для разработки)
NVM позволяет ставить несколько версий Node.js и быстро между ними переключаться — удобно для разработчиков.
Шаг 1. Установка nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
Активируйте nvm в текущей сессии (или просто перезапустите терминал):
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
Шаг 2. Установка Node.js через nvm
Последний стабильный релиз:
nvm install node
Конкретная ветка, например 22:
nvm install 22
nvm use 22
Сделать 22-й по умолчанию:
nvm alias default 22
Проверка
node -v
npm -v
WSL: нюансы и лучшие практики
- Ставьте Node.js внутри WSL, если собираетесь работать в файловой системе Linux (
~/projects), — это ускорит работу npm/pnpm/yarn и избежит конфликтов с Windows. - Храните проекты в Linux-пути, например
~/code, а не на дисках/mnt/c, чтобы избежать деградации производительности. - Если используете VS Code, ставьте расширение Remote – WSL и открывайте папки прямо из WSL.
Полезное после установки
Включить Corepack (yarn/pnpm без глобальной установки)
sudo corepack enable # через NodeSource
# или (если через nvm — без sudo)
corepack enable
corepack prepare pnpm@latest --activate
corepack prepare yarn@stable --activate
Оптимальные настройки npm (глобальный префикс в домашней директории)
Это поможет избегать sudo при глобальных установках:
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
# Для Zsh:
# echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.bashrc # или source ~/.zshrc
Проверка пакетов и диагностика
node -p "process.version"
node -p "process.versions"
npm doctor
Частые ошибки и решения
Недостаточно прав при глобальной установке npm
Симптом: ошибки EACCES при npm i -g ....
Решение: настроить npm на использование каталога в $HOME (см. раздел про глобальный префикс) или использовать corepack/локальные установки.
Старая версия npm после установки Node.js
Обновите npm вручную:
npm i -g npm@latest
Конфликт системного Node.js и nvm
Не смешивайте способы: либо NodeSource, либо nvm. Если нужно переключаться — используйте nvm. Чтобы «почистить» систему от пакета NodeSource:
sudo apt remove -y nodejs
sudo rm -f /etc/apt/sources.list.d/nodesource.list
sudo apt update
Медленная сборка/установка пакетов в WSL
- Храните проект в Linux-пути (
~/project), а не на/mnt/c. - Обновите WSL:
wsl --update(в Powershell) и перезапустите дистрибутив.
Быстрый чек-лист
- Нужна стабильная версия для сервера → NodeSource.
- Нужно переключаться между версиями → nvm.
- WSL: держите код в
~/, используйте VS Code с Remote – WSL. - Включите corepack и/или настройте npm prefix в домашней директории.
Готово 🎉
Теперь у вас установлен актуальный Node.js (> 22) на Ubuntu 24.04 и в WSL. Можно смело запускать современные инструменты (Vite, Next.js, NestJS) и менеджеры пакетов (npm, pnpm, yarn) без лишних танцев с бубном.