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/.
01Проверьте, что Node.js установлен
На сервере уже должен быть Node.js. Версию показывают две команды: node -v и npm -v. Если вторая отвечает command not found, поставьте npm отдельным пакетом sudo apt install -y npm или перейдите на NodeSource, где npm и npx идут вместе с node.
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.
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.
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";.
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.
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.
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.
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 Как установить Node.js на сервер Ubuntu 24.04 Как установить Node.js 24 из NodeSource на Ubuntu 24.04, запустить приложение, отдать его через nginx и проверить работу командами.
- Руководство · Node.js Node.js Express на сервере Ubuntu 24.04: настройка и запуск Разворачиваем Express-приложение на Ubuntu 24.04: проверка Node.js, зависимости, nginx как reverse proxy, pm2 и systemd, проверка через curl и логи.
- Руководство · Node.js Как обновить Node.js на сервере Ubuntu 24.04 Пошаговое обновление Node.js на Ubuntu 24.04: установка из NodeSource, npm ci и сборка, запуск через pm2 или systemd, проксирование nginx и проверка работы.
- Руководство · Node.js Запуск Node.js скриптов на сервере Ubuntu 24.04 Запуск Node.js скриптов на сервере Ubuntu 24.04: проверка версии, установка зависимостей, настройка nginx и pm2, команды и проверка работы.
- Руководство · Node.js Как установить Node.js через nvm и запустить приложение на Ubuntu 24.04 Пошаговая установка Node.js на Ubuntu 24.04: nvm, NodeSource, LTS-версии 20 и 22, запуск приложения, nginx и проверка работы.
- Руководство · Node.js Как установить Node.js 24 LTS и запустить приложение на Ubuntu 24.04 Пошаговая настройка Node.js 24 LTS на Ubuntu 24.04: установка из NodeSource, запуск приложения через pm2 или systemd, nginx и проверка работы.
Node.js на сервере: установка, запуск и настройка: все материалы темы