Развернуть приложение Node.js в Plesk
Опубликуйте приложение Node.js из Plesk: структура папок, файл запуска, зависимости npm, переменные среды, журналы и устранение распространенных ошибок.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
В этом руководстве описано, как опубликовать приложение Node.js на вашем домене из Plesk, установить его зависимости, настроить его и убедиться, что оно отвечает правильно.
Предварительные требования
- Доступ к панели Plesk (см. Подключение к интерфейсу Plesk).
- Домен, привязанный к вашему хостингу и направленный на него.
- Код вашего приложения с файлом
package.json. - Способ загрузки файлов: файловый менеджер Plesk, учетная запись FTP или репозиторий Git.
- Если приложение использует базу данных MySQL или MariaDB, база, созданная в Plesk.
В этом руководстве используется папка httpdocs, стандартная для основного домена. У дополнительного домена папка может быть другой: проверьте значение Корневая папка в разделе Хостинг и DNS > Хостинг.
Как это работает
В Plesk для Linux приложение запускается не командой npm start и не менеджером процессов вроде PM2. Файл, указанный в Plesk, запускает сервер приложений Phusion Passenger, он же передает этому файлу запросы, поступающие на веб-сервер.
На практике из этого следуют три вывода:
- Портом управлять не нужно. Passenger игнорирует номер, переданный в
listen(), и сам подключается к вашему HTTP-серверу. Вам не требуется открывать порт или добавлять его к адресу сайта. - Файл запуска должен вызывать
listen()напрямую или загружать файл, который это делает. - Процесс может остановиться при бездействии и запуститься снова при следующем запросе. Поэтому не поручайте повторяющиеся задачи внутреннему таймеру (
setInterval): используйте Планировщик задач Plesk.
Важно различать две папки:
| Настройка Plesk | Назначение | Пример |
|---|---|---|
| Корневая папка приложения (Application Root) | Папка со всем проектом: package.json, код, node_modules |
/httpdocs |
| Корневая папка (Document Root) | Вложенная папка с общедоступными файлами, которые веб-сервер отдает напрямую | /httpdocs/public |
Корневая папка обязательно должна находиться внутри папки приложения. Из интернета доступно только ее содержимое: файлы .env, код и node_modules остаются недоступными, если вы никогда не размещаете их в public.
Шаг 1: подготовьте приложение
В этом руководстве используется следующая структура:
httpdocs/
├── app.js
├── package.json
├── package-lock.json
└── public/
└── logo.pngЕсли вы хотите сначала проверить конфигурацию, используйте этот минимальный файл app.js, которому не нужны зависимости:
const http = require('node:http');
const server = http.createServer((req, res) => {
res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
res.end('Приложение Node.js работает\n');
});
server.listen(process.env.PORT || 3000);С Express принцип остается тем же:
const express = require('express');
const app = express();
app.get('/', (req, res) => {
res.send('Приложение Node.js работает');
});
app.listen(process.env.PORT || 3000);Благодаря process.env.PORT || 3000 этот же код будет работать и на вашем компьютере.
Проверьте также файл package.json: в нем перечислены зависимости, а скрипты, которые вы будете запускать из Plesk, должны находиться в разделе scripts.
{
"name": "my-application",
"version": "1.0.0",
"private": true,
"main": "app.js",
"scripts": {
"build": "echo \"Компиляция не требуется\""
},
"dependencies": {
"express": "^5.0.0"
}
}Шаг 2: загрузите файлы
Загрузите проект в httpdocs без папки node_modules: зависимости будут установлены на сервере на шаге 4.
Самый простой способ для первой загрузки:
- Создайте на компьютере архив
.zipс вашим проектом. - В Plesk откройте Файлы (файловый менеджер), затем папку
httpdocs. - Загрузите архив.
- Установите флажок рядом с ним, нажмите Извлечь файлы и удалите архив.
- Создайте папку
public, если ее нет: она нужна Plesk в качестве корневой папки, даже если останется пустой.
Шаг 3: настройте Node.js в Plesk
-
Перейдите в раздел Сайты и домены и найдите ваш домен.
-
Нажмите Node.js. Если для домена еще не настроен сайт, выберите Создать сайт > Node.js.
-
Заполните настройки:
Настройка Значение Версия Node.js Версия, которую требует приложение, или ближайшая к той, что использовалась при разработке Менеджер пакетов npmилиYarn, в зависимости от проекта. Обычно Plesk предлагает правильный вариантКорневая папка /httpdocs/publicРежим приложения production, когда сайт готов,developmentна время отладки. Это значение передается вNODE_ENVКорневая папка приложения /httpdocsФайл запуска приложения app.jsили файл, который фактически запускает ваш сервер -
Подтвердите, нажав ОК, если эта кнопка доступна.
Шаг 4: включите приложение и установите зависимости
На той же странице Node.js домена:
- Нажмите Включить Node.js.
- Нажмите Установка NPM (или Установка Yarn). Эта кнопка появляется, только если
package.jsonнаходится в папке приложения. - Если проект нужно скомпилировать (TypeScript, фронтенд и т. д.), нажмите Запустить скрипт, введите имя скрипта, например
build, и подтвердите. - Нажмите Перезапустить приложение, чтобы загрузить последнюю версию.
Шаг 5: задайте переменные среды
Ключи API, пароли и другие конфиденциальные настройки не должны находиться в коде.
- На странице Node.js найдите пункт Персональные переменные среды.
- Нажмите указать, затем Добавить переменную.
- Введите имя и значение, например
DATABASE_HOSTиlocalhost. - Подтвердите и нажмите Перезапустить приложение.
Node.js не загружает файл .env автоматически. Если ваше приложение его использует, оно должно читать его самостоятельно, например с помощью пакета dotenv.
Шаг 6: проверьте результат
Откройте https://ваш-домен.com/ в браузере. В примере из этого руководства на странице отобразится Приложение Node.js работает.
Ответ можно проверить и с вашего компьютера:
curl -i https://ваш-домен.com/В первой строке должен быть указан код 200. Первый запрос может выполняться дольше, пока приложение запускается.
Чтобы просмотреть сообщения приложения, откройте Журналы для вашего домена, разверните Все журналы и оставьте отмеченным только пункт Node.js.
Обновление приложения
- Загрузите измененные файлы.
- Если изменился
package.json, снова нажмите Установка NPM. - При необходимости повторно запустите скрипт компиляции.
- Нажмите Перезапустить приложение.
Чтобы автоматизировать эти обновления, см. руководство Развернуть сайт из GitHub или GitLab с помощью Plesk.
Устранение неполадок
«Web application could not be started» или «We're sorry, but something went wrong»
Приложение аварийно завершилось при запуске. Откройте Журналы, чтобы прочитать точный текст ошибки, затем проверьте:
- что Файл запуска приложения действительно находится в папке, указанной в поле Корневая папка приложения;
- что зависимости установлены;
- что версия Node.js соответствует той, которую требует проект;
- что заданы все необходимые переменные среды.
«The file does not exist» на странице Node.js
Plesk не находит файл запуска. Проверьте значение Корневая папка приложения и имя файла с учетом регистра букв.
Error: Cannot find module 'express'
Зависимости отсутствуют. Нажмите Установка NPM, убедитесь, что модуль указан в dependencies, а не только в devDependencies, и перезапустите приложение.
ERR_REQUIRE_ESM или «require() of ES Module not supported»
Passenger загружает файл запуска через require(), что может привести к ошибке, если в проекте используются модули ES ("type": "module" в package.json). Создайте в папке приложения небольшой файл passenger.cjs:
import('./app.js').catch((error) => {
console.error(error);
process.exit(1);
});Затем укажите passenger.cjs в поле Файл запуска приложения и перезапустите приложение.
Приложение не запускается и в итоге превышает время ожидания
Вероятно, файл запуска не вызывает listen(). Это часто встречается в проектах, созданных с помощью express-generator, где сервер запускается из bin/www, а не из app.js. Укажите правильный файл или перенесите вызов listen().
Ошибка, связанная с несколькими HTTP-серверами
Passenger подключается к первому серверу, вызвавшему listen(), и сообщает об ошибке, если приложение создает несколько серверов. Явно укажите сервер, который нужно использовать:
if (typeof PhusionPassenger !== 'undefined') {
PhusionPassenger.configure({ autoInstall: false });
}
const port = typeof PhusionPassenger !== 'undefined' ? 'passenger' : 3000;
server.listen(port);Отображается страница Plesk по умолчанию или ошибка 403
Убедитесь, что Node.js включен для этого домена и что Корневая папка указывает на /httpdocs/public. Старый файл index.html в этой папке будет отдаваться вместо вашего приложения: удалите или переименуйте его.
Изображения или таблицы стилей возвращают ошибку 404
Статические файлы должны находиться в папке, указанной в поле Корневая папка. URL /logo.png соответствует файлу public/logo.png, при этом public в адресе не указывается.
Ваши изменения не применяются
Node.js хранит код в памяти. Нажимайте Перезапустить приложение после каждой загрузки файлов или изменения переменной.
Установка NPM завершается с ошибкой
Прочитайте выведенное сообщение: в нем указан проблемный пакет. Убедитесь, что Версия Node.js соответствует полю engines ваших зависимостей и что файл package-lock.json актуален. Если в ошибке говорится о нехватке памяти или о компиляции нативного модуля, обратитесь в поддержку через вашу клиентскую зону и приложите это сообщение.