Как установить Node.js на VPS с Ubuntu или Debian?
Установить свежую LTS-версию Node.js через NodeSource или nvm на Ubuntu 24.04 и Debian 12, держать приложение в сети с PM2 и запускать его при загрузке
Пакет nodejs из официальных репозиториев ставит Node.js 18 и в Ubuntu 24.04, и в Debian 12, а эта версия не получает исправлений с апреля 2025 года. Для приложения или бота в продакшене ставьте LTS-версию: на 17 ноября 2026 года активная LTS — Node.js 26, Node.js 24 ещё поддерживается. Команды руководства проверены на Ubuntu 24.04 и Debian 12.
Пошаговая инструкция
-
Выберите метод
NodeSource добавляет репозиторий APT: одна версия на всю систему, обновление через apt upgrade. nvm ставит Node.js в папку пользователя и позволяет держать несколько версий рядом. Для одного сервиса хватит NodeSource; для нескольких проектов на разных версиях берите nvm.
-
Установить через NodeSource
От root скачайте скрипт setup_26.x, при желании прочитайте его, запустите через bash, затем выполните apt install -y nodejs. npm уже входит в пакет: не ставьте дополнительно пакет npm из дистрибутива.
-
Или установить через nvm
Под пользователем, от которого будет работать приложение, сначала установите curl и libatomic1, затем запустите скрипт установки nvm v0.41.0. Перезагрузите оболочку командой source ~/.bashrc, после чего nvm install --lts поставит последнюю LTS и сделает её версией по умолчанию.
-
Проверить версии
node -v должен показать v26 с номером исправления, а npm -v — версию 11. Если node -v всё ещё выводит v18, первым находится старый пакет дистрибутива: which node покажет, какой файл используется.
-
Запустить приложение через PM2
Установите PM2 командой npm install -g pm2, перейдите в папку проекта и выполните pm2 start index.js --name app. PM2 перезапускает процесс при падении; pm2 logs app показывает вывод, а pm2 restart app перезапускает его после обновления кода.
-
Запускать при загрузке VPS
pm2 startup создаёт службу systemd; для пользователя без root он выводит команду sudo env PATH=, которую нужно скопировать без изменений. Затем выполните pm2 save, чтобы сохранить список процессов, которые PM2 восстановит после перезагрузки.
Node.js 26 LTS через NodeSource (root)
apt update && apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_26.x -o nodesource_setup.sh
bash nodesource_setup.sh
apt install -y nodejs
node -v
npm -v
Node.js через nvm (пользователь приложения)
sudo apt install -y curl libatomic1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm install 24
nvm alias default 26
nvm ls
PM2: запуск, наблюдение и автозапуск
npm install -g pm2
cd ~/app
pm2 start index.js --name app
pm2 list
pm2 logs app --lines 50
pm2 startup
pm2 save
Перед началом
Нужен доступ к VPS по SSH и отдельный пользователь для приложения вместо root: его создаёт adduser app. Если apt install nodejs уже выполнялся, удалите эту старую версию командой apt remove nodejs до перехода на NodeSource или nvm, чтобы два бинарника не конфликтовали.
- Простое приложение на Node.js или Discord-бот работает с объёмом RAM меньше 200 МБ; установка зависимостей через npm на несколько секунд требует больше.
- Поле engines в package.json или файл .nvmrc указывает версию, которую ждёт проект.
Несколько версий через nvm
nvm install 24 ставит Node.js 24 рядом с 26, nvm use 24 переключает текущую оболочку, а nvm alias default 26 задаёт версию для новых оболочек. В папке с файлом .nvmrc, где записано 24, команда nvm use без аргументов загрузит нужную версию. Версии от nvm лежат в ~/.nvm: они существуют только для этого пользователя, поэтому служба systemd или задача cron должны вызывать полный путь к бинарнику или работать через PM2.
Открыть приложение в интернет
Discord-боту не нужен входящий порт: он сам подключается к Discord. А API или сайт слушает порт, например 3000. Правильнее всего оставить его на 127.0.0.1 и поставить перед ним Nginx с сертификатом Let’s Encrypt; иначе откройте порт в UFW и в файрволе панели.
Частые ошибки и их решение
Большинство ошибок возникает из-за версии Node.js, отличной от ожидаемой, или из-за оболочки, которая не загрузила nvm.
- nvm: command not found сразу после установки: оболочка ещё не прочитала ~/.bashrc. Выполните source ~/.bashrc или откройте новую сессию SSH.
- node: error while loading shared libraries: libatomic.so.1 при установке через nvm: в минимальной системе нет этой библиотеки. apt install libatomic1 исправляет ошибку без переустановки Node.js.
- npm ERR! code EACCES при npm install -g: глобальная папка принадлежит root. С NodeSource ставьте глобальные инструменты от root; с nvm запускайте команду без sudo.
- SyntaxError: Unexpected token или ERR_REQUIRE_ESM при запуске: проекту нужна более новая версия. Сравните node -v с полем engines в package.json.
- Приложение не поднимается после перезагрузки VPS: после последнего pm2 start не выполнили pm2 save, или не запустили команду, которую вывел pm2 startup.
VPS или хостинг ботов?
Для одного Discord-бота на Node.js хостинг ботов ACLClouds избавляет от всей этой установки: вы загружаете код, панель ставит зависимости, держит бота онлайн 24/7 и перезапускает его при падении. Бесплатный тариф (315 МБ RAM) поддерживает Node.js и Python; тариф Starter стоит 2,99 € в месяц или 2,39 € в месяц при оплате на год (цены на 17 ноября 2026 года).
VPS оправдан для нескольких приложений, API с базой данных или когда нужен полный контроль. VPS Mini (2 vCPU, 8 ГБ RAM, 40 ГБ хранилища) стоит 4,99 € в месяц без обязательств или 3,99 € в месяц при оплате на год, сеть — до 1 Гбит/с.
Быстрая проверка
- node -v показывает LTS-версию (v26 или v24).
- pm2 list показывает приложение в статусе online.
- Приложение само поднимается после перезагрузки VPS.
- Приложение работает не от root.
Часто задаваемые вопросы
Почему не ставить Node.js через apt install nodejs?
В репозиториях Ubuntu 24.04 и Debian 12 лежит Node.js 18, поддержка которого закончилась в апреле 2025 года, а многим свежим библиотекам, например Vite 8 или ESLint 10, нужна версия новее. NodeSource или nvm ставят поддерживаемую LTS.
NodeSource или nvm: что выбрать?
NodeSource подходит серверу с одним приложением: Node.js доступен всем пользователям и обновляется вместе с системой. nvm подходит, когда проектам нужны разные версии, или чтобы попробовать новую версию, не трогая рабочую.
Как обновить Node.js до новой LTS?
С NodeSource apt upgrade ставит исправления той же основной версии; чтобы перейти на новую основную версию, снова запустите скрипт новой версии, а затем apt install nodejs. С nvm команда nvm install --lts --reinstall-packages-from=current ставит новую LTS и переносит в неё глобальные пакеты, включая PM2. Затем перезапустите приложение и проверьте журналы.
PM2 или systemd, чтобы приложение не падало?
Оба перезапускают процесс после падения и при загрузке VPS. PM2 удобнее для нескольких приложений на Node.js: pm2 list, pm2 logs и режим кластера; systemd не требует дополнительных инструментов и подходит для одного сервиса. Не используйте оба для одного и того же приложения.