Настройка Backend

Backend — это серверная часть iEXExchanger. Она отвечает за работу API, административной панели, базы данных, авторизации, очередей, уведомлений, платёжных модулей и внутренних системных процессов.

Backend устанавливается на технический поддомен: https://app.ваш_домен

На данном этапе необходимо загрузить Backend, настроить файл .env, подключить базу данных, установить PHP 8.4, Redis и обязательные PHP-модули, а также правильно настроить сайт в FastPanel.

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

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

технический поддомен app.ваш_домен уже создан в FastPanel;
SSL-сертификат для поддомена настроен;
архив Backend скачан из личного кабинета iEXExchanger;
архив лицензии скачан из личного кабинета iEXExchanger;
файл конфигурации FastPanel для поддомена сохранён;
Frontend уже установлен и настроен;
у вас есть доступ к панели управления FastPanel.

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

На данном этапе необходимо загрузить Backend и файлы лицензии на сервер.

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

В панели управления FastPanel перейдите в раздел «Сайты».

Выберите технический поддомен: app.ваш_домен

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

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

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

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

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

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

Загрузка файлов лицензии

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

В корневую директорию Backend загрузите архив лицензии.

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

Не переименовывайте лицензионные файлы и не изменяйте их содержимое.

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

После распаковки в корневой директории поддомена должны присутствовать основные файлы и директории Laravel-проекта:

app/
bootstrap/
config/
database/
public/
resources/
routes/
storage/
vendor/
artisan
composer.json
composer.lock
.env

В зависимости от версии продукта также могут присутствовать дополнительные директории, модули и служебные файлы.

Особенно важно наличие директории: public

Именно она будет указана в FastPanel как рабочая директория сайта.

Также убедитесь, что в корне проекта присутствует файл: artisan

Он потребуется на следующих этапах установки для выполнения служебных команд Laravel.

Настройка приложения

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

Настройка файла .env

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

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

Основные параметры приложения

Проверьте и настройте основные параметры приложения:

APP_NAME=iEXExchanger

APP_ENV=production
APP_DEBUG=false

APP_URL=https://app.ваш_домен

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

Где:

https://ваш_домен — основной домен обменного пункта.
https://app.ваш_домен — технический поддомен Backend.

Настройка ключа лицензии

Для корректной работы системы необходимо указать лицензионный ключ в файле .env.

Лицензионный ключ можно получить в личном кабинете iEXExchanger.

Получение лицензионного ключа

Авторизуйтесь в личном кабинете на официальном сайте iEXExchanger.
В левом меню откройте раздел «Лицензия обменника».
При первом открытии раздела подтвердите доступ с помощью Google Authenticator или резервного секретного кода.
В списке лицензий найдите лицензию, привязанную к вашему домену.
Скопируйте значение из поля «Код лицензии».

Добавление ключа в .env

Откройте файл .env и укажите полученный ключ: LICENSE_KEY=ваш_лицензионный_ключ

Пример: LICENSE_KEY=K5044-67606-U7684-36813

Настройка пути к административной панели

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

Укажите параметр: APP_ADMIN_PATH=ваш_путь_к_админке

Пример: APP_ADMIN_PATH=iexadmin

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

https://app.ваш_домен/iexadmin

Рекомендуется использовать уникальный путь.

Итоговый пример доменных настроек .env

После настройки основные параметры должны выглядеть следующим образом:

APP_URL=https://app.ваш_домен
API_URL=https://app.ваш_домен
FRONTEND_URL=https://ваш_домен
APP_ADMIN_PATH=iexadmin

Настройка баз данных

На данном этапе производится настройка всех баз данных проекта.

Настройка основной базы данных

После создания поддомена FastPanel автоматически создаёт базу данных и пользователя.

Используйте данные из файла конфигурации FastPanel, который был сохранён после создания сайта.

Обычно в нём содержатся:

Пользователь:
- Имя: ваше_имя_пользователя  # указан в данных FastPanel после создания сайта
- Пароль: ваш_пароль_пользователя

База данных:
- Имя: имя_вашей_базы
- Логин: ваш_логин_базы
- Пароль: ваш_пароль_базы

Настройте параметры подключения:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306

DB_DATABASE=имя_вашей_базы
DB_USERNAME=логин_базы
DB_PASSWORD=пароль_базы

Импорт основной базы данных

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

В панели управления FastPanel откройте технический поддомен: app.ваш_домен

В блоке «Управление сайтом» перейдите в раздел «Базы данных».

В списке баз данных найдите базу, привязанную к вашему техническому поддомену.

Справа от базы данных нажмите кнопку меню «⋮».

В открывшемся меню выберите пункт: Загрузить SQL-дамп

После этого выберите файл базы данных из распакованного архива Backend:

database/iex_data.sql

Дождитесь завершения импорта.

Настройка базы данных Laravel Pulse

Laravel Pulse используется для мониторинга и анализа работы системы. С его помощью можно отслеживать производительность приложения, нагрузку на сервер, очереди, запросы к базе данных и другие внутренние показатели.

Для обеспечения стабильной работы рекомендуется использовать отдельную базу данных, предназначенную исключительно для Laravel Pulse.

В панели управления FastPanel откройте технический поддомен: app.ваш_домен

В блоке «Управление сайтом» перейдите в раздел «Базы данных».

Нажмите кнопку «Новая база данных».

В открывшейся форме заполните следующие поля:

Имя и логин: одинаковые (например, pulse_db)
Сайт: выберите app.ваш_домен
Владелец: выберите пользователя сайта (не root, не fastuser)
Пароль: сгенерируйте и сохраните пароль

Нажмите «Сохранить».

После создания добавьте параметры подключения в .env:

PULSE_DB_CONNECTION=mysql-pulse

PULSE_DB_HOST=127.0.0.1
PULSE_DB_PORT=3306

PULSE_DB_DATABASE=pulse_db
PULSE_DB_USERNAME=pulse_db
PULSE_DB_PASSWORD=пароль

Замените значения на реальные данные вашей базы данных Pulse.

Настройка авторизации и безопасности

На данном этапе производится настройка взаимодействия Frontend и Backend.

Настройка сессий

Укажите следующие параметры:

SESSION_DRIVER=database
SESSION_SECURE_COOKIE=true
SESSION_DOMAIN=.ваш_домен
SESSION_COOKIE=iexexchanger_session

Пример: SESSION_DOMAIN=.example.com

Обратите внимание на точку перед доменом.

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

Настройка CORS и Sanctum

Для корректной работы Frontend и Backend настройте следующие параметры:

CORS_ALLOWED_ORIGINS=https://ваш_домен,https://app.ваш_домен
CORS_SUPPORTS_CREDENTIALS=true
SANCTUM_STATEFUL_DOMAINS=https://app.ваш_домен

Пример:

CORS_ALLOWED_ORIGINS=https://example.com,https://app.example.com
CORS_SUPPORTS_CREDENTIALS=true
SANCTUM_STATEFUL_DOMAINS=https://app.example.com

Не используйте пробелы между доменами.

Настройка Laravel Reverb

Laravel Reverb используется системой для работы WebSocket-соединений, realtime-уведомлений, онлайн-статусов и других событий в реальном времени.

Добавьте в файл .env следующие параметры:

REVERB_HOST=app.ваш_домен
REVERB_PORT=443
REVERB_SCHEME=https

Пример:

REVERB_HOST=app.example.com
REVERB_PORT=443
REVERB_SCHEME=https

Настройка окружения сервера

Для работы Backend необходимо подготовить программное окружение сервера.

Установка PHP 8.4

Перейдите: «Настройки» — «Приложения»

В поиске укажите: php84

Найдите приложение «PHP 8.4».

Установите его и дождитесь завершения установки.

После установки приложение должно иметь статус: Установлен

Установка Redis

Redis используется системой для кеширования, очередей и внутренних процессов.

Перейдите: «Настройки» — «Приложения»

Найдите приложение: redis

Установите его.

После установки сервис должен иметь статус: Установлен

Установка PHP-расширений

После установки PHP 8.4 необходимо установить обязательные расширения.

Перейдите: «Управление» — «PHP» — «Модули PHP»

Выберите PHP 8.4.

Установите следующие модули:

gmp
imagick
redis
yaml
sodium

После установки убедитесь, что каждый модуль имеет статус «Установлен».

Настройка сайта в FastPanel

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

Настройка типа Backend и версии PHP

Перейдите: «Сайты» — «app.ваш_домен» — «Настройки»

Откройте раздел: Бэкенд (PHP, обратный прокси и т.п.)

Укажите:

Тип бэкенда: PHP
Обработчик: PHP-FPM
Версия PHP: 8.4
Количество воркеров: 2

Важно

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

При необходимости количество воркеров можно увеличить.

Чем мощнее сервер и больше доступных ресурсов (CPU и оперативной памяти), тем большее количество воркеров может использоваться для обработки запросов.

Если вы не уверены в выборе значения, оставьте рекомендуемое значение 2. Его всегда можно изменить позже в зависимости от нагрузки на проект.

Сохраните настройки.

Настройка рабочей директории

В настройках сайта обязательно укажите:

Рабочая поддиректория: public
Файл приложения: index.php

Это обязательная настройка для Laravel.

Если указать другую директорию, сайт может работать некорректно или раскрыть системные файлы проекта.

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

Проверка готовности Backend

Перед переходом к следующему этапу установки рекомендуется выполнить финальную проверку.

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

Backend загружен и распакован;
файлы лицензии загружены;
файл .env настроен;
лицензионный ключ добавлен;
домены настроены корректно;
база данных подключена;
база данных импортирована;
Laravel Pulse настроен;
PHP 8.4 установлен;
Redis установлен;
обязательные PHP-модули установлены;
сайт работает через PHP-FPM;
рабочая директория указана как public.

ПредыдущаяНастройка Frontend СледующаяНастройка Nginx

Последнее обновление 26 дней назад

Это было полезно?