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

Node index js: запуск приложения на сервере Ubuntu 24.04

Файл index.js (или server.js) запускают на сервере через node, а для постоянной работы держат под pm2 или systemd. Наружу приложение отдаёт nginx через proxy_pass на 127.0.0.1:3000. Проверка занимает одну команду curl -I http://127.0.0.1:3000/.

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

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

На сервере уже должен быть Node.js. Версию показывают две команды: node -v и npm -v. Если вторая отвечает command not found, поставьте npm отдельным пакетом sudo apt install -y npm или перейдите на NodeSource, где npm и npx идут вместе с node.

bash
node -v
npm -v

02Установите зависимости и соберите проект

Зависимости ставят от владельца сайта, без sudo. 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

03Запустите приложение и проверьте порт

Приложение должно слушать порт выше 1024 на 127.0.0.1, например 3000. Запустите его и убедитесь, что порт открыт: sudo ss -ltnp покажет процесс. Если порт занят, Node.js падает с Error: listen EADDRINUSE: address already in use 127.0.0.1:3000. Кто держит порт, видно в выводе ss.

bash
node index.js
sudo ss -ltnp

04Настройте nginx с proxy_pass

Создайте файл сайта в /etc/nginx/sites-available/example.com и включите его симлинком в /etc/nginx/sites-enabled/. В location с proxy_pass обязателен proxy_set_header Host $host;, иначе приложение видит в заголовке Host адрес из proxy_pass. Для WebSocket добавьте proxy_http_version 1.1;, proxy_set_header Upgrade $http_upgrade; и proxy_set_header Connection "upgrade";.

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

05Проверьте конфиг и перезагрузите nginx

sudo nginx -t проверяет все файлы конфига. Если ошибок нет, sudo systemctl reload nginx применяет конфиг без обрыва соединений. При ошибке nginx продолжает работать со старым конфигом, а причина видна в выводе nginx -t.

bash
sudo nginx -t
sudo systemctl reload nginx

06Держите приложение под pm2

sudo npm install -g pm2 ставит pm2 в /usr/bin/pm2. Запуск: pm2 start index.js --name app. Логи лежат в ~/.pm2/logs/app-out.log и ~/.pm2/logs/app-error.log, их показывает pm2 logs app. После перезагрузки сервера pm2 сам не поднимается: выполните pm2 startup systemd, затем команду с sudo, которую он напечатает, и pm2 save.

bash
sudo npm install -g pm2
pm2 start index.js --name app
pm2 logs app
pm2 startup systemd
pm2 save

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

С самого сервера приложение отвечает на curl -I http://127.0.0.1:3000/. Снаружи откройте http://example.com в браузере. Если nginx отдаёт 502, в /var/log/nginx/error.log будет connect() failed (111: Connection refused) while connecting to upstream: приложение не запущено или слушает другой порт. Проверьте sudo ss -ltnp и повторите curl.

bash
curl -I http://127.0.0.1:3000/
tail -n 20 /var/log/nginx/error.log

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

  • Приложение слушает localhost или порт 80, и nginx не может до него достучаться. В error.log появляется connect() failed (111: Connection refused) while connecting to upstream.

    Слушайте 127.0.0.1 и порт выше 1024, например 3000, а в proxy_pass укажите тот же адрес и порт. Порты ниже 1024 обычный пользователь открыть не может.

  • Node.js поставлен через nvm, и служба systemd падает со status=203/EXEC: systemd не находит node в домашнем каталоге пользователя.

    Укажите полный путь в ExecStart, его показывает which node. Например, ExecStart=/home/deploy/.nvm/versions/node/v24.0.0/bin/node /var/www/example.com/index.js.

  • После перезагрузки сервера приложение не отвечает: pm2 не поднялся сам.

    Один раз выполните pm2 startup systemd и команду с sudo, которую он напечатает, затем pm2 save. Список процессов сохранится в ~/.pm2/dump.pm2.

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

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

Deploykin

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

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

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

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

Чем отличается запуск node index.js от pm2 start index.js?

node index.js держит процесс только пока открыт терминал. pm2 запускает приложение в фоне, перезапускает его после падения и хранит логи в ~/.pm2/logs/.

Почему nginx отдаёт 502 при работающем приложении?

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

Как отдать WebSocket через nginx?

В location с proxy_pass добавьте proxy_http_version 1.1;, proxy_set_header Upgrade $http_upgrade; и proxy_set_header Connection "upgrade";. Без них рукопожатие Upgrade не пройдёт.

Можно ли запустить приложение на порту 80?

Обычный пользователь не может открыть порты ниже 1024. Приложение слушает 3000 на 127.0.0.1, а порт 80 занимает nginx и передаёт запросы через proxy_pass.

Ещё по теме

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

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