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

Как установить Node.js на сервер Ubuntu 24.04

Node.js ставят из репозитория NodeSource, потому что в Ubuntu 24.04 лежит только версия 18.19.1. Дальше приложение запускают на 127.0.0.1:3000, наружу отдают через nginx и проверяют ответ командами curl и ss.

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

01Обновите пакеты и проверьте версию Node.js

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

bash
sudo apt update
node -v
npm -v

02Подключите репозиторий NodeSource и установите Node.js 24

Скрипт NodeSource добавляет репозиторий с Node.js 24. Скачайте его в файл nodesource_setup.sh, запустите через sudo bash и поставьте пакет 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Создайте каталог сайта и передайте его пользователю deploy

Приложение разместите в /var/www/example.com. Каталог создайте от root и сразу передайте пользователю, который будет деплоить, например deploy. Команды npm ci и npm run build выполняйте в сессии этого пользователя: из-под root они оставят файлы с владельцем root и сломают следующие деплои.

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

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

bash
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 поднимет приложение.

bash
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, а не для всех запросов.

nginx
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, этот способ не обрывает соединения.

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

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