Настройка и работа с Node.js

Включение Node.js для сайта

При создании или редактировании сайта:

• В поле Обработчик выберите Node.js.

• Укажите нужную версию Node.js (доступны последняя и LTS-версии начиная с 12.13.0).

• Выберите способ подключения:

  • Сокет файл — приложение будет использовать Unix-сокет;

  • Порт — приложение будет использовать TCP-порт.

Добавление проекта Node.js на сайт

1. Перейдите в Сайты → выберите нужный сайт.

2. Нажмите Файлы сайта.

3. В открывшемся Менеджере файлов нажмите Загрузить.

4. Выберите источник:

   • Локальный файл — нажмите Выбрать файл или перетащите его в зону загрузки.

   • Файл по URL — укажите ссылку и имя файла.

5. Убедитесь, что package.json и server.js корректно настроены.

6. Вернитесь к списку сайтов → нажмите кнопку “…” → Npm install.

7. Дождитесь завершения установки (иконка Node.js мигает).

8. После установки нажмите “…” → Перезапустить (Node.js).

9. Убедитесь, что иконка Node.js стала зелёной — это означает, что приложение работает.

Конфигурационный файл package.json

Файл package.json нужен для описания проекта и его зависимостей. Пример по умолчанию:

{
"name": "doc.test",
"version": "1.0.0",
"description": "",
"main": "server.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"start": "node server.js"
},
"keywords": [],
"author": "",
"license": "ISC"
}

Изменить его можно через:
Сайты → выбрать сайт → Файлы конфигурации.

Служебные каталоги

При использовании Node.js создаются каталоги в домашней директории пользователя:

• /var/www/ИМЯ/data/.npm/ — данные npm;

• /var/www/ИМЯ/data/.nvm/ — версии Node.js;

• /var/www/ИМЯ/data/.pm2/ — данные pm2.

Эти каталоги важны для работы Node.js. При их удалении часть данных может быть утрачена.

Использование shell-клиента

Если у пользователя включён доступ к shell:

1. Перейдите в Сайты → выберите сайт → меню → Shell-клиент.

2. Автоматически:

   • откроется домашняя директория сайта;

   • в переменную PATH будут добавлены пути Node.js.

Удаление Node.js

Перейдите в Конфигурация ПО → Node.js → Отключить.
Node.js, npm и pm2 будут удалены.

Удаление невозможно, если в панели есть сайты с активным Node.js.

Особенности

• При включённом Node.js установка CMS или конструкторов сайтов недоступна.

• После изменений в коде проекта — обязательно перезапускайте сайт:
  Сайты → сайт → Перезапустить.

• При восстановлении из резервной копии ISPmanager попытается сохранить порт/сокет. Если они заняты — назначаются новые.