К содержимому

Как установить Node.js через nvm и запустить приложение на Ubuntu 24.04

Node.js на Ubuntu 24.04 ставят через nvm, если нужны разные версии для разных проектов, или из репозитория NodeSource, если нужна одна версия для службы.

Руководство Node.js 3 мин чтения

01Установите nvm и Node.js

nvm ставится в домашний каталог пользователя и позволяет переключать версии Node.js. После установки загрузите nvm в текущую оболочку и поставьте нужную LTS-версию: 22 или 20. Команда nvm install --lts ставит последнюю LTS, а nvm install 20 фиксирует конкретную ветку.

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts
node -v
npm -v

02Поставьте Node.js из NodeSource для службы

Если приложение будет работать как служба systemd или под pm2 от root, nvm не подходит: root и systemd не видят Node.js из домашнего каталога. В репозитории Ubuntu 24.04 лежит Node.js 18, а Node.js 24 ставят из NodeSource. В пакете NodeSource уже есть npm и npx.

bash
curl -fsSL https://deb.nodesource.com/setup_24.x -o nodesource_setup.sh
sudo bash nodesource_setup.sh
sudo apt install -y nodejs
node -v
npm -v

03Подготовьте каталог приложения и зависимости

Каталог сайта /var/www/example.com должен принадлежать пользователю, который деплоит, например deploy. Зависимости ставят от владельца сайта, без sudo: npm ci строго по package-lock.json, затем npm run build. На VPS с 1 ГБ памяти сборка может упасть с JavaScript heap out of memory, тогда добавьте swap или задайте NODE_OPTIONS=--max-old-space-size=1024.

bash
sudo mkdir -p /var/www/example.com
sudo chown -R deploy:deploy /var/www/example.com
cd /var/www/example.com
npm ci
npm run build

04Запустите приложение на 127.0.0.1:3000

Приложение должно слушать порт выше 1024 на 127.0.0.1, например 3000: порты ниже 1024 обычный пользователь открыть не может. Запустите его под pm2, чтобы процесс пережил выход из сессии. Если порт уже занят, Node.js упадёт с Error: listen EADDRINUSE: address already in use 127.0.0.1:3000, а sudo ss -ltnp покажет, кто держит порт.

bash
sudo npm install -g pm2
cd /var/www/example.com
pm2 start server.js --name app
pm2 logs app
sudo ss -ltnp

05Настройте автозапуск pm2 после перезагрузки

После перезагрузки сервера pm2 сам не поднимается. Команда pm2 startup systemd печатает строку с sudo, её выполняют один раз, а pm2 save записывает список процессов в ~/.pm2/dump.pm2. Без этих двух шагов приложение останется лежать после ребута.

bash
pm2 startup systemd
pm2 save

06Опишите службу systemd без pm2

Если pm2 не нужен, приложение держит служба systemd. В ExecStart пишут полный путь к node: which node покажет его, а для Node.js из nvm путь будет в домашнем каталоге. После правки unit-файла выполните sudo systemctl daemon-reload.

ini
[Unit]
Description=Node.js app
After=network.target

[Service]
User=deploy
WorkingDirectory=/var/www/example.com
ExecStart=/usr/bin/node /var/www/example.com/server.js
Restart=always
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

07Настройте nginx как обратный прокси

Наружу приложение отдаёт nginx через proxy_pass http://127.0.0.1:3000;. В location ставят proxy_set_header Host $host;, иначе приложение видит в заголовке Host адрес из proxy_pass. Для WebSocket добавьте proxy_http_version 1.1;, proxy_set_header Upgrade $http_upgrade; и proxy_set_header Connection "upgrade";.

nginx
server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

08Включите сайт и проверьте конфиг nginx

Сайты лежат в /etc/nginx/sites-available/ и включаются симлинком в /etc/nginx/sites-enabled/. Команда sudo nginx -t проверяет все файлы конфига, а sudo systemctl reload nginx применяет его без обрыва соединений. Если в конфиге ошибка, nginx продолжит работать со старым.

bash
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/example.com
sudo nginx -t
sudo systemctl reload nginx

Частые ошибки

  • Node.js поставлен через nvm, а служба systemd падает со status=203/EXEC: systemd не находит программу из ExecStart.

    Укажите в ExecStart полный путь к node, который показывает which node. Либо поставьте Node.js из NodeSource, чтобы бинарник лежал в /usr/bin/node.

  • Вторая копия приложения не стартует с Error: listen EADDRINUSE: address already in use 127.0.0.1:3000.

    Найдите процесс через sudo ss -ltnp. Копию под pm2 остановите pm2 delete app, лишнюю службу через sudo systemctl stop <имя>.

  • nginx отдаёт 502, в /var/log/nginx/error.log строка connect() failed (111: Connection refused) while connecting to upstream.

    Проверьте, что приложение запущено и слушает тот же адрес и порт, что в proxy_pass: sudo ss -ltnp и curl -I http://127.0.0.1:3000/.

  • Сборка падает с JavaScript heap out of memory на VPS с 1 ГБ памяти.

    Добавьте swap-файл или запустите сборку с NODE_OPTIONS=--max-old-space-size=1024.

Deploykin

Как это делается в Deploykin

В Deploykin приложение на Node.js создаётся как сайт типа «Приложение»: nginx проксирует запросы на его порт, SSL выпускается в один клик. Процесс запускает демон: укажите команду и пользователя, конфигурацию Supervisor панель соберёт сама и будет держать процесс запущенным.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Какая версия Node.js сейчас LTS?

Актуальная LTS-ветка это Node.js 22, предыдущая LTS это Node.js 20. Команда nvm install --lts ставит последнюю LTS, а nvm install 20 фиксирует ветку 20.

Как проверить версию Node.js и npm?

Выполните node -v и npm -v. Если nvm установлен, nvm ls покажет все версии и отметит текущую.

Почему приложение не видно после перезагрузки сервера?

pm2 сам не поднимается. Выполните один раз команду с sudo, которую печатает pm2 startup systemd, затем pm2 save, чтобы список процессов сохранился в ~/.pm2/dump.pm2.

Можно ли запустить Node.js на порту 80?

Обычный пользователь не может открыть порты ниже 1024. Приложение слушает 3000 на 127.0.0.1, а порт 80 занимает nginx и передаёт запросы через proxy_pass.

Ещё по теме

Node.js на сервере: установка, запуск и настройка: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.