> 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.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/help-center/upravlenie-serverom/nastroika-dns-domena.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
