> 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/upravlenie-serverom/nastroika-dns-domena.md).

# Настройка DNS домена

{% hint style="warning" %}
Перед изменением DNS-записей убедитесь, что у вас есть доступ к панели управления доменом и указан правильный IP-адрес сервера.

Не удаляйте существующие почтовые записи (`MX`, `SPF`, `DKIM`, `DMARC`), если они уже используются. Их удаление может привести к прекращению работы корпоративной почты и потере важных писем.
{% endhint %}

### Что такое DNS и зачем он нужен

DNS — это система, которая связывает доменное имя с IP-адресом сервера.

Для работы iEXExchanger обычно используются два адреса:

```
ваш_домен
app.ваш_домен
```

Как правило:

```
ваш_домен — основной сайт обменного пункта (Frontend)
app.ваш_домен — Backend, API и административная панель
```

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

## Что нужно подготовить

Перед началом настройки подготовьте:

```
домен
IP-адрес сервера
доступ к DNS-панели регистратора или DNS-провайдера
основной домен
поддомен app
```

Пример:

```
Основной домен: example.com
Backend-домен: app.example.com
IP сервера: 123.123.123.123
```

***

## Где выполняется настройка

Настройка выполняется в панели управления DNS вашего регистратора домена или DNS-провайдера.

Например:

```
Cloudflare
Timeweb
REG.RU
Beget
GoDaddy
Namecheap
```

Если домен подключён к Cloudflare, все записи необходимо создавать именно в разделе DNS Cloudflare.

## Как работает схема DNS

В стандартной установке Frontend и Backend работают на одном сервере.

В этом случае достаточно создать три записи:

```
A       @      IP_сервера
A       app    IP_сервера
CNAME   www    ваш_домен
```

После применения DNS будут доступны:

```
https://ваш_домен
https://app.ваш_домен
https://www.ваш_домен
```

Если Frontend и Backend размещены на разных серверах, для каждого домена указывается свой IP-адрес.

***

## Пошаговая настройка

{% stepper %}
{% step %}

### Настройте основной домен

Создайте A-запись для основного домена.

Используйте следующие параметры:

```
Тип: A
Имя: @
Значение: IP сервера
TTL: Auto или 300
```

Пример:

```
A    @    123.123.123.123
```

Если панель управления не принимает символ `@`, оставьте поле имени пустым или укажите сам домен. Это зависит от используемого DNS-провайдера.
{% endstep %}

{% step %}

### Настройте поддомен app

Поддомен `app` используется для Backend, API и административной панели.

Создайте ещё одну A-запись:

```
Тип: A
Имя: app
Значение: IP сервера
TTL: Auto или 300
```

Пример:

```
A    app    123.123.123.123
```

После применения записи Backend будет доступен по адресу:

```
app.example.com
```

{% endstep %}

{% step %}

### Добавьте поддержку www

Если вы хотите, чтобы сайт открывался как с `www`, так и без него, создайте CNAME-запись.

Используйте следующие параметры:

```
Тип: CNAME
Имя: www
Значение: example.com
TTL: Auto или 300
```

Пример:

```
CNAME    www    example.com
```

Теперь адрес:

```
www.example.com
```

будет автоматически открывать основной сайт:

```
example.com
```

{% endstep %}

{% step %}

### Если Frontend и Backend находятся на разных серверах

Если клиентская часть и Backend работают на разных серверах, каждому домену необходимо указать собственный IP-адрес.

Пример:

```
A       @      111.111.111.111
A       app    222.222.222.222
CNAME   www    example.com
```

Где:

```
111.111.111.111 — сервер Frontend
222.222.222.222 — сервер Backend
```

{% endstep %}

{% step %}

### Когда использовать CNAME

CNAME используется только тогда, когда домен должен ссылаться на другой домен, а не на IP-адрес.

Хороший пример:

```
www.example.com → example.com
```

Запись выглядит так:

```
CNAME    www    example.com
```

Для поддомена `app` обычно рекомендуется использовать обычную A-запись.

Если Backend расположен на другом домене, можно использовать:

```
CNAME    app    backend.example-host.com
```

{% endstep %}

{% step %}

### Особенности использования CNAME

У записи CNAME есть несколько ограничений.

Нельзя одновременно создать A-запись и CNAME с одинаковым именем.

Неправильно:

```
A        app    123.123.123.123
CNAME    app    backend.example.com
```

Правильно использовать только одну запись.

Также стандартный DNS не позволяет использовать CNAME для корневого домена.

Поэтому для основного домена рекомендуется использовать обычную A-запись.
{% endstep %}

{% step %}

### Поддержка IPv6

Если сервер использует IPv6, можно добавить AAAA-записи.

Пример:

```
AAAA    @      IPv6_сервера
AAAA    app    IPv6_сервера
```

Если IPv6 ещё не настроен полностью, рекомендуется использовать только IPv4.

Для большинства установок достаточно следующих записей:

```
A    @      IPv4_сервера
A    app    IPv4_сервера
```

{% endstep %}

{% step %}

### Настройка при использовании Cloudflare

Если домен подключён к Cloudflare, записи создаются в разделе DNS Cloudflare.

Пример:

```
A       @      123.123.123.123
A       app    123.123.123.123
CNAME   www    example.com
```

Во время установки рекомендуется использовать режим:

```
DNS only
```

После настройки сервера, выпуска SSL-сертификатов и проверки работы сайта можно включить проксирование Cloudflare.

Для технического поддомена `app.ваш_домен` часто рекомендуется оставить режим `DNS only`, особенно если через него работают API, webhook, callback или административная панель.
{% endstep %}
{% endstepper %}

***

## Что проверить после настройки

После создания записей убедитесь, что работают следующие адреса:

```
ваш_домен
app.ваш_домен
www.ваш_домен
```

Также можно воспользоваться онлайн-проверкой DNS:

```
https://dnschecker.org/
https://www.whatsmydns.net/
```

Или проверить записи через терминал:

```bash
dig example.com
dig app.example.com
dig www.example.com
```

Ожидаемый результат:

```
example.com указывает на IP сервера
app.example.com указывает на IP сервера
www.example.com ведёт на example.com
```

## Сколько ждать применения DNS

Изменения применяются не мгновенно.

Обычно достаточно:

```
5–30 минут — при небольшом TTL
до 24 часов — при наличии старых записей
до 72 часов — в редких случаях
```

Если сайт пока не открывается, дождитесь распространения DNS и повторите проверку позже.

***

## Частые ошибки

<details>

<summary>Сайт не открывается</summary>

Чаще всего указан неправильный IP-адрес сервера или DNS ещё не успел обновиться.

Проверьте записи и дождитесь завершения распространения DNS.

</details>

<details>

<summary>Открывается только основной сайт</summary>

Обычно отсутствует запись для поддомена `app`.

Убедитесь, что создана отдельная A-запись:

```
A    app    IP_сервера
```

</details>

<details>

<summary>Не открывается адрес с www</summary>

Причина обычно заключается в отсутствии CNAME-записи.

Создайте запись:

```
CNAME    www    ваш_домен
```

</details>

<details>

<summary>Перестала работать почта</summary>

Вероятнее всего были удалены почтовые DNS-записи.

Проверьте наличие следующих записей:

```
MX
SPF
DKIM
DMARC
```

</details>

<details>

<summary>Одновременно используются A и CNAME</summary>

Для одного имени нельзя использовать оба типа записей одновременно.

Необходимо оставить только одну подходящую запись.

</details>

***

## Рекомендации

Используйте A-записи для основного домена и поддомена `app`, если у вас есть IP-адрес сервера.

Используйте CNAME только тогда, когда необходимо направить один домен на другой домен.

Не изменяйте почтовые записи без необходимости.

После завершения настройки DNS переходите к следующим этапам установки:

```
создание сайтов на сервере
настройка Nginx
выпуск SSL-сертификатов
настройка Backend
настройка Frontend
финальная проверка работы сайта
```

## Готовый пример

Для домена:

```
example.com
```

и сервера:

```
123.123.123.123
```

создайте следующие записи:

```
A       @      123.123.123.123
A       app    123.123.123.123
CNAME   www    example.com
```

Если используется IPv6, дополнительно можно создать:

```
AAAA    @      IPv6_сервера
AAAA    app    IPv6_сервера
```

***

## Коротко

Для стандартной установки iEXExchanger обычно достаточно создать две обязательные DNS-записи:

```
A    @      IP_сервера
A    app    IP_сервера
```

Для поддержки адреса с `www` рекомендуется дополнительно создать:

```
CNAME    www    ваш_домен
```

После применения DNS можно переходить к настройке сервера, Nginx, SSL-сертификатов и установке iEXExchanger.
