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

Как установить Node.js 24 LTS и запустить приложение на Ubuntu 24.04

Node.js 24 LTS ставится на Ubuntu 24.04 из репозитория NodeSource: в репозитории Ubuntu только версия 18.19.1. После установки приложение запускают через pm2 или systemd, а наружу отдают через nginx на порту 3000.

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

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

Подключитесь к серверу по SSH и посмотрите, что уже установлено. В Ubuntu 24.04 из коробки доступен пакет nodejs версии 18.19.1, а npm ставится отдельным пакетом npm. Команда node -v покажет версию, если Node.js уже есть.

bash
node -v
npm -v

02Установите Node.js 24 LTS из NodeSource

Скачайте скрипт подключения репозитория NodeSource для ветки 24.x и выполните его от root. Затем установите пакет nodejs: в нём уже есть npm и npx. После установки проверьте версии.

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

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

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

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

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";
    }
}

07Включите сайт и перезагрузите nginx

Создайте симлинк в /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/
sudo nginx -t
sudo systemctl reload nginx

08Проверьте работу приложения

Убедитесь, что приложение слушает порт 3000: sudo ss -ltnp покажет процесс. Запрос curl -I http://127.0.0.1:3000/ на самом сервере должен вернуть ответ приложения. Затем откройте http://example.com в браузере: nginx передаст запрос на бэкенд.

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

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