Настройка Frontend

Frontend представляет собой клиентскую часть обменного пункта, которая будет доступна пользователям по основному домену сайта.

На данном этапе необходимо загрузить архив Frontend на основной домен, распаковать файлы и убедиться, что сайт корректно открывается через браузер.

После завершения настройки Frontend должен быть доступен по адресу: https://ваш_домен

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

Перед выполнением данного этапа убедитесь, что:

• основной домен уже создан в FastPanel;
• SSL-сертификат для основного домена настроен;
• архив Frontend скачан из личного кабинета iEXExchanger;
• вы имеете доступ к панели управления FastPanel.

---

Загрузка файлов Frontend

В панели управления FastPanel перейдите в раздел «Сайты» и выберите основной домен: ваш_домен

Перейдите в раздел «Файлы».

Откроется корневая директория сайта.

Файлы сайта в FastPanel

Загрузите архив Frontend, полученный в личном кабинете iEXExchanger, используя кнопку «Загрузить» в верхней части файлового менеджера.

После завершения загрузки распакуйте архив непосредственно в корневую директорию сайта.

Проверка структуры проекта

После распаковки в корневой директории сайта должна присутствовать директория: dist/exchanger

Именно она содержит готовую клиентскую часть системы и SSR-сервер Angular.

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

---

Создание файла .env

После загрузки файлов необходимо создать конфигурационный файл Frontend.

В корневой директории проекта создайте новый файл: .env

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

NODE_ENV=production
PORT=4000
HOST=127.0.0.1

PM2=true

SUPPORTED_LANGUAGES=ru,en
DEFAULT_LANGUAGE=ru

ALLOWED_HOSTS=ваш_домен,app.ваш_домен
API_URL=https://app.ваш_домен

CSS_VERSION=1

CUSTOM_THEME=custom-theme
CUSTOM_THEME_URL=/static/theme/custom-theme.css

Настройка языков

После создания файла сохраните изменения.

Настройка параметров

Обязательно измените следующие параметры:

1

ALLOWED_HOSTS

Укажите основной домен обменного пункта.

Пример: ALLOWED_HOSTS=example.com,app.example.com

2

API_URL

Укажите адрес технического поддомена.

Пример: API_URL=https://app.example.com

3

SUPPORTED_LANGUAGES

Список языков, доступных на сайте. Языки указываются через запятую.

Если в вашей сборке доступны все языки, можно указать:

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

Важно: язык должен существовать в самой сборке Frontend. Нельзя просто добавить язык в .env, если в dist/exchanger/browser/ нет папки этого языка.

Создание конфигурации PM2

Для последующего запуска Frontend необходимо создать конфигурационный файл PM2.

В корневой директории проекта создайте новый файл: ecosystem.config.cjs

Добавьте в него следующий код:

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,
        },
    ],
};

Для обычного production-сервера в FastPanel рекомендуется начинать с одного процесса:

instances: 1
exec_mode: 'fork'

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

instances: 'max'
exec_mode: 'cluster'

Режим cluster и instances: 'max' можно использовать только на более мощных серверах после проверки нагрузки.

Настройка Fork и Cluster в PM2

После добавления конфигурации нажмите кнопку «Сохранить».