> For the complete documentation index, see [llms.txt](https://dexcore.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dexcore.gitbook.io/guide/dexcore-guide-ru/nastroika/installation/config-file.md).

# Файл конфигурации: настройка IMAP и доменов

{% hint style="info" %}
**Что такое IMAP?** IMAP (Internet Message Access Protocol) — это способ для программ читать письма с почтового сервера. DexCore использует IMAP для чтения OTP-кодов (одноразовых паролей), которые Outlook отправляет на ваши резервные почты. Без IMAP бот не может получать эти коды, и большинство функций не будут работать.
{% endhint %}

{% hint style="info" %}
**Что такое домен?** Домен — это часть после `@` в адресе электронной почты (например, `gmail.com` или `yourdomain.org`). Вы покупаете свой собственный домен, чтобы DexCore мог создавать на нём адреса резервной почты.
{% endhint %}

📖 **Руководства по настройке:** [Настройка Gmail](/guide/dexcore-guide-ru/nastroika/installation/config-file/gmail-setup.md) | [Покупка доменов](/guide/dexcore-guide-ru/nastroika/installation/config-file/buying-domains.md) | [Настройка доменов](/guide/dexcore-guide-ru/nastroika/installation/config-file/domains-setup.md) | [Пользовательский IMAP](/guide/dexcore-guide-ru/nastroika/installation/config-file/custom-imap.md)

***

## Перед началом

{% hint style="warning" %}
Убедитесь, что у вас есть:

1. Аккаунт Gmail (или другая почта с IMAP) — 👉 [Настройка Gmail](/guide/dexcore-guide-ru/nastroika/installation/config-file/gmail-setup.md)
2. Хотя бы один купленный домен — 👉 [Покупка доменов](/guide/dexcore-guide-ru/nastroika/installation/config-file/buying-domains.md)
3. Настроенный catch-all домена с пересылкой на ваш Gmail — 👉 [Настройка доменов](/guide/dexcore-guide-ru/nastroika/installation/config-file/domains-setup.md)
   {% endhint %}

***

## Как редактировать файл конфигурации

{% hint style="warning" %}
Используйте простой текстовый редактор, например **Блокнот** (встроен в Windows) или [Notepad++](https://notepad-plus-plus.org/). Текстовые процессоры (Word, Google Docs) добавляют скрытое форматирование, которое ломает JSON-файлы.
{% endhint %}

{% hint style="info" %}
**Краткий урок JSON:** Файл конфигурации использует **формат JSON**. Вот что нужно знать:

* Всё обёрнуто в **фигурные скобки** `{ }`
* Каждая настройка — это пара **"имя": "значение"**
* Текстовые значения заключаются в **двойные кавычки** `" "`
* Числа НЕ нуждаются в кавычках
* Каждая строка заканчивается **запятой** `,` КРОМЕ последней строки перед `}`
* **Одна пропущенная запятая или кавычка сломает весь файл**
  {% endhint %}

***

## Формат файла конфигурации

Добавьте следующие данные в файл конфигурации:

```json
{
  "email": "your email here",
  "password": "your password here",
  "domain": "your @domain here",
  "imapHost": "imap host here",
  "imapPort": porthere
}
```

### Что означает каждое поле

| Поле         | Что указать                                          | Пример                  |
| ------------ | ---------------------------------------------------- | ----------------------- |
| **email**    | Ваш адрес Gmail (или другой IMAP-почты)              | `"test@gmail.com"`      |
| **password** | Ваш **пароль приложения** (НЕ обычный пароль почты!) | `"czbv ghdg myvc ydmu"` |
| **domain**   | Ваш купленный домен, начиная с `@`                   | `"@domain.org"`         |
| **imapHost** | Адрес IMAP-сервера вашего почтового провайдера       | `"imap.gmail.com"`      |
| **imapPort** | Номер порта для IMAP (обычно `993`)                  | `993` (без кавычек!)    |

{% hint style="warning" %}
Gmail требует **пароль приложения** — обычный пароль не будет работать с IMAP. 👉 [Как его создать](/guide/dexcore-guide-ru/nastroika/installation/config-file/gmail-setup.md)
{% endhint %}

***

## Пример: настроенный IMAP (Gmail)

```json
{
  "email": "test@gmail.com",
  "password": "czbv ghdg myvc ydmu",
  "domain": "@domain.org",
  "imapHost": "imap.gmail.com",
  "imapPort": 993
}
```

{% hint style="success" %}
Обратите внимание: у `imapPort` число `993` **без кавычек**. Это правильно — порты — это числа, а не текст.
{% endhint %}

***

## Несколько IMAP-аккаунтов

Если у вас несколько доменов, подключённых к разным почтовым аккаунтам, добавьте их все как **массив** (список в квадратных скобках `[ ]`). Бот будет использовать все при генерации резервных почт:

```json
"IMAP": [
  {
    "email": "gmail1@gmail.com",
    "password": "aaaa bbbb cccc dddd",
    "domain": "@domain1.org",
    "imapHost": "imap.gmail.com",
    "imapPort": 993
  },
  {
    "email": "gmail2@gmail.com",
    "password": "eeee ffff gggg hhhh",
    "domain": "@domain2.net",
    "imapHost": "imap.gmail.com",
    "imapPort": 993
  }
]
```

{% hint style="warning" %}
При использовании нескольких IMAP-аккаунтов убедитесь, что каждая запись отделена **запятой** между `}` и `{`. Последняя запись НЕ должна иметь запятую после закрывающей `}`.
{% endhint %}

***

## Частые проблемы

{% hint style="warning" %}
Если бот не может прочитать файл конфигурации, проверьте:

* Использован обычный пароль Gmail вместо пароля приложения
* Файл отредактирован в Word/Google Docs (скрытое форматирование)
* Пропущены кавычки вокруг текста: `"email": test@gmail.com` — нужно `"test@gmail.com"`
* Кавычки вокруг порта: `"imapPort": "993"` — должно быть `993` без кавычек
* Пропущена запятая между строками или лишняя запятая после последней записи
* Пропущен `@` перед именем домена
  {% endhint %}