> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Подключение собственного домена

> Используйте для ссылок QR-кодов свой поддомен, например qr.yourbrand.com, вместо общего короткого домена GetQR.

Подключите принадлежащий вам поддомен, например `qr.yourbrand.com`, чтобы новые QR-коды использовали ваш домен вместо общего короткого домена GetQR. При сканировании люди видят ваш бренд, а GetQR сам выпускает и продлевает HTTPS-сертификат.

> [!NOTE]
>
> Собственные домены находятся в бета-версии и пока могут быть доступны не во всех рабочих пространствах. Если в настройках учётной записи нет вкладки **Domains**, функция для вашего рабочего пространства не включена.

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

* Вам нужна роль **Admin** или **Editor**. Пользователь с ролью **Viewer** видит список доменов, но не может ничего изменить.
* Вам нужен доступ к настройкам DNS вашего домена у регистратора или DNS-провайдера (например, Cloudflare, GoDaddy, Namecheap или Squarespace). Если DNS управляет кто-то другой, во время настройки можно скачать для него точные значения.
* В одном рабочем пространстве можно подключить до 3 доменов.
* Подключается **поддомен**, а не корневой домен. `qr.yourbrand.com` подходит; `yourbrand.com` и `www.yourbrand.com` — нет. Ваш сайт и почта на корневом домене не затрагиваются.

## Подключение домена

**1. Откройте вкладку Domains**

На боковой панели откройте меню профиля и нажмите **My Account**. Затем выберите вкладку **Domains**.

**2. Начните настройку**

Нажмите **Connect a domain**.

> [!TIP]
>
> Начать можно и из конструктора QR-кодов: откройте раскрывающийся список доменов в поле **Custom short link** и нажмите **Connect a domain**.

**3. Выберите поддомен**

На экране **Choose a subdomain** выберите префикс: **qr**, **go**, **scan** или **link**. Чтобы использовать свой префикс, нажмите **Custom** и введите его в поле **Subdomain**.

**4. Введите корневой домен**

В поле **Your domain** введите только корневой домен, например `yourbrand.com`. GetQR автоматически проверит полное имя хоста и покажет **Checking availability…**.

**5. Убедитесь, что имя хоста доступно**

Дождитесь сообщения о том, что имя хоста доступно. Предпросмотр в разделе **Your codes will look like** показывает, как будут выглядеть ваши ссылки. Нажмите **Continue**.

**6. Скопируйте DNS-запись**

На экране **Add one DNS record** скопируйте значения **Name** и **Target** с помощью кнопок копирования. Тип записи всегда **CNAME**, а для **Proxy** должно быть установлено **DNS only — grey cloud**.

> [!TIP]
>
> Не управляете DNS сами? Нажмите **Download instructions**, чтобы получить файл с точными значениями для вашего разработчика или ИТ-отдела.

**7. Добавьте CNAME-запись у DNS-провайдера**

В новой вкладке откройте панель DNS-провайдера и добавьте одну CNAME-запись со скопированными **Name** и **Target**. Установите TTL на Auto (по умолчанию). См. [Советы по провайдерам](#provider-tips) ниже.

**8. Добавьте CAA-запись, если GetQR её запросит**

Если на экране настройки появилось предупреждение о CAA, у вашего корневого домена есть CAA-запись, которая блокирует центр сертификации GetQR. Добавьте дополнительную запись, указанную в предупреждении. Она выглядит так:

```text theme={null}
yourbrand.com. CAA 0 issue "letsencrypt.org"
```

Если предупреждения нет, пропустите этот шаг.

**9. Сообщите GetQR, что запись добавлена**

Вернитесь в GetQR и нажмите **I've added the record**. GetQR сразу проверит DNS и перейдёт к экрану проверки.

**10. Дождитесь проверки**

GetQR выполняет проверку автоматически и настраивает HTTPS. Проверка обычно занимает до 1 часа в зависимости от DNS-провайдера и региона. Окно можно закрыть: GetQR продолжит проверять и пришлёт письмо, когда домен заработает.

Чтобы проверить раньше, нажмите **Check now**.

**11. Протестируйте домен**

Когда домен заработает, вы увидите, что он доступен по HTTPS. Откройте тестовую ссылку (`your-subdomain/test`), чтобы убедиться, что она работает на вашем устройстве, затем нажмите **Done**.

## Советы по провайдерам

Названия полей у провайдеров немного различаются, но запись всегда одна и та же: одна запись **CNAME** с **Name** и **Target**, указанными в GetQR.

**Cloudflare**

1. Откройте DNS-записи корневого домена.
2. Добавьте запись типа **CNAME**.
3. Вставьте **Name** (например, `qr`) и **Target** из GetQR.
4. Отключите оранжевое облако, чтобы статус прокси был **DNS only**.
5. Сохраните запись.

> [!WARNING]
>
> Cloudflare по умолчанию проксирует новые записи. Пока запись проксируется (оранжевое облако), сертификат не может быть выпущен, и сканирования не работают.

**GoDaddy**

1. Откройте настройки DNS корневого домена.
2. Добавьте новую запись типа **CNAME**.
3. Введите **Name** из GetQR в поле имени (хоста), например `qr`.
4. Вставьте **Target** из GetQR в поле значения (points to).
5. Оставьте TTL по умолчанию и сохраните.

**Namecheap**

1. Откройте настройки DNS корневого домена.
2. Добавьте новую запись типа **CNAME**.
3. Введите **Name** из GetQR в поле хоста, например `qr`.
4. Вставьте **Target** из GetQR в поле значения (target).
5. Оставьте TTL на Automatic и сохраните.

**Google / Squarespace**

Домены, зарегистрированные в Google Domains, теперь обслуживаются Squarespace.

1. Откройте настройки DNS корневого домена.
2. Добавьте пользовательскую запись типа **CNAME**.
3. Введите **Name** из GetQR в поле хоста, например `qr`.
4. Вставьте **Target** из GetQR в поле данных (значения).
5. Сохраните запись.

> [!TIP]
>
> Большинство провайдеров автоматически добавляют корневой домен к имени. Вводите только часть с поддоменом (`qr`), а не `qr.yourbrand.com`, иначе может получиться `qr.yourbrand.com.yourbrand.com`.

## Использование домена в QR-кодах

Когда домен заработает, вы выбираете его для каждого QR-кода в конструкторе. В поле **Custom short link** откройте раскрывающийся список доменов и выберите свой домен. Домены, настройка которых ещё не завершена, отображаются в списке с меткой **Setting up** и пока не могут быть выбраны. См. [Создание собственной короткой ссылки](/ru/short-links/create-short-link).

> [!WARNING]
>
> QR-коды сохраняют домен, с которым были созданы. Существующие коды не переносятся на новый домен, а удаление домена останавливает сканирование всех QR-кодов на нём.

## Настройки

| Настройка | Что делает |
| - | - |
| **Subdomain** | Префикс имени хоста, например `qr`. Только буквы, цифры и дефисы. `www` не допускается. |
| **Your domain** | Ваш корневой домен, например `yourbrand.com`. Не указывайте здесь поддомен. |
| **Type** | Всегда **CNAME**. |
| **Name** | Метка поддомена, которую нужно ввести у DNS-провайдера. |
| **Target** | Имя хоста GetQR, на которое указывает ваша запись. Оно уникально для вашего домена, поэтому всегда копируйте его из приложения. |
| **Proxy** | Должно быть **DNS only — grey cloud**. Проксируемая запись блокирует выпуск сертификата. |

## Сценарии использования

* **Доверие к бренду.** При сканировании люди видят в предпросмотре ссылки `qr.yourbrand.com`, а не сторонний домен.
* **Кампании.** Сочетайте свой домен с собственной короткой ссылкой, например `qr.yourbrand.com/summer-menu`.
* **Мелкая печать.** Короткое имя хоста делает QR-код менее плотным, и он надёжнее сканируется при малых размерах.

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

> **Я не вижу вкладку Domains**
>
> Собственные домены находятся в бета-версии и включаются для каждого рабочего пространства отдельно. Если вкладки нет в настройках учётной записи, функция пока недоступна для вашего рабочего пространства.

> **Кнопка Connect a domain неактивна**
>
> В вашем рабочем пространстве уже 3 домена — это максимум. Удалите один, чтобы подключить другой. Если кнопки нет вовсе, у вас роль **Viewer**; обратитесь к пользователю с ролью Admin или Editor.

> **«Use a subdomain such as qr.yourbrand.com»**
>
> Вы ввели корневой домен. Для корневого домена нужна другая запись, и она повлияла бы на ваш сайт и почту. Выберите префикс поддомена и введите в **Your domain** только корневой домен.

> **«www is reserved for your website»**
>
> `www` указывает на ваш сайт, поэтому GetQR не может его использовать. Выберите другой префикс, например `qr`.

> **«already includes a subdomain»**
>
> Вы ввели поддомен в поле **Your domain**, например `qr.yourbrand.com`. Введите только корневой домен (`yourbrand.com`), а префикс выберите в **Subdomain**.

> **«This domain is already connected to another GetQR account»**
>
> Это имя хоста уже использует другое рабочее пространство GetQR. Выберите другой поддомен или напишите на [help@getqr.com](mailto:help@getqr.com), если считаете, что это ошибка.

> **«That domain can't be connected»**
>
> Имя хоста зарезервировано или не разрешено. Выберите другой поддомен.

> **Проверка занимает много времени**
>
> Изменения DNS могут распространяться какое-то время. Убедитесь, что тип, имя и цель записи точно совпадают с указанными в приложении и что запись не проксируется. Что означает каждый статус, см. в статье [Проверка домена](/ru/custom-domains/verify-and-troubleshoot).

## Что дальше

> **[Проверка домена](/ru/custom-domains/verify-and-troubleshoot)**
>
> Проверьте статус и устраните проблемы с DNS или сертификатом.

> **[Создание собственной короткой ссылки](/ru/short-links/create-short-link)**
>
> Используйте свой домен и собственный слаг в QR-коде.

> **[Роли и права доступа](/ru/members/roles-and-permissions)**
>
> Узнайте, кто может подключать и удалять домены.

> **[Печать QR-кода](/ru/downloads/printing)**
>
> Печатайте только после того, как домен заработает.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.