Как установить Node.js 24 LTS и запустить приложение на Ubuntu 24.04
Node.js 24 LTS ставится на Ubuntu 24.04 из репозитория NodeSource: в репозитории Ubuntu только версия 18.19.1. После установки приложение запускают через pm2 или systemd, а наружу отдают через nginx на порту 3000.
01Проверьте текущую версию Node.js
Подключитесь к серверу по SSH и посмотрите, что уже установлено. В Ubuntu 24.04 из коробки доступен пакет nodejs версии 18.19.1, а npm ставится отдельным пакетом npm. Команда node -v покажет версию, если Node.js уже есть.
node -v
npm -v
02Установите Node.js 24 LTS из NodeSource
Скачайте скрипт подключения репозитория NodeSource для ветки 24.x и выполните его от root. Затем установите пакет 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Подготовьте каталог приложения и установите зависимости
Скопируйте код в /var/www/example.com и перейдите в каталог. Зависимости ставьте от владельца сайта, без sudo: npm ci ставит пакеты строго по package-lock.json. Сборка выполняется командой npm run build.
cd /var/www/example.com
npm ci
npm run build
04Запустите приложение через pm2
Установите pm2 глобально: с Node.js из NodeSource он окажется в /usr/bin/pm2. Запустите приложение командой pm2 start server.js --name app. Логи смотрите через pm2 logs 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
05Включите автозапуск pm2 после перезагрузки
После перезагрузки сервера pm2 сам не поднимается. Команда pm2 startup systemd напечатает строку с sudo, её нужно выполнить один раз. Затем pm2 save запишет список процессов в ~/.pm2/dump.pm2.
pm2 startup systemd
pm2 save
06Настройте nginx как обратный прокси
Приложение слушает 127.0.0.1:3000, наружу его отдаёт nginx. Создайте файл /etc/nginx/sites-available/example.com с proxy_pass http://127.0.0.1:3000; и заголовком Host. Для WebSocket добавьте proxy_http_version 1.1 и заголовки Upgrade и Connection.
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 "upgrade";
}
}
07Включите сайт и перезагрузите nginx
Создайте симлинк в /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/
sudo nginx -t
sudo systemctl reload nginx
08Проверьте работу приложения
Убедитесь, что приложение слушает порт 3000: sudo ss -ltnp покажет процесс. Запрос curl -I http://127.0.0.1:3000/ на самом сервере должен вернуть ответ приложения. Затем откройте http://example.com в браузере: nginx передаст запрос на бэкенд.
sudo ss -ltnp
curl -I http://127.0.0.1:3000/
Частые ошибки
-
Приложение падает с
Error: listen EADDRINUSE: address already in use 127.0.0.1:3000: порт занят второй копией или другим процессом.Найдите процесс через
sudo ss -ltnp. Копию под pm2 остановите командойpm2 delete app, лишнюю службу черезsudo systemctl stop <имя>. -
nginx отдаёт
502 Bad Gateway, в/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/на сервере. -
Служба systemd падает со
status=203/EXEC: systemd не находит программу изExecStart.Чаще всего Node.js поставлен через nvm и лежит в домашнем каталоге. Узнайте путь командой
which nodeи укажите полный путь вExecStart, затем выполнитеsudo systemctl daemon-reload. -
Сборка падает с
JavaScript heap out of memoryна VPS с 1 ГБ памяти без swap.Добавьте swap-файл или запустите сборку с
NODE_OPTIONS=--max-old-space-size=1024.
Deploykin
Как это делается в Deploykin
В Deploykin приложение на Node.js создаётся как сайт типа «Приложение»: nginx проксирует запросы на его порт, SSL выпускается в один клик. Процесс запускает демон: укажите команду и пользователя, конфигурацию Supervisor панель соберёт сама и будет держать процесс запущенным.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем Node.js 24 LTS отличается от версии 18 в Ubuntu 24.04?
В репозитории Ubuntu 24.04 только Node.js 18.19.1, а npm ставится отдельным пакетом. Node.js 24 LTS ставится из NodeSource, и в его пакете уже есть npm и npx.
Как проверить версию Node.js после установки?
Выполните node -v и npm -v. Команды покажут версии установленных Node.js и npm.
Почему приложение не поднимается после перезагрузки сервера?
pm2 не запускается сам. Выполните pm2 startup systemd, затем команду с sudo, которую он напечатает, и pm2 save.
Можно ли запустить Node.js на порту 80 напрямую?
Порты ниже 1024 обычный пользователь открыть не может. Приложение слушает порт выше 1024 на 127.0.0.1, а наружу его отдаёт 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 через nvm и запустить приложение на Ubuntu 24.04 Пошаговая установка Node.js на Ubuntu 24.04: nvm, NodeSource, LTS-версии 20 и 22, запуск приложения, nginx и проверка работы.
Node.js на сервере: установка, запуск и настройка: все материалы темы