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

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

Node.js скрипты на сервере запускают так: проверяют версию, ставят зависимости, настраивают автозапуск и отдают порт наружу через nginx. В руководстве команды для Ubuntu 24.04 и проверка, что приложение отвечает.

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

01Проверьте, что Node.js и npm установлены

Подключитесь к серверу по SSH и проверьте версии. В Ubuntu 24.04 из коробки доступен Node.js 18, но для многих скриптов нужна версия 24. Если команда node -v не найдена, установите Node.js по инструкции для вашей версии.

bash
node -v
npm -v

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

Если версия ниже 24 или npm отсутствует, добавьте репозиторий NodeSource. Скрипт setup_24.x настраивает источник пакетов, после чего apt install nodejs ставит Node.js 24 вместе с npm и npx. Для других версий используйте соответствующий скрипт, например setup_22.x.

bash
curl -fsSL https://deb.nodesource.com/setup_24.x -o nodesource_setup.sh
sudo bash nodesource_setup.sh
sudo apt install -y nodejs

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 держит процесс запущенным и перезапускает его при падении. Установите pm2 глобально и запустите файл, например server.js. Имя app пригодится для управления процессом.

bash
sudo npm install -g pm2
pm2 start server.js --name app

05Настройте автозапуск pm2 после перезагрузки

После перезагрузки сервера pm2 сам не поднимается. Команда pm2 startup systemd выведет строку с sudo, её нужно выполнить один раз. Затем pm2 save запишет список процессов в ~/.pm2/dump.pm2.

bash
pm2 startup systemd
# выполните команду с sudo, которую выведет предыдущая команда
pm2 save

06Настройте nginx как обратный прокси

Приложение слушает 127.0.0.1:3000, наружу его отдаёт nginx. Создайте файл /etc/nginx/sites-available/example.com с настройками проксирования. В location обязателен proxy_set_header Host $host;, иначе приложение увидит адрес из proxy_pass. Для WebSocket добавьте три строки с 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 X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

07Включите сайт и проверьте конфигурацию nginx

Создайте симлинк в sites-enabled и проверьте конфиг командой sudo nginx -t. Если ошибок нет, перезагрузите nginx без обрыва соединений. При ошибке nginx продолжит работать со старым конфигом.

bash
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

08Проверьте, что скрипт отвечает

Сначала проверьте приложение напрямую на localhost. Затем откройте сайт в браузере или выполните curl -I http://example.com/. В ответе должен быть код 200 или другой успешный статус. Если приходит 502, смотрите логи nginx и pm2.

bash
curl -I http://127.0.0.1:3000/
curl -I http://example.com/
pm2 logs app

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

  • Порт 3000 уже занят, приложение падает с Error: listen EADDRINUSE: address already in use 127.0.0.1:3000.

    Найдите процесс командой sudo ss -ltnp. Остановите лишнюю копию через pm2 delete app или службу через sudo systemctl stop <имя>.

  • nginx отдаёт 502 Bad Gateway, в error.log connect() failed (111: Connection refused) while connecting to upstream.

    Приложение не запущено или слушает другой порт. Проверьте sudo ss -ltnp и curl -I http://127.0.0.1:3000/, затем поправьте proxy_pass или запустите процесс.

  • Служба systemd завершается с status=203/EXEC, если Node.js установлен через nvm.

    В ExecStart укажите полный путь к node, который показывает which node. Для nvm это путь в домашнем каталоге пользователя.

  • Сборка падает с JavaScript heap out of memory на сервере с 1 ГБ памяти.

    Добавьте swap-файл или запустите сборку с NODE_OPTIONS=--max-old-space-size=1024.

Deploykin

Как это делается в Deploykin

В Deploykin приложение на Node.js создаётся как сайт типа «Приложение»: nginx проксирует запросы на его порт, SSL выпускается в один клик. Процесс запускает демон: укажите команду и пользователя, конфигурацию Supervisor панель соберёт сама и будет держать процесс запущенным.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем отличается запуск через pm2 от systemd?

pm2 удобен для нескольких процессов и перезапуска при падении, но требует pm2 startup и pm2 save для автозапуска. systemd встроен в Ubuntu и запускает один процесс, для него нужен unit-файл.

Почему приложение не видно снаружи, хотя pm2 показывает статус online?

Скорее всего, приложение слушает только 127.0.0.1, а nginx не настроен или не перезагружен. Проверьте curl -I http://127.0.0.1:3000/ на сервере и конфиг nginx.

Нужно ли ставить npm отдельно?

В пакете Node.js из NodeSource npm и npx уже есть. В репозитории Ubuntu 24.04 npm ставится отдельным пакетом npm.

Как обновить зависимости после изменения package.json?

Выполните npm ci от владельца файлов, без sudo. Команда удалит node_modules и поставит пакеты строго по package-lock.json.

Ещё по теме

Node.js на сервере: установка, запуск и настройка: все материалы темы

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