Как разместить Node.js на общем хостинге? – (Пошаговое руководство)

Как разместить Node.js на общем хостингеВыберите поставщика, поддерживающего Node (обычно через менеджер приложений cPanel).CloudLinux В разделе "Пассажир" загрузите свое приложение, установите зависимости с помощью npm, настройте файл запуска и переменные среды, а также сопоставьте домен или поддомен.

Если ваш хостинг не поддерживает Node.js, используйте внешнюю платформу Node.js или перейдите на VPS. Размещение Node.js на общем хостинге возможно, если ваш провайдер это поддерживает, но это сопряжено с ограничениями.

В этом руководстве я пошагово покажу, как разместить Node.js на общем хостинге с помощью cPanel + Passenger, что делать, если ваш хостинг не поддерживает Node, и когда целесообразнее использовать VPS для рабочих нагрузок в продакшене.

Можно ли разместить Node.js на общем хостинге?

Да, если ваш виртуального хостинга. использования CloudLinux и разоблачает Настройка приложения Node.js в cPanel (Пассажирский). Это позволяет Apache Проксирование трафика в ваше Node-приложение без открытия пользовательских портов. Не все хостинги общего пользования предоставляют такую ​​возможность. Без Passenger можно запустить Node-приложение, доступное для всех пользователей. сервер на общем хостинге Это редко бывает осуществимо.

Когда работает общий хостинг

Выберите виртуальный хостинг Если ваше приложение небольшое или находится в разработке, получает умеренный трафик, не требует фоновых процессов и не нуждается в ресурсоемких задачах, связанных с WebSocket, оно отлично подойдет для небольших API, панелей управления, инструментов администрирования или учебных проектов.

Когда вам нужен VPS

Выбирайте VPS, если вам нужен PM2, пользовательские порты, масштабируемые WebSockets, длительно выполняющиеся фоновые задачи, нативные модули (инструменты сборки) или предсказуемый график работы. CPU/RAMVPS также подходит. Конвейеры CI / CD и микросервисы. Если вам станет недостаточно общего хостинга, переход на него будет нецелесообразен. managed VPS — это просто.

Предварительные требования и контрольный список

• Общий хостинг с поддержкой Node.js (cPanel Application Manager/)CloudLinux Селектор/Пассажир Node.js).
• SSH доступ или используйте терминал cPanel для выполнения команды npm install.
• Совместимость версий Node.js (например, Node 18/20 LTS).
• Файл запуска приложения (например, app.js/server.js) и файл package.json со скриптом запуска.
• Домен/поддомен готов (например, api.example.com) и DNS доступа.
• Дополнительно: Репозиторий Git для Беспроблемное развертывание с помощью системы контроля версий Git в cPanel..

Метод 1: Размещение Node.js на общем хостинге с cPanel + Passenger

Это самый надежный способ разместить Node.js на общем хостинге. Passenger запускает ваше приложение за ним. Apache/Nginx и сопоставляет его с вашим доменом без открытия пользовательских портов.

1. Подготовьте минимальное приложение на Express.

Ваше приложение должно привязываться к параметру process.env.PORT, если он задан. Passenger устанавливает его автоматически. Вот минимальный пример:

// server.js
const express = require('express');
const app = express();

const PORT = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.send('Hello from Node.js on shared hosting via Passenger!');
});

app.listen(PORT, '127.0.0.1', () => {
  console.log(`Server listening on port ${PORT}`);
});

Убедитесь, что ваш файл package.json содержит скрипт запуска:

{
  "name": "shared-node",
  "version": "1.0.0",
  "main": "server.js",
  "type": "module",
  "scripts": {
    "start": "node server.js"
  },
  "dependencies": {
    "express": "^4.19.0"
  }
}

2. Создайте приложение в cPanel.

• Войдите в cPanel.
• Откройте «Настройка приложения Node.js» или «Менеджер приложений».
• Нажмите «Создать заявку».
• Выберите версию Node.js (предпочтительно LTS, например, 18 или 20).
• Режим приложения: Производство.
• Корневой каталог приложения: Папка, содержащая ваше приложение (например, /home/user/apps/shared-node).
• URL/домен приложения: Выберите домен или поддомен (например, api.example.com).
• Файл запуска приложения: server.js (или выбранная вами точка входа).
• Сохраните/разверните, чтобы создать среду.

После создания cPanel отображает путь к виртуальной среде и предлагает выполнить команду «Запустить NPM Install» или SSH Инструкции. Используйте их для установки зависимостей в корневую папку приложения.

3. Загрузите код и установите зависимости.

• Через файл Менеджер: Загрузите ZIP-архив и распакуйте его в корневую папку приложения.
• Через Git: Используйте «Систему контроля версий Git» в cPanel, чтобы клонировать свой репозиторий в корневую папку приложения и получать обновления.
• С помощью SSH/Терминал: Перейдите в корневую папку приложения и выполните команду `npm install`.

# In cPanel Terminal or SSH
cd ~/apps/shared-node
npm ci --only=production
# or
npm install --production

4. Настройка переменных среды (необязательно)

В интерфейсе приложения Node.js добавьте пары ключ/значение, например, NODE_ENV=production, ключи API и URL-адреса баз данных. Не сохраняйте секреты в Git; по возможности храните их в переменных окружения.

5. Перезапуск и тестирование

• После внесения любых изменений нажмите кнопку «Перезапустить приложение» в cPanel.
• Перейдите на свой домен/поддомен. Вы должны увидеть ответ вашего приложения.
• Если вы видите ошибки 503, проверьте журналы Passenger и путь к файлу запуска.

# Useful checks
node -v
cat ~/logs/<domain>.error.log
cat ~/apps/shared-node/passenger.log

Метод 2: Если ваш хостинг-провайдер не поддерживает Node.js

Некоторые общие хосты блок пользовательские Если у вас нет портов и вы не предлагаете Passenger, то вы не сможете напрямую предоставить доступ к общедоступному серверу Node. Воспользуйтесь одним из этих обходных путей.

Вариант А: Внешняя платформа Node + Ваш домен

• Разверните свое Node-приложение на такой платформе, как Render, Railway, Fly.io или аналогичной.
• Создайте поддомен (например, api.example.com) на вашем общем хостинге. DNS и запишите его в CNAME, указав путь к вашему внешнему приложению.
• Размещайте статические ресурсы (фронтенд) на общем хостинге; направляйте вызовы API на поддомен.
• Настройте CORS правильно и включите HTTPS. Многие платформы предоставляют бесплатный TLS.

Вариант B: Переход на управляемый VPS

VPS предоставляет полный контроль: выбор версии Node, запуск PM2, включение WebSockets и масштабирование ресурсов. Если ваш проект ориентирован на клиентов или имеет критически важное значение для получения дохода, то VPS — это лучший вариант. managed VPS безопаснее и быстрее, чем нарушение общих ограничений.

At YouStable, мы рекомендуем NVMe-накопитель manageVPS для Node.jsВы получаете корневой доступ, изолированные ресурсы и помощь в настройке и миграции — идеально, когда ваш хостинг становится слишком мал для вас.

Рекомендации по использованию Node.js на общем хостинге

• Используйте LTS: Для обеспечения безопасности и стабильности выбирайте Node 18 или 20.
• Обработка портов: Всегда привязывайтесь к параметру process.env.PORT, если он присутствует.
• Режим производства: Установите параметр NODE_ENV=production, чтобы включить оптимизацию производительности.
• Легковесные зависимости: Избегайте использования ресурсоемких нативных модулей, требующих инструментов сборки.
• Логирование: Записывайте логи в файлы или используйте легковесный удаленный сервис; избегайте подробных логов в консоли в производственной среде.
• Безопасность: Храните секреты в переменных окружения; очищайте входные данные; проверяйте полезную нагрузку; ограничивайте скорость передачи конфиденциальных маршрутов.
• Статическое кэширование: Предоставлять статические ресурсы с заголовками кэширования (фронтенд через Apache/LiteSpeed кэширование).
• Медицинские осмотры: Добавьте конечную точку /health для проверки доступности.
• Плавный перезапуск: Для подтверждения изменений используйте функцию перезапуска cPanel; не полагайтесь на длительно выполняющиеся фоновые задачи в общих папках.

Устранение распространенных ошибок

• Служба 503 недоступна: Неверный путь к файлу автозагрузки, сбой приложения или отсутствие зависимостей. Проверьте файл автозагрузки в cPanel, запустите npm ci, проверьте passenger.log.
• Приложение произвольно останавливается: Общие процессы можно повторно использовать. Избегайте фоновых задач; поддерживайте минимальную производительность приложения; рассмотрите возможность использования VPS для демонов/очередей.
• Не удается установить собственные модули: В общих средах часто отсутствуют инструменты сборки. Замените их на альтернативы, использующие только JavaScript, или перейдите на VPS.
• Несоответствие версий Node.js: В панели cPanel измените версию Node в соответствии с полем engines вашего приложения; переустановите папку node_modules.
• WebSocket не работает: Некоторые общие стеки ограничивают возможности подключения при обновлении. Протестируйте с помощью простого сервера веб-сервисов; если он работает ненадежно, используйте VPS или другой сервер. managed Узел хоста.

Реалистичные ожидания и путь обновления

Общий хостинг — это экономичный способ разместить приложение Node.js в сети, но он не предназначен для ресурсоемких, сохраняющих состояние или чувствительных к задержкам сервисов. Начните с малого, проверьте свое приложение и отслеживайте использование. Когда вам потребуется автоматическое масштабирование, фоновые процессы или полный контроль, переходите на общий хостинг. managed VPS.

Если вы не уверены, уточните у своего хостинг-провайдера, поддерживают ли они «cPanel Node.js App» или «CloudLinux Пассажир». Если нет, перенаправьте свой API на внешнюю платформу Node или перейдите на VPS. YouStable Мы поможем вам выбрать подходящий тарифный план и осуществить миграцию с минимальным временем простоя.

Пошаговое описание (cPanel + Passenger)

• Подготовьте свое приложение, создав файл автозагрузки и скрипт запуска.
• Создайте приложение Node.js в cPanel, укажите версию Node, корневую папку приложения и файл запуска.
• Загрузите код (Менеджер файлов или Git) в корневую папку приложения.
• Установите зависимости через npm в виртуальной среде приложения.
• Установите переменные среды (production, ключи API, URL базы данных).
• Подключите домен или поддомен к приложению в cPanel.
• Перезапустите приложение и проверьте журналы, если возникнут проблемы.

Часто задаваемые вопросы