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

Node.js Express на сервере Ubuntu 24.04: настройка и запуск

Express-приложение на сервере слушает 127.0.0.1:3000, а наружу его отдаёт nginx через proxy_pass. Настройка занимает несколько команд: проверка Node.js, установка зависимостей, конфиг nginx, автозапуск через pm2 или systemd. В конце приложение отвечает на запросы по домену, а не только на localhost.

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

01Проверьте Node.js и npm на сервере

Express работает поверх Node.js, поэтому начните с проверки версий. В Ubuntu 24.04 из коробки доступен Node.js 18.19.1, npm ставится отдельным пакетом. Если команды не найдены или версия ниже 18, установите Node.js 24 из NodeSource: там npm и npx уже входят в пакет. Подробности установки разобраны на отдельной странице про установку Node.js на Ubuntu 24.04.

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Запустите приложение и проверьте порт

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

bash
node server.js
curl -I http://127.0.0.1:3000/
sudo ss -ltnp

04Настройте nginx как reverse proxy

nginx принимает запросы на 80-м порту и передаёт их приложению через proxy_pass http://127.0.0.1:3000;. В 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";. Файл сайта положите в /etc/nginx/sites-available/ и включите симлинком в /etc/nginx/sites-enabled/.

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

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

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

bash
sudo nginx -t
sudo systemctl reload nginx

06Поставьте автозапуск через pm2

pm2 держит приложение запущенным и перезапускает его после падения. С Node.js из NodeSource команда sudo npm install -g pm2 ставит pm2 в /usr/bin/pm2. Запуск: pm2 start server.js --name app, логи: pm2 logs app, перезапуск: pm2 restart app. После перезагрузки сервера pm2 сам не поднимается: pm2 startup systemd печатает команду с sudo, её выполняют один раз, а pm2 save записывает список процессов в ~/.pm2/dump.pm2.

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

07Или опишите службу systemd

Без pm2 приложение держит служба systemd. В ExecStart пишут полный путь к node: если Node.js поставлен через nvm, он лежит в домашнем каталоге и служба его не найдёт. Переменные задают в Environment= или EnvironmentFile=. После правки unit-файла нужен sudo systemctl daemon-reload.

ini
[Unit]
Description=Express app
After=network.target

[Service]
User=deploy
WorkingDirectory=/var/www/example.com
ExecStart=/usr/bin/node /var/www/example.com/server.js
Restart=always
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

08Проверьте работу через домен и логи

Откройте сайт по домену и убедитесь, что отвечает Express, а не заглушка nginx. Ответ приложения на самом сервере проверяет curl -I http://127.0.0.1:3000/. Логи nginx лежат в /var/log/nginx/access.log и /var/log/nginx/error.log, если в конфиге сайта не заданы свои access_log и error_log. Ошибка 502 Bad Gateway с connect() failed (111: Connection refused) while connecting to upstream означает, что приложение не запущено или слушает другой порт или адрес, чем в proxy_pass.

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

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

  • Приложение слушает 0.0.0.0:3000 или порт 80, и запуск падает с EACCES либо порт открыт наружу без nginx.

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

  • В systemctl status служба приложения падает со status=203/EXEC.

    systemd не нашёл программу из ExecStart. Путь к node показывает which node, этот полный путь и пишут в ExecStart. Node.js из nvm лежит в домашнем каталоге и службам не виден.

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

    Выполните pm2 startup systemd, затем команду с sudo, которую он напечатает, и pm2 save. Без 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 дней бесплатно на тарифе Про, без привязки карты.

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

Нужен ли nginx для Express-приложения?

nginx принимает запросы на 80-м порту и передаёт их приложению через proxy_pass. Без него приложение пришлось бы слушать порт 80, а обычный пользователь открыть его не может.

Почему nginx отдаёт 502 Bad Gateway?

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

Чем pm2 отличается от службы systemd?

Обе держат приложение запущенным и перезапускают его. pm2 удобен логами и списком процессов, systemd не требует глобальной установки пакета и работает с правами пользователя из User=.

Как передать приложению переменные окружения?

В pm2 их задают при запуске или в файле экосистемы, в systemd через Environment= или EnvironmentFile= в unit-файле. После правки unit-файла нужен sudo systemctl daemon-reload.

Ещё по теме

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

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