Настройка и работа PM2 для Frontend

PM2 используется для запуска Frontend-сервера Angular SSR в рабочем режиме (Production).

В отличие от обычного статического сайта, Frontend iEXExchanger запускает Node.js-приложение, которое отвечает за генерацию HTML-страниц, обработку маршрутов, мультиязычность, SEO и взаимодействие с Backend.

PM2 позволяет:

• запускать Frontend как фоновый процесс;
• автоматически перезапускать сервер при сбоях;
• сохранять логи работы;
• автоматически запускать Frontend после перезагрузки сервера;
• управлять запуском, остановкой и перезапуском приложения.

По умолчанию Frontend работает на локальном порту:

127.0.0.1:4000

Nginx принимает запросы пользователей и передаёт их в Angular SSR:

Перед началом

Перед настройкой убедитесь, что:

• Frontend уже установлен;
• выполнена сборка проекта;
• настроен Nginx;
• установлен Node.js;
• установлен PM2;
• существует файл .env;
• существует папка dist/exchanger.

Где находится PM2-конфигурация

Файл конфигурации PM2 находится в корне Frontend-проекта:

/var/www/имя_пользователя_frontend/data/www/ваш_домен/ecosystem.config.cjs

Структура проекта должна выглядеть примерно так:

/var/www/имя_пользователя_frontend/data/www/ваш_домен/

├── dist/
│   └── exchanger/
│       ├── browser/
│       └── server/
├── logs/
├── .env
└── ecosystem.config.cjs

Создание папки логов

Перед первым запуском создайте папку для логов:

mkdir -p logs

В ней будут храниться журналы работы Frontend.

Рекомендуемая конфигурация PM2

Для большинства проектов рекомендуется использовать следующую конфигурацию:

module.exports = {
    apps: [
        {
            name: 'iexexchanger',
            script: 'dist/exchanger/server/server.mjs',
            cwd: __dirname,

            instances: 1,
            exec_mode: 'fork',

            autorestart: true,
            watch: false,

            max_memory_restart: '1G',

            env: {
                NODE_ENV: 'production',
                PORT: 4000,
                HOST: '127.0.0.1',
                PM2: 'true',
            },

            log_date_format: 'YYYY-MM-DD HH:mm:ss Z',

            error_file: 'logs/err.log',
            out_file: 'logs/out.log',

            merge_logs: true,
            time: true,

            wait_ready: true,
            listen_timeout: 10000,
            kill_timeout: 5000,
            exp_backoff_restart_delay: 100,
        },
    ],
};

Данная конфигурация подходит для большинства серверов и рекомендуется использовать её без изменений.

Описание основных параметров

1

name

Название процесса.

name: 'iexexchanger'

Именно это имя используется во всех командах PM2.

Например:

pm2 status
pm2 logs iexexchanger
pm2 restart iexexchanger

2

script

Файл запуска Angular SSR.

script: 'dist/exchanger/server/server.mjs'

Если структура проекта стандартная, менять этот путь не требуется.

3

cwd

Рабочая директория процесса.

cwd: __dirname

Frontend использует текущую директорию для поиска файла .env.

Если параметр указан неправильно, приложение может не загрузить настройки окружения.

4

instances

Количество одновременно работающих процессов.

По умолчанию рекомендуется:

instances: 1

Этого достаточно для большинства обменных пунктов.

5

exec_mode

Режим запуска процесса.

Рекомендуемое значение:

exec_mode: 'fork'

Именно этот режим используется по умолчанию.

6

autorestart

Автоматический перезапуск после сбоя.

autorestart: true

Рекомендуется всегда оставлять включённым.

7

watch

Автоматический перезапуск при изменении файлов.

watch: false

Для Production всегда рекомендуется использовать:

false

8

max_memory_restart

Максимальный объём памяти, после которого PM2 автоматически перезапустит процесс.

По умолчанию:

max_memory_restart: '1G'

Рекомендации:

512M — небольшой сервер
1G — рекомендуется для большинства проектов
2G — высокая нагрузка и большой объём памяти

9

env

Переменные окружения.

env: {
    NODE_ENV: 'production',
    PORT: 4000,
    HOST: '127.0.0.1',
    PM2: 'true',
}

Основные параметры:

• NODE_ENV включает production-режим;
• PORT должен совпадать с настройкой Nginx;
• HOST ограничивает доступ только локальным сервером;
• PM2=true сообщает приложению, что оно запущено через PM2.

10

wait_ready

wait_ready: true

Frontend сообщает PM2 о готовности после полного запуска сервера.

Рекомендуется всегда оставлять включённым.

11

listen_timeout

Максимальное время ожидания запуска.

listen_timeout: 10000

По умолчанию 10 секунд.

12

kill_timeout

Время корректного завершения процесса.

kill_timeout: 5000

13

Логи

error_file: 'logs/err.log'
out_file: 'logs/out.log'

out.log

Обычный вывод приложения.

err.log

Ошибки Frontend.

---

Почему рекомендуется использовать fork

Для большинства проектов рекомендуется:

instances: 1,
exec_mode: 'fork',

Такой режим:

• проще в настройке;
• проще диагностируется;
• использует меньше памяти;
• отлично подходит для большинства обменных пунктов.

Начинать работу рекомендуется именно с него.

Когда использовать cluster

Режим cluster можно использовать только при высокой нагрузке.

Например:

instances: 2,
exec_mode: 'cluster',

Использовать cluster рекомендуется, если:

• сервер имеет несколько CPU;
• достаточно оперативной памяти;
• сайт получает большое количество запросов;
• Frontend уже стабильно работает в режиме fork.

Не рекомендуется сразу использовать:

instances: 'max'

Если сервер имеет 8 ядер, PM2 создаст 8 процессов, что значительно увеличит потребление памяти.

---

Запуск Frontend

Перейдите в каталог проекта:

cd /var/www/имя_пользователя_frontend/data/www/ваш_домен

Запустите Frontend:

pm2 start ecosystem.config.cjs

Проверьте статус:

pm2 status

Если всё настроено правильно, процесс будет иметь статус:

online

После этого сохраните конфигурацию:

pm2 save

Автоматический запуск после перезагрузки

Чтобы Frontend автоматически запускался после перезагрузки сервера:

pm2 startup

PM2 покажет команду, которую необходимо выполнить от имени root.

После выполнения снова сохраните процессы:

pm2 save

Проверить можно командой:

pm2 resurrect
pm2 status

Перезапуск Frontend

После:

• обновления Frontend;
• изменения .env;
• изменения PM2-конфигурации;

выполните:

pm2 restart ecosystem.config.cjs --update-env

Параметр:

--update-env

заставляет PM2 перечитать файл .env.

Если изменился только код приложения:

pm2 restart iexexchanger

Остановка Frontend

Остановить:

pm2 stop iexexchanger

Запустить снова:

pm2 start ecosystem.config.cjs

Удалить процесс:

pm2 delete iexexchanger

После повторного запуска выполните:

pm2 save

Просмотр логов

Просмотр логов в реальном времени:

pm2 logs iexexchanger

Последние строки:

pm2 logs iexexchanger --lines 100

Также логи находятся в папке:

logs/out.log
logs/err.log

---

Очистка логов

Очистить логи PM2:

pm2 flush

Проверить размер папки:

du -sh logs

Проверка работы Frontend

Проверьте локальный порт:

curl -I http://127.0.0.1:4000

Если сервер отвечает, Frontend успешно работает.

Если ответа нет:

pm2 status
pm2 logs iexexchanger

---

Проверка файла .env

Перед запуском или перезапуском Frontend рекомендуется проверить основные параметры файла .env.

Особое внимание обратите на:

ALLOWED_HOSTS=ваш_домен,app.ваш_домен

Если используется несколько доменов или www, добавьте их через запятую.

Также проверьте поддерживаемые языки:

SUPPORTED_LANGUAGES=ru,en,es,fr,pl,uk,zh,ka,kk

И язык по умолчанию:

DEFAULT_LANGUAGE=ru

После изменения любого из этих параметров необходимо выполнить:

pm2 restart ecosystem.config.cjs --update-env

---

Связь PM2 и Nginx

PM2 запускает Angular SSR на:

127.0.0.1:4000

Nginx принимает запросы пользователей и передаёт их Frontend.

Если PM2 остановлен, Nginx не сможет получить ответ и пользователь увидит ошибку:

502 Bad Gateway

---

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

После загрузки новой версии Frontend рекомендуется:

1. Проверить наличие новой сборки:

dist/exchanger

1. Проверить файл .env.
2. Перезапустить Frontend:

pm2 restart ecosystem.config.cjs --update-env

1. Проверить статус:

pm2 status

1. Проверить работу сайта:

curl -I https://ваш_домен

---

Типовые проблемы

502 Bad Gateway

Проверьте:

pm2 status
pm2 logs iexexchanger --lines 100
curl -I http://127.0.0.1:4000

Frontend работает, но сайт не открывается

Проверьте:

• настройки Nginx;
• порт 4000;
• совпадает ли порт в .env, PM2 и Nginx.

Ошибка DEFAULT_LANGUAGE или SUPPORTED_LANGUAGES

Проверьте параметры:

SUPPORTED_LANGUAGES=ru,en
DEFAULT_LANGUAGE=ru

После изменения:

pm2 restart ecosystem.config.cjs --update-env

Ошибка ALLOWED_HOSTS

Проверьте:

ALLOWED_HOSTS=example.com,app.example.com

Не рекомендуется использовать:

ALLOWED_HOSTS=*

Backend API недоступен

Проверьте:

API_URL=https://app.example.com

Не используйте:

API_URL=/backend-api

или

API_URL=https://example.com/backend-api

PM2 не использует .env

Убедитесь, что:

• ecosystem.config.cjs находится в корне проекта;
• используется:

cwd: __dirname

• Frontend перезапущен командой:

pm2 restart ecosystem.config.cjs --update-env

Краткий чек-лист

1. Создайте папку логов.

mkdir -p logs

1. Проверьте .env.
2. Проверьте ecosystem.config.cjs.
3. Запустите Frontend.

pm2 start ecosystem.config.cjs

1. Проверьте статус.

pm2 status

1. Сохраните процессы.

pm2 save

1. Настройте автозапуск.

pm2 startup
pm2 save

1. Проверьте локальный порт.

curl -I http://127.0.0.1:4000

1. Проверьте работу сайта.

curl -I https://ваш_домен

---

Рекомендуемая настройка

Для большинства обменных пунктов рекомендуется использовать:

instances: 1,
exec_mode: 'fork',

Переходить на режим cluster имеет смысл только после появления высокой нагрузки и при наличии достаточного запаса процессорных ресурсов и оперативной памяти.