> 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 выполнен;
* [ ] для источника курса проверена фактическая пара и контрольное направление;
* [ ] рабочий финансовый контур ещё не включён без сквозной проверки.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/learn/9.-sistema-i-rasshireniya/03-plugin-installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.