> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/learn/9.-sistema-i-rasshireniya/03-plugin-installation.md).

# Установка плагина

Выберите готовый плагин или безопасно проверьте свой ZIP-пакет до установки

## Что вы получите

Вы найдёте подходящее расширение в отдельном разделе **«Плагины»**, проверите поставщика, совместимость, запрашиваемые возможности и план изменений, а затем установите пакет без немедленного включения в финансовый контур.

{% hint style="danger" %}
Плагин выполняет код на сервере и может запрашивать доступ к курсам, валютам, заявкам, платежам, персональным данным, внешним сервисам и фоновым задачам. Предпросмотр защищает от небезопасного архива и несовместимого manifest, но не доказывает добросовестность поставщика.
{% endhint %}

## Выберите путь установки

{% tabs %}
{% tab title="Готовый плагин" %}
Откройте **«Плагины» — «Готовые плагины»**. Это основной путь для пакетов, поставляемых вместе с системой. Каталог показывает доступные категории, карточки, иконки, назначение, поставщика и совместимость.
{% endtab %}

{% tab title="Свой пакет" %}
Откройте **«Плагины» — «Установленные плагины»** и начните установку из ZIP-файла или по прямой защищённой HTTPS-ссылке. Используйте этот путь только для пакета, источник которого вы можете подтвердить.
{% endtab %}
{% endtabs %}

Состав готового каталога зависит от поставки. Отсутствующая карточка не означает, что нужно скачивать случайный архив из стороннего источника.

## Подготовьте окно изменений

До загрузки пакета зафиксируйте:

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

Если плагин заменяет действующий источник курса, мерчант, выплату, KYC/AML-проверку или канал уведомлений, сначала подготовьте безопасный альтернативный процесс.

## Проверьте готовый каталог

Откройте карточку пакета и последовательно изучите:

1. название, системное имя, поставщика и назначение;
2. категорию и заявленные возможности;
3. совместимость с текущей системой;
4. наличие установленной версии или доступного обновления;
5. сведения о доверии и подписи, если они показаны;
6. изменения, доступы и зависимости, которые потребуются после установки.

Нажимайте установку только из карточки, которую вы полностью сверили. Rapira и 2328 могут находиться в готовом каталоге вашей поставки, но каждый из них всё равно требует отдельной настройки и проверки конечного результата. Для выплаты через 2328 дополнительно подтвердите, кто оплачивает сетевую комиссию, и сверьте сумму получателя одной контрольной выплатой.

## Загрузите собственный пакет

{% tabs %}
{% tab title="ZIP-файл" %}
Выберите или перетащите исходный ZIP-архив. Максимальный размер загрузки в форме — **50 MB**. Не распаковывайте и не меняйте содержимое, чтобы обойти проверку.
{% endtab %}

{% tab title="HTTPS-ссылка" %}
Укажите прямую публичную HTTPS-ссылку на ZIP. Ссылка не должна вести на страницу авторизации, редирект на HTML или внутренний адрес. Не помещайте постоянный секрет в URL.
{% endtab %}
{% endtabs %}

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

## Выполните предпросмотр

Нажмите **«Проверить пакет»** и не переходите дальше, пока не изучены все результаты.

{% stepper %}
{% step %}

### Сверьте идентичность

Название, системное имя, поставщик и описание должны совпадать с карточкой или документами поставщика. Конфликт владельца системного имени блокирует безопасную установку.
{% endstep %}

{% step %}

### Проверьте совместимость

Сверьте требования к системе, PHP, Laravel и расширениям. Не исправляйте manifest вручную ради прохождения проверки.
{% endstep %}

{% step %}

### Изучите возможности

Пакет может объявить получение курсов, приём платежей, выплаты, KYC, AML, уведомления, прокси, страницу панели или другую интеграцию. Для каждой возможности прочитайте назначение и запрашиваемую область данных.
{% endstep %}

{% step %}

### Проверьте доступы и внешние связи

Особенно внимательно изучите чтение или изменение заявок, персональные данные, создание платежей и выплат, внешние HTTPS-запросы, секреты, события и расписания. Лишний доступ — причина остановиться.
{% endstep %}

{% step %}

### Прочитайте план изменений

План должен показать сохранение отдельного релиза, подключение возможностей, регистрацию настроек и секретов, зависимости, миграции и фоновые действия. Миграции применяются только отдельной защищённой операцией.
{% endstep %}

{% step %}

### Убедитесь, что архив не изменился

Установка разрешена только для того пакета, который прошёл предпросмотр. Если файл, ссылка или срок подтверждения изменились, выполните проверку заново.
{% endstep %}
{% endstepper %}

Продолжайте только при положительном результате. Сообщение о повреждении, конфликте, неподдерживаемой возможности, подписи или совместимости нельзя считать косметическим предупреждением.

## Установите и завершите первичную настройку

После установки откройте **«Плагины» — «Установленные плагины»** и проверьте:

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

Не включайте зависимый рабочий контур, пока обязательная конфигурация, секреты, миграции и health-check не подтверждены.

{% hint style="warning" %}
API-ключи, пароли и токены сохраняйте только в защищённых полях плагина. Не помещайте их в GitBook, описание, журнал смены, снимок экрана или обычное поле настройки.
{% endhint %}

## Если плагин поставляет курсы

Для источника курсов отдельно выберите предусмотренный режим первичной загрузки пар. Импорт может выполняться фоново и проходить состояния ожидания, загрузки, успеха, ошибки или замены более новым импортом.

1. Дождитесь финального состояния импорта именно текущего релиза.
2. Откройте **«Парсер курсов» — «Курсы из источников»**.
3. Найдите источник и сверьте пары, ориентацию и время обновления.
4. Включите только одну контрольную пару.
5. Подключите её к выключенному направлению.
6. Откройте **«Как сформирован курс»** и докажите фактическое значение.

Процент импорта без свежей пары в направлении не является доказательством работоспособности.

## Этап завершён, если

* [ ] выбран точный пакет из подтверждённого источника;
* [ ] есть проверяемая резервная копия и план отката;
* [ ] карточка готового плагина или собственный архив полностью изучены;
* [ ] собственный ZIP не превышает 50 MB либо используется безопасная прямая HTTPS-ссылка;
* [ ] предпросмотр подтвердил идентичность, целостность и совместимость;
* [ ] возможности, доступы, зависимости, события и расписания понятны;
* [ ] обязательные настройки и секреты заполнены в правильных полях;
* [ ] миграции не запущены без отдельного решения;
* [ ] health-check выполнен;
* [ ] для источника курса проверена фактическая пара и контрольное направление;
* [ ] рабочий финансовый контур ещё не включён без сквозной проверки.

После установки переходите к [правам, состоянию, обновлению, откату и удалению](https://docs.iexexchanger.com/learn/9.-sistema-i-rasshireniya/04-plugin-operations.md).
