Как установить Node.js через nvm и запустить приложение на Ubuntu 24.04
Node.js на Ubuntu 24.04 ставят через nvm, если нужны разные версии для разных проектов, или из репозитория NodeSource, если нужна одна версия для службы.
01Установите nvm и Node.js
nvm ставится в домашний каталог пользователя и позволяет переключать версии Node.js. После установки загрузите nvm в текущую оболочку и поставьте нужную LTS-версию: 22 или 20. Команда nvm install --lts ставит последнюю LTS, а nvm install 20 фиксирует конкретную ветку.
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.
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.
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 покажет, кто держит порт.
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. Без этих двух шагов приложение останется лежать после ребута.
pm2 startup systemd
pm2 save
06Опишите службу systemd без pm2
Если pm2 не нужен, приложение держит служба systemd. В ExecStart пишут полный путь к node: which node покажет его, а для Node.js из nvm путь будет в домашнем каталоге. После правки unit-файла выполните sudo systemctl daemon-reload.
[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";.
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 продолжит работать со старым.
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 Как установить Node.js на сервер Ubuntu 24.04 Как установить Node.js 24 из NodeSource на Ubuntu 24.04, запустить приложение, отдать его через nginx и проверить работу командами.
- Руководство · Node.js Node index js: запуск приложения на сервере Ubuntu 24.04 Запустите Node.js-приложение на сервере Ubuntu 24.04: проверка версии, зависимости, pm2 или systemd, nginx с proxy_pass и WebSocket, проверка через curl.
- Руководство · Node.js Node.js Express на сервере Ubuntu 24.04: настройка и запуск Разворачиваем Express-приложение на Ubuntu 24.04: проверка Node.js, зависимости, nginx как reverse proxy, pm2 и systemd, проверка через curl и логи.
- Руководство · Node.js Как обновить Node.js на сервере Ubuntu 24.04 Пошаговое обновление Node.js на Ubuntu 24.04: установка из NodeSource, npm ci и сборка, запуск через pm2 или systemd, проксирование nginx и проверка работы.
- Руководство · Node.js Запуск Node.js скриптов на сервере Ubuntu 24.04 Запуск Node.js скриптов на сервере Ubuntu 24.04: проверка версии, установка зависимостей, настройка nginx и pm2, команды и проверка работы.
- Руководство · Node.js Как установить Node.js 24 LTS и запустить приложение на Ubuntu 24.04 Пошаговая настройка Node.js 24 LTS на Ubuntu 24.04: установка из NodeSource, запуск приложения через pm2 или systemd, nginx и проверка работы.
Node.js на сервере: установка, запуск и настройка: все материалы темы