> 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/nachalo-raboty/faily-licenzii-i-relizy.md).

# Файлы лицензии и релизы

Раздел **«Лицензия обменника»** используется для просмотра лицензий iEXExchanger, проверки доступного релиза и получения персонального скрипта установки `iex-install.sh`.

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

{% hint style="info" %}
`iex-install.sh` предназначен для первичной установки на чистый сервер. Для уже установленного обменника используется штатная система обновлений.
{% endhint %}

## Доступ к лицензиям

В личном кабинете откройте: **«Лицензия обменника»**

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

### Двухфакторная защита

Если доступ ещё не подтверждён, откроется блок **«Двухфакторная защита (Google 2FA)»**.

<figure><img src="https://4011313553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSZ7jPUG5OOOS4hofY7a2%2Fuploads%2FoxgwjEl3blxS2SZDvcVT%2Fimage.png?alt=media&amp;token=905fbe9c-3449-4b33-a574-96e70a4d2b1b" alt=""><figcaption></figcaption></figure>

#### Первое включение Google 2FA

Если защита не настроена:

1. Откройте Google Authenticator на смартфоне.
2. Добавьте аккаунт, отсканировав QR-код со страницы.
3. Введите текущий шестизначный код в поле **«Код из Google Authenticator»**.
4. Нажмите **«Активировать Google 2FA»**.

Если QR-код не сканируется, добавьте аккаунт вручную с помощью значения **«Секретный ключ для Google Authenticator»**.

#### Подтверждение доступа

Если Google 2FA уже включена:

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

Код обновляется каждые 30 секунд. После успешного подтверждения откроется список лицензий.

Если доступен заранее активированный резервный код, можно выбрать **«Секретный код»**, ввести его и нажать **«Подтвердить секретный код»**.

### Выбор лицензии

Найдите лицензию нужного проекта и нажмите **«Открыть лицензию»**.

<figure><img src="https://4011313553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSZ7jPUG5OOOS4hofY7a2%2Fuploads%2FtvoVaf89YpR8jbzsn9ij%2Fimage.png?alt=media&amp;token=6d4564b0-9382-4eaf-af78-a7d340d935fd" alt=""><figcaption></figcaption></figure>

В блоке **«Информация о лицензии»** проверьте домен и состояния **«Активна»** и **«Доступна к скачиванию»**.

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

***

## Получение скрипта установки

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

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

Перед созданием скрипта проверьте домен и номер релиза. Доступ к просмотру версии и возможность получить скрипт проверяются отдельно: для создания файла установка из кабинета должна быть разрешена для этой лицензии и релиза.

Сервер и домены подготовьте заранее. Условия и порядок действий приведены в разделе&#x20;

{% content-ref url="/pages/P1dIXcZyZ6ZMrFbj8IzO" %}
[Установка продукта](https://docs.iexexchanger.com/ustanovka-i-obnovlenie/ustanovka-produkta.md)
{% endcontent-ref %}

### Сохраните IP для установки

В блоке **«Информация о лицензии»** найдите поле **«IP для установки»**.

<figure><img src="https://4011313553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSZ7jPUG5OOOS4hofY7a2%2Fuploads%2FmvKyoyJsAmFDUZSAlx3x%2Fimage.png?alt=media&amp;token=dc6c677d-237b-47f1-933e-86f9f2f3fccf" alt=""><figcaption></figcaption></figure>

Укажите точный публичный исходящий IP сервера и нажмите **«Сохранить IP»**. При запуске проверяется адрес, с которого сервер выполняет проверку лицензии.

Указывайте IP сервера установки. Адрес вашего компьютера или узла Cloudflare для этой привязки не подходит. Если сервер использует NAT или отдельный исходящий адрес, уточните его у провайдера.

Если IP уже сохранён, проверьте его перед созданием скрипта.

{% hint style="warning" %}
Первоначальную привязку можно сохранить самостоятельно. После сохранения изменить IP может только администратор. Ошибка в адресе остановит установку.
{% endhint %}

### Создайте код и скачайте скрипт

Откройте: **«Релизы и файлы лицензии» — «Установка с нуля»**

<figure><img src="https://4011313553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSZ7jPUG5OOOS4hofY7a2%2Fuploads%2FmTUtNjBTBFWUJfGsdFMj%2Fimage.png?alt=media&amp;token=316004e4-c400-49d0-8cb2-16bc8343dbfc" alt=""><figcaption></figcaption></figure>

Если доступен только один способ установки, переключатель вкладок может отсутствовать. В этом случае используйте блок **«Установка из кабинета»**.

Нажмите **«Создать код и скачать скрипт»**. Система создаст одноразовый код и предложит сохранить файл `iex-install.sh`.

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

Код действует **30 минут с момента создания**. Поэтому создавайте скрипт после подготовки сервера и доменов.

{% hint style="warning" %}
Скрипт содержит секретные данные. Храните его как пароль, передавайте на сервер через SFTP или SCP и не публикуйте в открытом доступе. Не прикладывайте файл к обращениям в поддержку.
{% endhint %}

## Управление доступом к установке

### Ключ лицензии и одноразовый код

После создания скрипта в блоке установки отображаются **«Постоянный ключ лицензии»** и **«Одноразовый код установки»**.

Постоянный ключ связан с лицензией и не меняется при создании нового кода. Одноразовый код выдаётся для конкретной установки и проверяется вместе с лицензией, доменом и IP сервера.

Оба значения уже включены в `iex-install.sh`.

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

### Повторное скачивание того же скрипта

Если файл не скачался или его нужно сохранить повторно, нажмите **«Скачать тот же скрипт»**.

Кнопка доступна, пока страница хранит текущий код, он ещё не использован и срок его действия не истёк.

Если страница закрыта, код использован или срок истёк, повторное скачивание с этим кодом недоступно. Проверьте состояние установки перед созданием нового доступа.

### Новый код и отзыв доступа

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

```bash
sudo systemctl stop iexexchanger-install.service
```

#### Создание нового кода

Для замены действующего кода или сессии нажмите **«Создать новый код и скачать скрипт»**. Будет подготовлен новый персональный файл, а прежний доступ отозван.

Если отображается состояние **«Срок истёк»**, создайте новый код через **«Создать код и скачать скрипт»**.

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

#### Отзыв доступа

Чтобы закрыть действующий доступ, нажмите **«Отозвать доступ»**. Текущий код или сессия перестанут действовать, а в карточке появится состояние **«Отозван»**.

{% hint style="warning" %}
Создание нового кода и отзыв доступа не останавливают удалённо процесс, уже выполняющий изменения на сервере. Сначала остановите службу на самом сервере. Выполненные изменения сохраняются.
{% endhint %}

### Скрипт недоступен

Проверьте состояние выбранной лицензии, разрешение на скачивание, наличие сохранённого IP и доступ к установке для выбранного релиза.

| Причина                                                    | Что сделать                                                                                      |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Не подтверждён доступ через Google 2FA                     | Подтвердите доступ кодом приложения или активированным резервным кодом                           |
| Лицензия не активна или скачивание закрыто                 | Проверьте состояния в карточке; при ограничении передайте в поддержку домен и сообщение страницы |
| IP для установки не сохранён                               | Заполните поле «IP для установки» и нажмите «Сохранить IP»                                       |
| Установка из кабинета выключена или доступ к релизу закрыт | Передайте в поддержку номер релиза и сообщение страницы                                          |
| Комплект выбранного релиза ещё не готов                    | Дождитесь открытия доступа к установке этого релиза                                              |
| Код истёк или больше не доступен на странице               | Проверьте состояние сервера, затем создайте новый код                                            |

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

***

## Переход к установке продукта

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

Загрузите `iex-install.sh` на подготовленный сервер. По SSH перейдите в каталог с файлом, ограничьте права и запустите установку:

```bash
chmod 0600 ./iex-install.sh
sudo bash ./iex-install.sh
```

Команда запуска выполняется пользователем с полными правами `sudo`. При работе от `root` уберите `sudo`.

После запуска установка работает как служба. Закрытие SSH не останавливает её, поэтому при повторном подключении сначала проверьте состояние текущего процесса.

Полный порядок подготовки сервера, предварительной проверки, запуска, продолжения и приёмки приведён в разделе «Установка продукта».

{% content-ref url="/pages/P1dIXcZyZ6ZMrFbj8IzO" %}
[Установка продукта](https://docs.iexexchanger.com/ustanovka-i-obnovlenie/ustanovka-produkta.md)
{% endcontent-ref %}

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