Как обновить Node.js на сервере Ubuntu 24.04
В репозитории Ubuntu 24.04 лежит Node.js 18.19.1, а npm ставится отдельным пакетом. Чтобы получить Node.js 24 с npm и npx в одном пакете, подключают репозиторий NodeSource и ставят nodejs через apt. Дальше приложение собирают, запускают под pm2 или systemd и отдают наружу через nginx.
01Проверьте текущую версию Node.js
Посмотрите, что установлено сейчас. Команда node -v печатает версию Node.js, npm -v версию npm. Если Node.js не установлен, обе команды вернут command not found.
node -v
npm -v
02Подключите репозиторий NodeSource
Скрипт NodeSource добавляет в apt репозиторий с Node.js 24. Скачайте его в файл nodesource_setup.sh и выполните от root. После этого apt видит пакет nodejs версии 24.
curl -fsSL https://deb.nodesource.com/setup_24.x -o nodesource_setup.sh
sudo bash nodesource_setup.sh
03Установите Node.js 24
Пакет nodejs из NodeSource уже содержит npm и npx, отдельный пакет npm не нужен. Если раньше стоял nodejs из репозитория Ubuntu, apt заменит его. Проверьте версии после установки.
sudo apt install -y nodejs
node -v
npm -v
04Установите зависимости и соберите проект
Зависимости и сборку запускайте от владельца сайта, без sudo, иначе файлы в /var/www/example.com окажутся с правами root. npm ci ставит пакеты строго по package-lock.json, npm run build собирает проект. На VPS с 1 ГБ памяти сборка может упасть с JavaScript heap out of memory: добавьте swap или ограничьте кучу через NODE_OPTIONS.
cd /var/www/example.com
npm ci
npm run build
05Запустите приложение под pm2
pm2 держит процесс живым и перезапускает его после падения. Ставьте его глобально, затем запустите приложение с именем app. Логи смотрите командой pm2 logs app, они пишутся в ~/.pm2/logs/app-out.log и ~/.pm2/logs/app-error.log.
sudo npm install -g pm2
cd /var/www/example.com
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
Приложение слушает 127.0.0.1:3000, наружу порт отдаёт nginx. В location с proxy_pass обязателен proxy_set_header Host $host;, иначе приложение видит в заголовке Host адрес из proxy_pass. Для 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";
}
}
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
Частые ошибки
-
Приложение падает с
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/на самом сервере. -
Служба приложения падает со
status=203/EXECвsystemctl status.systemd не нашёл программу из
ExecStart: чаще всего Node.js поставлен через nvm и лежит в домашнем каталоге. Путь показываетwhich node, его и пишут вExecStart. -
Сборка падает с
JavaScript heap out of memory.Node.js упёрся в лимит памяти кучи. Добавьте 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.
Чем отличается установка из NodeSource от установки через nvm?
Пакет из NodeSource ставит node в системный каталог, и его видят root, cron и systemd. Node.js из nvm лежит в домашнем каталоге пользователя, поэтому в unit-файле нужен полный путь к node.
Нужно ли перезапускать приложение после обновления Node.js?
Да, работающий процесс продолжает использовать старую версию. Перезапустите его командой pm2 restart app или через sudo systemctl restart <имя>.
Почему после перезагрузки сервера приложение не поднялось?
pm2 сам не стартует. Один раз выполните команду с sudo, которую печатает pm2 startup systemd, и сохраните список процессов через pm2 save.
Ещё по теме
- Руководство · 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: проверка версии, установка зависимостей, настройка 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 на сервере: установка, запуск и настройка: все материалы темы