Что такое PM2

Роль pm2-runtime в клиентском SSR и отличие от отдельного PM2 daemon

PM2 — менеджер процессов Node.js. В новой установке iEXExchanger используется команда pm2-runtime внутри системной службы iex-frontend.service: она запускает один SSR-процесс клиентского сайта, а systemd отвечает за автозапуск и восстановление.

Что важно понимать

• у PM2 нет отдельного пункта и прямых команд в панели iEXExchanger;
• системная служба клиентского сайта отображается строкой «Frontend» по пути «Утилиты» — «Службы»;
• клиентский SSR доступен снаружи только через Nginx;
• основная установка не требует pm2 startup и pm2 save;
• не нужно запускать второй пользовательский PM2 daemon;
• PM2 не управляет PHP-FPM, Horizon, Pulse, Reverb, PostgreSQL или Redis.

Проверка новой установки

systemctl --no-pager --full status iex-frontend.service
journalctl -u iex-frontend.service --since '-1 hour' --no-pager

Затем проверьте внутренний ответ SSR и публичный HTTPS-домен. Состояние active не доказывает, что процесс использует правильную сборку и правильный API.

Почему используется один процесс

Штатная конфигурация запускает один SSR-процесс в режиме fork на внутреннем адресе. Самовольное включение cluster или нескольких экземпляров требует отдельной проверки сессий, кеша, памяти, портов и корректного завершения. Не меняйте число процессов только ради предполагаемого ускорения.

После обновления

Экран «Обновления» переключает клиентскую поставку и перезапускает iex-frontend.service. Не выполняйте параллельный pm2 restart. После завершения проверьте время активной сборки, внутренний SSR, публичную страницу и отсутствие новых ошибок службы.

Для отдельного предусмотренного действия используйте строку «Frontend» на экране «Службы». Для просмотра нужно право «Просмотр служб обменника», для запуска, остановки и перезапуска — «Управление службами обменника» из блока «Админпанель».

Существующий сервер

На ранее установленном сервере с FASTPANEL может использоваться обычный PM2-контекст владельца клиентского сайта с pm2 startup и pm2 save. Это отдельная наследуемая схема. Не переносите её команды в новую systemd-установку и не запускайте одновременно оба варианта.

Граница старой схемы описана в «Supervisor и PM2 на существующем сервере». Возможности pm2-runtime приведены в официальной документации PM2.