Запуск Node.js скриптов на сервере Ubuntu 24.04
Node.js скрипты на сервере запускают так: проверяют версию, ставят зависимости, настраивают автозапуск и отдают порт наружу через nginx. В руководстве команды для Ubuntu 24.04 и проверка, что приложение отвечает.
01Проверьте, что Node.js и npm установлены
Подключитесь к серверу по SSH и проверьте версии. В Ubuntu 24.04 из коробки доступен Node.js 18, но для многих скриптов нужна версия 24. Если команда node -v не найдена, установите Node.js по инструкции для вашей версии.
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.
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 собирает проект, если сборка предусмотрена.
cd /var/www/example.com
npm ci
npm run build
04Запустите скрипт через pm2
pm2 держит процесс запущенным и перезапускает его при падении. Установите pm2 глобально и запустите файл, например server.js. Имя app пригодится для управления процессом.
sudo npm install -g pm2
pm2 start server.js --name app
05Настройте автозапуск pm2 после перезагрузки
После перезагрузки сервера pm2 сам не поднимается. Команда pm2 startup systemd выведет строку с sudo, её нужно выполнить один раз. Затем pm2 save запишет список процессов в ~/.pm2/dump.pm2.
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.
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 продолжит работать со старым конфигом.
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.
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 Как установить Node.js на сервер Ubuntu 24.04 Как установить Node.js 24 из NodeSource на Ubuntu 24.04, запустить приложение, отдать его через nginx и проверить работу командами.
- Руководство · Node.js Node index js: запуск приложения на сервере Ubuntu 24.04 Запустите Node.js-приложение на сервере Ubuntu 24.04: проверка версии, зависимости, pm2 или systemd, nginx с proxy_pass и WebSocket, проверка через curl.
- Руководство · 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 через 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 на сервере: установка, запуск и настройка: все материалы темы