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

Как обновить 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.

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

01Проверьте текущую версию Node.js

Посмотрите, что установлено сейчас. Команда node -v печатает версию Node.js, npm -v версию npm. Если Node.js не установлен, обе команды вернут command not found.

bash
node -v
npm -v

02Подключите репозиторий NodeSource

Скрипт NodeSource добавляет в apt репозиторий с Node.js 24. Скачайте его в файл nodesource_setup.sh и выполните от root. После этого apt видит пакет nodejs версии 24.

bash
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 заменит его. Проверьте версии после установки.

bash
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.

bash
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.

bash
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 восстанавливает его.

bash
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.

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 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

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

  • Приложение падает с 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 на сервере: установка, запуск и настройка: все материалы темы

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