Kaiten

Документация и инструкции

Log in

Как настроить собственный домен для Справочного центра

Справочный центр по умолчанию открывается по стандартной ссылке вида mycompany.kaiten.site. Вы можете подключить собственный домен, например, docs.mycompany.ru и сайт будет открываться по адресу вашего бренда. SSL-сертификат для нового адреса выпускается и продлевается автоматически и бесплатно.

Функция доступна только в облачной версии Kaiten. В серверной поставке подключить собственный домен для Справочного центра пока нельзя.

Что понадобится

  • платный тариф — Старт, Стандарт или Бизнес;

  • свой домен и доступ к его DNS-записям у регистратора;

  • права администратора папки, к которой привязан Справочный центр.

Важно: подключить можно только домен с поддоменом — docs.mycompany.ru, www.mycompany.ru, help.mycompany.ru. Корневой домен (mycompany.ru без поддомена) подключить нельзя — так работает протокол DNS. Если хотите, чтобы сайт открывался и по корневому адресу, настройте у регистратора переадресацию с mycompany.ru на подключенный поддомен. Если не знаете, какой поддомен выбрать, используйте www — тогда адрес будет выглядеть привычно для посетителей.

Шаг 1. Добавьте домен в Кайтене

  1. Откройте папку со Справочным центром.

  2. Нажмите на значок шестеренки справа — откроются «Настройки».

  3. Нажмите «Настроить».

  4. В окне «Настроить Справочный центр», на вкладке «Основные настройки», в блоке «Ссылка на сайт» выберите «Пользовательская».

  5. В поле «Полное имя домена» введите домен целиком, например www.mycompany.ru, и нажмите «Далее».

После этого Kaiten покажет две DNS-записи, которые нужно добавить у регистратора домена:

  • TXT — подтверждает, что домен принадлежит вам;

  • CNAME — связывает домен со Справочным центром.

Используйте кнопку копирования рядом со значением. Так вы избежите ошибок при вводе.

Шаг 2. Добавьте записи у DNS-провайдера

Кайтен показывает тип, имя и значение каждой записи:

Тип

Имя

Значение

TXT

_kaiten-verification.www

код из интерфейса Кайтена

CNAME

www

external.kaiten.site.

Копируйте имя и значение кнопкой рядом с полем, чтобы исключить опечатки.

Способ добавления записей зависит от регистратора. Ниже показан пример для REG.RU. Инструкции для других регистраторов появятся позже.

Пример: настройка в панели REG.RU (Per.py)

  1. Перейдите в раздел управления нужным доменом.

  2. Откройте настройки DNS-зоны.

  3. Нажмите Добавить запись.

  4. Добавьте TXT-запись

    При создании записи используйте значения, которые показал Kaiten.

    • Тип — TXT.

    • Имя (Subdomain) — значение из поля Имя.

    • Значение — значение из поля Значение.

    Сохраните запись.

  5. Добавьте CNAME-запись

    Создайте еще одну запись.

    • Тип — CNAME.

    • Имя (Subdomain) — значение из поля Имя.

    • Canonical name — значение из поля Значение.

    Сохраните запись.

    Некоторые регистраторы автоматически добавляют точку в конце значения CNAME. Если поле не принимает значение с точкой, удалите ее и сохраните запись.

Если домен обслуживает Cloudflare

Отключите проксирование для CNAME-записи — переключите ее в режим «DNS only» (серая иконка вместо оранжевой). Пока включен прокси, домен не пройдет проверку и сертификат не выпустится.

Совет для доменов с историей

Если на домене раньше уже были прописаны другие записи, уменьшите TTL до 300–600 секунд на время настройки — изменения применятся быстрее. Для нового домена это не обязательно.

Шаг 3. Проверьте домен

Вернитесь в Kaiten в настройки Справочного центра и нажмите Проверить.

Изменения DNS-записей применяются не сразу. Обычно это занимает от 10 минут до 24 часов. Если проверка не прошла сразу, подождите и попробуйте снова. Проверять можно не чаще одного раза в 10 минут.

После успешной проверки статус изменится на Выпускаем SSL-сертификат. Обычно сертификат выпускается за несколько минут, но иногда процесс может занять несколько часов.

Когда настройка завершится, статус изменится на Домен активен. После этого Справочный центр начнет открываться по вашему адресу. Откройте свой домен в браузере и убедитесь, что сайт работает.

Если проверка не проходит

Под кнопкой «Проверить» будет показана причина:

Сообщение

Что проверить

TXT-запись не найдена

Запись еще не применилась — подождите. Или имя указано неверно: сверьте с полем «Имя» в Кайтене. Частая ошибка — панель регистратора добавляет окончание домена второй раз

TXT-запись найдена, но значение не совпадает

В DNS осталось значение от прошлой попытки — замените на актуальный код из интерфейса

CNAME-запись не найдена

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

CNAME-запись указывает на другой адрес

Значение должно быть ровно external.kaiten.site. Если используете Cloudflare, отключите проксирование

Вместо CNAME настроена запись другого типа

У поддомена уже есть A-запись или другая — удалите ее: у одного имени не может быть CNAME вместе с записью другого типа

Не удалось получить ответ от DNS

Временная проблема — попробуйте через несколько минут

Домен проверяли меньше 10 минут назад

Ограничение защищает от устаревших DNS-кэшей — подождите и запустите проверку снова

Что будет, если тариф закончится

Если аккаунт перейдет на бесплатный тариф, сайт по пользовательскому домену перестанет открываться и покажет требование о платном тарифе. Автоматического переключения на стандартную ссылку нет — переключите вариант на «Стандартная» вручную в настройках Справочного центра.

Переключение между адресами

Даже после подключения собственного домена стандартная ссылка company.kaiten.site продолжает работать.

В настройках Справочного центра можно в любой момент выбрать, какой адрес использовать:

  • Стандартная — ссылка вида company.kaiten.site;

  • Пользовательская — ваш собственный домен.

Если собственный домен перестанет работать, например закончится срок его регистрации, вы сможете переключиться обратно на стандартную ссылку.

Как отключить домен

В настройках Справочного центра нажмите на значок корзины рядом с доменом и подтвердите удаление. Сайт останется доступен по стандартной ссылке. Также удалите TXT- и CNAME-записи у регистратора — они больше не нужны.

Если подключаете тот же домен заново, Кайтен выдаст новый код для TXT-записи — обновите значение у регистратора.

Полезные статьи


Didn't find the answer to your question?

Create a request — we'll help you out

Submit a request