> 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/guide/podgotovka-k-ustanovke/obnovleniya/versiya-10.x/perekhod-na-10.0.0-s-9.x.md).
# Переход на 10.0.0 (с 9.x)
{% hint style="warning" %}
## Важное системное обновление: требуется переустановка
Если у вас установлена версия **9.2.2,** при переходе на новую версию потребуется **полная переустановка** обменника. Это связано с **масштабными изменениями** в структуре и логике работы системы.
**Основные изменения:**
* Новый модуль парсинга курсов
* Обновлённый калькулятор с переработанной логикой
* Повышенная производительность и устойчивость
* Изменения в конфигурации и требованиях к серверу
* Разделение проекта на две части:
* **Основной домен —** только для клиентской части (обмен)
* **Поддомен —** для админ-панели и API
Это решение принято для повышения безопасности, ускорения загрузки и масштабируемости системы.
**Что необходимо сделать:**
1. Выполнить переустановку обменника
2. Настроить основной домен и поддомен по новой структуре
3. После установки — проверить работу интерфейса и функциональности
**❗ Важно: поведение системы после обновления может отличаться от прежней версии — это связано с внутренними архитектурными изменениями.**
Внизу страницы вы найдёте инструкцию по созданию резервной копии сайта и базы данных перед обновлением.
Мы настоятельно рекомендуем выполнить резервное копирование перед началом любых действий.
***Если потребуется помощь —** обратитесь в техническую поддержку. Мы подскажем, как правильно перейти на новую версию.*
{% endhint %}
{% hint style="danger" %}
## Резервное копирование перед обновлением
Перед обновлением сайта или изменением настроек рекомендуется создать полную резервную копию.
**Что нужно сохранить:**
* Все файлы сайта (включая публичную часть, конфигурации, .env и другие важные директории)
* Базу данных MySQL, связанную с сайтом
**Как сделать резервную копию:**
**🔹 Через FastPanel:**
* В разделе **«Файловый менеджер»** скачайте директорию сайта
* В разделе **«Базы данных»** выберите нужную базу и выполните экспорт в формате .sql
**🔹 Через FTP и phpMyAdmin:**
* Скачайте все файлы сайта через FTP (например, FileZilla)
* В phpMyAdmin выберите базу данных → вкладка «Экспорт»
\
*Либо **обратитесь в техническую поддержку** — они могут создать резервную копию за вас.*
**💡 Рекомендация:** храните резервные копии локально (на компьютере или в облаке) — это поможет быстро восстановить сайт в случае непредвиденных ошибок.
{% endhint %}
{% content-ref url="/spaces/BKBngbC2uqpFyMskVn39/pages/4P0gTZJnutJcTi7U9FdO" %}
[Как создать Backup?](/dev-help/faq/kak-sozdat-backup.md)
{% endcontent-ref %}
***
## Ознакомьтесь со списком изменений новой версии
Перед тем как выполнить обновление на новую версию, внимательно ознакомьтесь со всеми изменениями и улучшениями, которые реализованы в новой версии обменника iEXExchanger. Это поможет вам заранее понять, что именно изменится в логике работы и интерфейсе, и подготовиться к ним.
#### Почему важно ознакомиться со списком изменений?
* Предотвратить возможные проблемы или недоразумения после обновления.
* Понимать, как новые функции и изменения могут повлиять на работу вашего проекта.
* Упростить процесс адаптации команды и пользователей к новой версии обменника.
{% hint style="warning" %}
## Внимание
Если вы начнёте обновление, не ознакомившись с изменениями, это может привести к неожиданным результатам или дополнительным сложностям в работе после установки новой версии.
{% endhint %}
{% content-ref url="/pages/60mSj15UXeVxnuNiz5n3" %}
[Broken mention](broken://pages/60mSj15UXeVxnuNiz5n3)
{% endcontent-ref %}
После того как вы ознакомитесь со всеми изменениями и будете готовы, переходите обратно к финальному этапу проверки и начните установку.
***
## Проверьте готовность к обновлению
Эта инструкция поможет вам убедиться, что вы полностью готовы перейти на новую версию обменника. Поскольку в новой версии присутствуют значительные изменения в логике работы, структуре и настройках системы, очень важно убедиться, что вы выполнили все подготовительные шаги правильно.
Пожалуйста, внимательно проверьте каждый пункт ниже, чтобы гарантировать, что процесс переустановки пройдёт гладко и без ошибок. Если какой-либо из пунктов вызывает сомнение или вопросы — рекомендуем обратиться в техническую поддержку перед началом установки.
### Шаг 1: Подготовка и переход на новый сервис
Новая версия **iEXExchanger** построена на принципиально новой архитектуре. Это означает, что текущий обменник версии **9.2.2** будет полностью заменён.
**Проверьте, что:**
* Вы ознакомились с общей информацией о новой архитектуре обменника.
* Вы понимаете, что после обновления логика работы и интерфейс изменятся.
* У вас нет вопросов или сомнений по новой архитектуре.
**Итого:** вы полностью готовы перейти на новый сервис обменника.
{% hint style="info" %}
Если у вас возникли вопросы по новой архитектуре, рекомендуем обратиться в техническую поддержку до начала установки.
{% endhint %}
### Шаг 2: Подготовка поддомена и DNS-записей
В новой версии сайт будет разделён на две логические части для повышения безопасности, скорости и удобства управления.
* **Основной домен (ваш\_домен)** — клиентская часть обменника.
* **Поддомен (app.ваш\_домен)** — административная панель и API.
На текущем этапе вам нужно убедиться, что:
* Поддомен (**app.****ваш\_домен**) уже добавлен в DNS через Cloudflare.
* DNS-записи для поддомена и основного домена корректно настроены и указывают на ваш сервер.
**Итого:** DNS полностью настроен, и поддомен готов к дальнейшему использованию.
### Шаг 3: Проверка резервных копий
Обязательно убедитесь, что у вас созданы резервные копии:
* Резервная копия файлов сайта сохранена.
* Резервная копия базы данных MySQL сохранена.
* Вы проверили, что резервные копии доступны и корректны.
**Итого:** резервные копии созданы и надёжно сохранены.
{% hint style="warning" %}
Подробная инструкция по созданию резервных копий находится выше на этой странице.
{% endhint %}
### Шаг 4: Ознакомление с инструкцией по установке
Перед началом установки убедитесь, что вы изучили инструкцию на следующем шаге:
* Вы прочитали инструкцию по установке новой версии.
* Сервер соответствует указанным системным требованиям.
* Доступы к серверу и панели управления подготовлены.
Если у вас есть вопросы по установке — обратитесь в техническую поддержку.
**Итого:** вы знаете и понимаете процесс установки новой версии.
### Шаг 5: Настройки .env
Проверьте ваш .env файл
```
API_URL=https://app.ваш_домен
CORS_ALLOWED_ORIGINS=https://ваш_домен,https://app.ваш_домен
FRONTEND_URL=https://ваш_домен
CORS_SUPPORTS_CREDENTIALS=true
SESSION_DRIVER=database
SESSION_DOMAIN=.ваш_домен
SANCTUM_STATEFUL_DOMAINS=https://app.ваш_домен
SESSION_SECURE_COOKIE=false
REDIS_CLIENT=phpredis
```
### Шаг 6: Восстановить проект из backup на новом сервере
После создания нового сервера:
1. Загрузите архив backup на сервер и распакуйте его в поддомене.
2. После распаковки удалите все папки и файлы, кроме папок **public** и **storage**.
3. Затем загрузите новую версию проекта и разместите её рядом с оставшимися папками **public** и **storage**.
4. После этого восстановите базу данных из файла резервной копии — обычно это файл с названием вроде backup.sql. Его нужно импортировать в новую базу данных через панель управления сервером (например, phpMyAdmin).
### Финальный шаг: Начало установки
Теперь вы полностью готовы перейти к установке новой версии обменника:
{% content-ref url="/pages/9Gj8u2DM0tadJlJ3aL7F" %}
[Broken mention](broken://pages/9Gj8u2DM0tadJlJ3aL7F)
{% endcontent-ref %}
{% hint style="danger" %}
## Внимание
Если после завершения установки ваша конфигурация не загрузилась, перенесите файл `/storage/iex-config.json` в папку **`/storage/app`** на сервере.
{% endhint %}
## Нужна помощь?
Если возникли сложности или вопросы по любому из шагов, свяжитесь с технической поддержкой. Мы поможем вам пройти установку максимально комфортно и безопасно.
---
# 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:
```
GET https://docs.iexexchanger.com/guide/podgotovka-k-ustanovke/obnovleniya/versiya-10.x/perekhod-na-10.0.0-s-9.x.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.