Как подключить свой домен

Зачем нужен домен

Брендированный домен повышает доверие к ссылкам и делает URL понятнее для пользователя. Например, вместо системного домена можно использовать go.example.com.

[ТУТ СКРИНШОТ: экран добавления домена в разделе коротких ссылок]

Порядок действий

1. Откройте раздел доменов проекта.
2. Добавьте домен или поддомен.
3. Скопируйте TXT-токен подтверждения из CDP.
4. В DNS-панели создайте A-запись на IP сервера CDP.
5. Создайте TXT-запись с токеном подтверждения.
6. Дождитесь распространения DNS.
7. Запустите проверку домена в CDP.
8. После статуса ACTIVE назначьте домен default, если он должен использоваться по умолчанию.

Пример DNS:
A    go.example.com    203.0.113.10
TXT  go.example.com    cdp-project-shortlink-xxxxxxxx

Что означает default

Default-домен используется при создании новых коротких ссылок, если пользователь явно не выбрал другой домен. Статус ACTIVE сам по себе не всегда означает, что новые ссылки будут создаваться именно на этом домене.

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

• TXT добавлен на apex, а проверяется поддомен;
• DNS ещё не распространился;
• A-запись указывает не на сервер CDP;
• домен активен, но не назначен default;
• nginx не обновлён после добавления домена.

[ТУТ СКРИНШОТ: карточка домена со статусом ACTIVE и переключателем default]

Контрольный чек-лист

• Проверьте, что вы находитесь в правильном проекте, а не в соседнем тестовом проекте.
• Проверьте роль пользователя: часть кнопок видна только администратору.
• Откройте DevTools → Network и найдите запрос к /v1/....
• Скопируйте точный текст ошибки, HTTP-статус и время возникновения.
• Если операция связана с лимитом, откройте страницу лимитов до повторного запуска.

Что приложить к задаче разработчику

Чтобы проблему можно было быстро воспроизвести, приложите URL страницы, projectUuid, время ошибки, скриншот интерфейса, скриншот Network-запроса и архив логов. Для ошибок bootstrap отдельно проверьте, были ли в gateway.log не только GET, но и POST/PUT запросы.

[ТУТ СКРИНШОТ: Network-запрос с route, HTTP-статусом и response body]

Что именно решает эта статья

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

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ страницу коротких ссылок с формой создания, доменом, slug и статистикой переходов, при этом стрелками или рамками выделены главный раздел меню и основная кнопка действия]

Пошаговый сценарий

1. Откройте проект. Перейдите в рабочий проект CDP, потому что большинство действий привязаны к projectUuid и правам пользователя.
2. Найдите нужный раздел. Откройте пункт меню, который относится к теме статьи: Help.
3. Проверьте обязательные поля. Не запускайте действие, пока не заполнены поля, без которых система не сможет сохранить настройку или выполнить проверку.
4. Запустите действие. Нажмите основную кнопку создания, запуска, проверки или сохранения. Если кнопка неактивна, вернитесь к обязательным полям и правам доступа.
5. Проверьте результат. Убедитесь, что появилась карточка, строка в таблице, статус успешного выполнения или понятное сообщение об ошибке.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ модальное окно или форма из этой статьи, заполненные примерными корректными данными; обязательные поля отмечены рамками]

Как читать результат

Смотрите не только на общий статус. В CDP важны детали: дата запуска, пользователь, проект, статус обработки, текст ошибки, связанные сущности и действия, которые можно выполнить дальше. Если результат связан с лимитами тарифа, проверяйте страницу лимитов и сообщение 402. Если результат связан с внешним сервисом, проверяйте подключение, ключи и журнал выполнения.

• Успешный статус означает, что CDP приняла действие и сохранила результат.
• Предупреждение означает, что действие выполнено, но есть риск неполного результата или неправильной настройки.
• Ошибка требует исправления входных данных, прав доступа, лимита тарифа или внешнего подключения.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ готовый результат после выполнения действия: таблица, карточка или отчёт со статусом, датой, кнопкой открытия деталей и блоком ошибок]

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

• Действие запускают не в том проекте, поэтому данные не появляются там, где их ожидают.
• Пользователь не имеет нужной роли или доступа к проекту.
• Не заполнено обязательное поле, но пользователь пытается сохранить форму.
• Ожидается мгновенный результат там, где проверка или сбор данных выполняется асинхронно.
• Ошибка 402 воспринимается как техническая поломка, хотя чаще всего это лимит тарифа или неподключённая возможность.

Контрольный список перед обращением в поддержку

1. Сделайте скрин страницы с ошибкой и открытыми деталями.
2. Скопируйте точный текст ошибки и время возникновения.
3. Укажите projectUuid, если он отображается в адресе страницы.
4. Проверьте, повторяется ли проблема после обновления страницы.
5. Если проблема связана с файлом, отчётом или логами, скачайте файл результата и приложите его к задаче.