Как установить Node.js на сервер Ubuntu 24.04
Node.js ставят из репозитория NodeSource, потому что в Ubuntu 24.04 лежит только версия 18.19.1. Дальше приложение запускают на 127.0.0.1:3000, наружу отдают через nginx и проверяют ответ командами curl и ss.
01Обновите пакеты и проверьте версию Node.js
Подключитесь к серверу по SSH и обновите список пакетов. Проверьте, не установлен ли Node.js раньше: команда node -v покажет версию или сообщит, что команда не найдена. В Ubuntu 24.04 из коробки доступен только пакет nodejs 18.19.1, а npm ставится отдельным пакетом npm.
sudo apt update
node -v
npm -v
02Подключите репозиторий NodeSource и установите Node.js 24
Скрипт NodeSource добавляет репозиторий с Node.js 24. Скачайте его в файл nodesource_setup.sh, запустите через sudo bash и поставьте пакет nodejs. В этом пакете уже есть 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Создайте каталог сайта и передайте его пользователю deploy
Приложение разместите в /var/www/example.com. Каталог создайте от root и сразу передайте пользователю, который будет деплоить, например deploy. Команды npm ci и npm run build выполняйте в сессии этого пользователя: из-под root они оставят файлы с владельцем root и сломают следующие деплои.
sudo mkdir -p /var/www/example.com
sudo chown -R deploy:deploy /var/www/example.com
su - deploy
cd /var/www/example.com
04Установите зависимости и соберите проект
В каталоге сайта от пользователя deploy выполните npm ci: команда ставит пакеты строго по package-lock.json. Если в проекте есть шаг сборки, запустите npm run build. На VPS с 1 ГБ памяти сборка может упасть с JavaScript heap out of memory: добавьте swap-файл или поднимите лимит кучи через NODE_OPTIONS=--max-old-space-size=1024.
npm ci
npm run build
05Запустите приложение на 127.0.0.1:3000
Приложение должно слушать порт выше 1024 на 127.0.0.1, например 3000: порты ниже 1024 обычный пользователь открыть не может. Запустите его через pm2, чтобы процесс пережил выход из SSH. Команда pm2 start server.js --name app создаст процесс с именем app, логи пишутся в ~/.pm2/logs/app-out.log и ~/.pm2/logs/app-error.log.
sudo npm install -g pm2
pm2 start server.js --name app
pm2 logs app
06Настройте автозапуск pm2 после перезагрузки
После перезагрузки сервера pm2 сам не поднимается. Команда pm2 startup systemd печатает строку с sudo, её нужно выполнить один раз. Затем pm2 save записывает список процессов в ~/.pm2/dump.pm2, и после старта системы pm2 поднимет приложение.
pm2 startup systemd
pm2 save
07Создайте конфиг nginx для приложения
Сайты nginx лежат в /etc/nginx/sites-available/ и включаются симлинком в /etc/nginx/sites-enabled/. В location / укажите proxy_pass http://127.0.0.1:3000; и proxy_set_header Host $host;, иначе приложение увидит в заголовке Host адрес из proxy_pass. Для WebSocket добавьте map с $connection_upgrade: заголовок Connection: upgrade ставится только при Upgrade, а не для всех запросов.
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
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 Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}
}
08Включите сайт и перезагрузите nginx
Положите конфиг в /etc/nginx/sites-available/example.com и создайте симлинк в sites-enabled. Перед перезагрузкой проверьте конфиг командой sudo nginx -t: она проверяет все файлы. Затем примените настройки через sudo systemctl reload nginx, этот способ не обрывает соединения.
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/example.com
sudo nginx -t
sudo systemctl reload nginx
Частые ошибки
-
Порт 3000 уже занят, приложение падает с
Error: listen EADDRINUSE: address already in use 127.0.0.1:3000.Найдите процесс командой
sudo ss -ltnp. Лишнюю копию под pm2 остановите черезpm2 delete app, лишнюю службу черезsudo systemctl stop <имя>. -
Служба приложения не стартует, в
systemctl statusвидноstatus=203/EXEC.systemd не нашёл программу из
ExecStart. Если Node.js поставлен через nvm, он лежит в домашнем каталоге: узнайте путь командойwhich nodeи укажите полный путь вExecStart. -
npm ciиnpm run buildпадают с EACCES, потому что выполняются не от владельца файлов.Переключитесь на пользователя
deployкомандойsu - deployи запускайте команды из каталога сайта. Не выполняйте установку зависимостей через sudo. -
Сборка падает с
JavaScript heap out of memoryна VPS с небольшим объёмом памяти.Добавьте swap-файл или запустите сборку с
NODE_OPTIONS=--max-old-space-size=1024.
Deploykin
Как это делается в Deploykin
В Deploykin приложение на Node.js создаётся как сайт типа «Приложение»: nginx проксирует запросы на его порт, SSL выпускается в один клик. Процесс запускает демон: укажите команду и пользователя, конфигурацию Supervisor панель соберёт сама и будет держать процесс запущенным.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Какая версия Node.js есть в Ubuntu 24.04 без сторонних репозиториев?
В репозитории Ubuntu 24.04 лежит пакет nodejs 18.19.1, а npm ставится отдельным пакетом npm. Для Node.js 24 подключают репозиторий NodeSource.
Зачем ставить Node.js из NodeSource?
Скрипт NodeSource добавляет репозиторий с Node.js 24, и в пакете сразу есть npm и npx. Версия из Ubuntu 24.04 устарела для новых проектов.
Почему nginx отдаёт 502 Bad Gateway?
Приложение не запущено или слушает другой порт или адрес, чем в proxy_pass. Проверьте sudo ss -ltnp и ответ curl -I http://127.0.0.1:3000/ на самом сервере.
Почему приложение не поднимается после перезагрузки сервера?
pm2 не стартует сам. Выполните pm2 startup systemd, один раз запустите напечатанную команду с sudo и сохраните список процессов через pm2 save.
Ещё по теме
- Руководство · 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 через nvm и запустить приложение на Ubuntu 24.04 Пошаговая установка Node.js на Ubuntu 24.04: nvm, NodeSource, LTS-версии 20 и 22, запуск приложения, nginx и проверка работы.
- Руководство · Node.js Как установить Node.js 24 LTS и запустить приложение на Ubuntu 24.04 Пошаговая настройка Node.js 24 LTS на Ubuntu 24.04: установка из NodeSource, запуск приложения через pm2 или systemd, nginx и проверка работы.
Node.js на сервере: установка, запуск и настройка: все материалы темы