> 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/help-center/reshenie-problem/diagnostika/diagnostika-i-ustranenie-oshibok.md).

# Диагностика и устранение ошибок

В этом разделе собрана полезная информация, которая поможет быстро разобраться с возможными неполадками, улучшить работу сервера и базы данных, а также избежать простоев. Материал будет полезен как администраторам, так и обычным пользователям — объяснения даны простыми словами, а инструкции позволяют выполнить действия без глубоких технических знаний.

## Общие рекомендации по оптимизации сервера и базы данных

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

{% stepper %}
{% step %}

### Увеличьте мощность сервера

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

{% step %}

### Проверьте настройки и нагрузку

Сервер может замедляться из-за ненужных фоновых процессов. Проверьте, нет ли запущенных задач, которые не используются, и отключите их. Также убедитесь, что настройки сервера и базы данных оптимальны для вашей конфигурации — это может значительно повысить производительность.
{% endstep %}

{% step %}

### Следите за производительностью

Используйте программы для мониторинга сервера. Они помогут выявить, где именно возникает замедление — в процессоре, памяти, диске или базе данных — и вовремя устранить причину.
{% endstep %}

{% step %}

### Экспериментируйте с настройками

Иногда простое изменение параметров или увеличение ресурсов даёт заметный прирост скорости. Меняйте настройки постепенно и проверяйте результат, чтобы избежать сбоев.
{% endstep %}

{% step %}

### Делайте резервные копии

Регулярно сохраняйте резервные копии базы данных и файлов сайта. Это защитит вас от потери информации при сбоях, ошибках или атаках.
{% endstep %}
{% endstepper %}

Следуя этим советам, вы сможете сделать работу сайта стабильнее, ускорить обработку запросов и снизить риск непредвиденных проблем. Если есть сомнения в настройках, лучше обратиться к опытному системному администратору.

***

## Частые проблемы и способы их решения

Во время работы системы могут появляться ошибки, которые мешают корректной работе. Здесь приведены самые распространённые ситуации и их решения, чтобы вы могли быстро восстановить работу сервиса без длительных простоев и лишнего обращения в поддержку<br>

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

<details>

<summary>Решение проблемы бесконечной загрузки страницы в настройках личного кабинета</summary>

Если при открытии настроек личного кабинета страница загружается бесконечно, а вы используете Cloudflare, это может быть связано с отсутствием корректно настроенного SSL-сертификата на старте работы обменника. В такой ситуации необходимо установить и правильно настроить SSL, чтобы соединение было защищённым и корректно обрабатывалось как сервером, так и Cloudflare.

* В панели Cloudflare откройте настройки домена, перейдите в раздел SSL/TLS и установите режим [Full или Full (Strict)](broken://pages/j2tmwQ7JYINjh17vm9zr).

</details>

<details>

<summary>После обновления система показывает ошибку 500</summary>

Если после обновления скрипта до последней версии сайт зависает или выдаёт ошибку 500, это чаще всего связано с накопившимися или повреждёнными лог-файлами, поэтому необходимо подключиться к серверу через SSH или файловый менеджер хостинга, открыть папку `/storage/logs`, удалить из неё все файлы, после чего перезагрузить сервер или перезапустить веб-сервер (Apache/Nginx), чтобы очистить кэш ошибок и восстановить корректную работу системы.

</details>

<details>

<summary>Ошибка «LOADING Redis is loading the dataset in memory»: причины и безопасное устранение</summary>

Ошибка **«LOADING Redis is loading the dataset in memory»** означает, что Redis загружает данные из RDB или AOF-файла в память и временно не принимает команды, кроме диагностических. Обычно процесс завершается за **10–60 секунд** после перезапуска, но если сообщение остаётся дольше или Redis завис, это может указывать на повреждённые файлы данных, нехватку оперативной памяти, проблемы с диском или неверную конфигурацию.

Если Redis используется только как кэш и потеря данных не критична, подключитесь к серверу через PuTTY под <mark style="color:green;">пользователем</mark> **root** или используйте встроенный терминал macOS, затем выполните следующие команды:

* `redis-cli FLUSHDB` — очистка текущей базы.
* `redis-cli FLUSHDB ASYNC` — асинхронная очистка текущей базы.
* `redis-cli -n DB_NUMBER FLUSHDB` — очистка конкретной базы с указанным номером.
* `redis-cli -n DB_NUMBER FLUSHDB ASYNC` — асинхронная очистка конкретной базы.
* `redis-cli FLUSHALL` — очистка всех баз.
* `redis-cli FLUSHALL ASYNC` — асинхронная очистка всех баз.
* `reboot` — перезагрузка сервера.

Если Redis хранит критичные данные, например сессии или очереди Laravel, очистка приведёт к их потере. В таком случае сначала изучите логи `/var/log/redis/redis-server.log`, проверьте состояние загрузки командой `redis-cli INFO persistence | grep loading` и убедитесь, что удаление данных безопасно.

</details>

<details>

<summary>Восстановление доступа при утере Google Authenticator</summary>

Если вы потеряли доступ к **Google Authenticator** — например, случайно удалили приложение, сбросили телефон или утратили ключ подключения — вход в систему с включённой двухфакторной аутентификацией станет невозможен. Чтобы восстановить доступ через **FastPanel**, выполните следующие шаги:

1. Войдите в FastPanel и откройте файловый менеджер нужного сайта.
2. Перейдите в папку: `/storage/app`
3. Найдите файл `iex-config.json` и откройте его для редактирования.
4. Внутри файла найдите параметр: `"is_google_auth": 1`
5. Измените значение 1 на 0, чтобы временно отключить Google Authenticator: `"is_google_auth": 0`
6. Сохраните изменения и закройте редактор.
7. Повторите попытку входа в систему — теперь проверка через Google Authenticator будет отключена.
8. После входа в панель управления снова включите и настройте Google Authenticator для защиты аккаунта.

</details>

<details>

<summary>Не открывается сайт из РФ: как отключить ECH в Cloudflare</summary>

#### Причина проблемы

{% hint style="info" %}

#### Причина проблемы

Роскомнадзор начал блокировать сайты, использующие **Cloudflare** с включённой технологией **Encrypted Client Hello (ECH)**.

ECH скрывает, к какому сайту идёт подключение, но из-за этого сайты становятся недоступны для части пользователей в РФ.<br>

**Решение** — отключить ECH для вашего домена в настройках Cloudflare или через API. Это не всегда гарантирует доступ, но в большинстве случаев помогает.
{% endhint %}

### Проверяем, включён ли ECH

Откройте в браузере: `https://dns.google.com/query?name=example.com&type=HTTPS`

{% hint style="info" %}

## Замените example.com на свой домен.

Если в ответе есть ech=, значит ECH включён и его нужно отключить.
{% endhint %}

### Как отключить ECH?

#### Вариант 1 — платный тариф Cloudflare (Pro, Business, Enterprise)

1. Войдите в Cloudflare.
2. Выберите свой сайт.
3. Перейдите в **SSL/TLS → Edge Certificates.**
4. Найдите **Encrypted Client Hello (ECH)** и переведите в состояние **Off**.

#### Вариант 2 — бесплатный тариф Cloudflare (Free Plan)

На бесплатных тарифах отключение ECH возможно только через API.

**Что понадобится:**

* **E-mail** от аккаунта **Cloudflare**.
* **Global API Key** (получить можно в [профиле Cloudflare](https://dash.cloudflare.com/profile/api-tokens)).
* **Zone ID** (найдите на странице с настройками домена в Cloudflare).
* **curl** (инструмент для отправки HTTP-запросов).

Пример команды для Linux / macOS:

```bash
curl -X PATCH "https://api.cloudflare.com/client/v4/zones/{ZONE_ID}/settings/ech" \
     -H "X-Auth-Email: {ACCOUNT_EMAIL}" \
     -H "X-Auth-Key: {GLOBAL_API_KEY}" \
     -H "Content-Type: application/json" \
     --data '{"id":"ech","value":"off"}'
```

Пример для Windows CMD:

```bash
curl -X PATCH "https://api.cloudflare.com/client/v4/zones/{ZONE_ID}/settings/ech" ^
     -H "X-Auth-Email: {ACCOUNT_EMAIL}" ^
     -H "X-Auth-Key: {GLOBAL_API_KEY}" ^
     -H "Content-Type: application/json" ^
     --data "{\"id\":\"ech\",\"value\":\"off\"}"
```

После успешного выполнения вы получите ответ:

```json
{"result":{"id":"ech","value":"off"},"success":true,"errors":[],"messages":[]}
```

#### Вариант 3 — через Postman

1. Создайте новый запрос PATCH на адрес: `https://api.cloudflare.com/client/v4/zones/{ZONE_ID}/settings/ech`
2. В Headers добавьте:
   * X-Auth-Email — ваш e-mail в Cloudflare.
   * X-Auth-Key — Global API Key.
   * Content-Type — application/json.
3. В **Body → raw** вставьте: `{"id": "ech", "value": "off"}`
4. Нажмите Send.

### После отключения ECH

* Очистите кэш Cloudflare (в разделе **Caching → Purge Everything**).
* Очистите кэш браузера.
* Проверьте доступ к сайту из РФ.

</details>

<details>

<summary>Шпаргалка по настройке DNS-записей для работы почты на домене</summary>

Чтобы почта корректно отправлялась и не попадала в спам, необходимо правильно настроить ключевые DNS-записи — SPF, DKIM, DMARC, MX и PTR. Подробное объяснение этих записей, примеры и рекомендации по настройке можно найти в статье:

<https://www.netmeister.org/blog/email-dns-records.html>

</details>
