Документация ToolKitch
Как подключить свой домен к сайту ToolKitch
Собственный домен позволяет открывать размещённый сайт по вашему адресу, например qwe.ru. Посетитель видит этот адрес в браузере. Файлы остаются в проекте ToolKitch, а технический адрес вида qwe.site.toolkitch.ru сохраняется.
Если в настройках сайта доступно подключение своего домена, следуйте шагам ниже. Если вы видите «Пока недоступно», продолжайте пользоваться техническим адресом. Менять DNS пока не нужно: сначала дождитесь возможности начать подключение в настройках сайта.
Примеры qwe.ru и qwe.site.toolkitch.ru условные. IP-адреса и значения подтверждения берите из настроек своего сайта. Пароль регистратора, доступ к его кабинету и ключи DNS API ToolKitch для этого не нужны.
Короткий путь: шесть шагов
- Подготовьте сайт с index.html в корне, проверьте его на техническом адресе и сохраните копию файлов.
- Найдите действующую панель DNS вашего домена и сохраните прежние записи для выбранного имени.
- Откройте настройки сайта в проекте ToolKitch, раздел «Свой домен». Укажите qwe.ru без протокола и пути.
- Скопируйте выданные DNS-записи. Добавьте подтверждающую TXT и настройте адресные записи именно подключаемого имени у DNS-провайдера.
- Вернитесь в ToolKitch и нажмите «Проверить подключение». Дождитесь отдельно подтверждения владения, корректного DNS и готовности HTTPS.
- Убедитесь, что сайт опубликован. Откройте https://qwe.ru в отдельном браузере без авторизации, проверьте главную, внутренние ссылки и отсутствующий путь.
Если меняете адрес уже работающего сайта, сначала прочитайте разделы о сохранении DNS и возврате. Замена адресных записей переключает посетителей с прежнего сервера. Это действие затрагивает ваш реальный сайт даже тогда, когда подключение в ToolKitch ещё не завершено.
Что подготовить до подключения
Понадобятся принадлежащий вам домен, доступ к управлению его DNS и права владельца проекта ToolKitch. Совместный доступ к проекту сам по себе не даёт права подключать домен. Продление регистрации домена остаётся вашей задачей: сертификат HTTPS не продлевает регистрацию.
Сначала разместите готовые файлы по инструкции размещения . Для статического сайта загружайте результат сборки, а не исходники приложения. Главная страница должна называться index.html в нижнем регистре и лежать непосредственно в корне папки сайта. Сохраните структуру каталогов, изображения, стили и скрипты.
Собственный домен обслуживает публичный сайт. Подключение домена не публикует приватную папку автоматически. Перед публикацией проверьте содержимое всей папки: посетителям будут доступны и дополнительные файлы, включая будущие загрузки. Уберите пароли, личные документы и служебные данные. Приватный просмотр владельца остаётся на техническом адресе и не даёт посетителю доступ по собственному домену.
Проверьте существующее перенаправление сайта. Если в настройках включено «Перенаправлять на другой сайт», посетитель будет уходить на указанный HTTPS-адрес. Чтобы показывать загруженные файлы, отключите это перенаправление. Смена DNS не отменяет настройку перенаправления в ToolKitch.
Первое подключение рассчитано на одно точное имя. qwe.ru и www.qwe.ru считаются разными именами. Не создавайте второе имя и перенаправление по предположению: используйте только доступные настройки. Проксирование через внешний CDN в этом сценарии не поддерживается. Нужен прямой DNS-маршрут к адресам, указанным ToolKitch.
Где менять DNS и как сохранить прежнюю настройку
Регистратор продаёт и продлевает домен. Хостинг хранит сайт. DNS-провайдер публикует записи, по которым браузер находит сервер. Эти услуги могут находиться в одном кабинете или у трёх разных компаний. Изменения в панели прежнего хостинга не помогут, если действующие DNS обслуживаются другим провайдером.
В кабинете регистратора найдите сведения о DNS-серверах или NS. Они подсказывают, кто обслуживает зону. Затем откройте управление DNS у этого оператора и выберите нужный домен. Если не можете определить панель, обратитесь в поддержку регистратора с вопросом, где редактируется действующая зона. Не переключайте NS ради доступа к привычной панели: это меняет обслуживание всей зоны и может затронуть почту и другие сервисы.
До редактирования сделайте экспорт зоны, если панель позволяет, или сохраните отдельную копию существующих A, AAAA и CNAME выбранного имени. Запишите тип, полное имя, значение и TTL. Сделайте понятную заметку, какие записи добавили для ToolKitch, а какие заменили. Эта информация нужна для возврата прежнего размещения.
Не удаляйте DNS-зону целиком. Сохраните MX, SPF, DKIM, DMARC, NS и записи других имён. Проверочную TXT добавляйте отдельной записью, не заменяя существующие почтовые TXT. Изменять следует только записи, конфликтующие с подключением конкретного веб-имени, и добавляемое подтверждение владения.
У одного имени могут одновременно работать веб-сайт и почта. MX может указывать на самостоятельный почтовый сервер, но иногда его назначение или другие почтовые настройки зависят от адреса самого домена. Если видите такую зависимость, до изменения A/AAAA согласуйте перенос с оператором почты. Сохранение MX без проверки его назначения не гарантирует, что изменение общего IP не затронет почтовый сервис.
Какие записи вводить в панели DNS
После добавления домена найдите DNS-записи в его настройках. Если записи свёрнуты, раскройте их: текущий статус и основные действия находятся выше. Копируйте каждое поле отдельно: тип записи, имя и значение. Не берите адрес сервера из старого сообщения, чужого проекта или примера в статье. При переезде инфраструктуры значения могут измениться, поэтому источник точной инструкции для вашего подключения находится в настройках.
- A
- Направляет выбранное имя на IPv4-адрес сервера. Для корня qwe.ru многие панели используют имя @. В значение вводится только выданный IP, без https://, пробелов и пути.
- AAAA
- Направляет имя на IPv6. Добавляйте её только тогда, когда ToolKitch явно выдал IPv6-значение. Старая AAAA другого хостинга может отправлять часть посетителей на прежний сервер, даже если A уже правильная.
- TXT
- Подтверждает, что вы управляете DNS этого домена. Копируйте точное имя и выданный код. Эта запись добавляется отдельно и не подменяет SPF или другие проверки сервисов.
- CNAME
- Указывает имя на другое доменное имя. Может применяться для поддоменов в других сценариях. Одна CNAME на технический адрес не заменяет регистрацию своего домена в ToolKitch и выпуск сертификата. Для данного подключения следуйте выданным A/AAAA, не изобретайте собственную схему.
Обозначение @ означает корень выбранной зоны. Некоторые панели вместо него требуют пустое поле или полное имя qwe.ru. Проверьте подсказку оператора. Если панель сама дописывает окончание домена, ввод полного имени в поле, ожидающее короткую метку, может создать qwe.ru.qwe.ru. Для TXT действует та же осторожность: итоговое полное имя должно точно совпасть с показанным в ToolKitch.
Когда панель просит «Имя», «Хост» или «Поддомен», это имя DNS-записи, а не адрес сайта целиком. Не добавляйте https:// и косую черту. «Значение», «Данные» или «Назначение» содержат IP либо TXT-код в зависимости от выбранного типа. TTL описывает время хранения ответа в кеше. Если вы не управляете плановым переносом, используйте допустимое стандартное значение провайдера.
Не оставляйте одновременно старые и новые адреса для одного имени, рассчитывая, что браузер выберет правильный. Несколько A/AAAA могут распределять обращения между серверами. Если для выбранного имени настроена CNAME, панель может запретить добавление A/AAAA рядом с ней. Сначала сохраните старое значение и выясните конфликт, затем заменяйте только записи этого имени. Остальные поддомены менять не требуется.
Для www.qwe.ru имя в панели обычно выглядит как www, но это отдельное подключение. Запись для @ не распространяется автоматически на www. В текущем сценарии один сайт получает один собственный домен, поэтому сначала выберите нужное точное имя. Статья не обещает, что второе имя автоматически откроется или перенаправит посетителя.
После сохранения откройте запись повторно и сравните итоговое полное имя и значение с настройками ToolKitch. Проверочный TXT-код не нужно публиковать в обращениях или на скриншотах своего кабинета. Для примеров заменяйте его явной подписью «пример», а номер аккаунта и посторонние данные скрывайте.
Как понимать результат проверки DNS
Вернитесь в настройки сайта и нажмите «Проверить подключение». Проверка запускается в фоне: сообщение о принятом запросе означает, что проверка поставлена в очередь, а не что DNS уже подтверждён. Время последней завершённой проверки обновится после её окончания. Закрывать страницу можно: результат сохранится. Статусы на открытой странице обновляются автоматически. Пока действует ограничение частоты, дождитесь доступности повторной проверки. Не нажимайте кнопку непрерывно и не меняйте правильные записи из-за ожидания.
Подтверждение владения и направление трафика проверяются отдельно. Если TXT найден, но адресные записи неверны, домен ещё не готов. Если A правильная, а TXT отсутствует, одного направления трафика недостаточно для подключения к проекту. Так сервис предотвращает привязку домена человеком, который не может подтвердить управление им.
Статус ожидания не всегда требует ещё одного изменения. Часть DNS-ответов хранится в кеше. Новые значения могут быть видны у одного резолвера и ещё не видны у другого. Не существует универсального срока, после которого любое изменение обязательно сработает. Время зависит от прежних TTL, кешей и состояния провайдера. Не удаляйте и не создавайте записи заново только из-за ожидания.
Если домен или имя не найдено, проверьте написание, регистрацию домена и действующие NS. Если ответ содержит другой IP, сравните нужное имя, A, AAAA и возможную CNAME. Если DNS временно не отвечает, сохраните правильные записи и повторите проверку позднее. Временный сбой резолвера не доказывает, что нужно менять провайдера или удалять зону.
Если ToolKitch сообщает о занятом домене, проверьте другой собственный проект. Не пытайтесь обойти ограничение изменением регистра букв или добавлением точки. Для переноса между проектами отключите прежнюю привязку и подтвердите новую выданной TXT-записью. Старый код другого подключения повторно использовать нельзя.
ToolKitch повторно проверяет DNS после подключения. Если срок действующей проверки истёк, выдача по своему домену приостанавливается до нового подтверждения. Это может произойти и при сбое фоновой проверки. Сравните записи с настройками и нажмите «Проверить подключение». Не удаляйте правильные записи ради повторного запуска. Файлы сайта при этом сохраняются.
HTTPS, сертификат и продление
После подтверждения владения и DNS ToolKitch подготавливает маршрут и сертификат для точного доменного имени. HTTPS защищает соединение посетителя с сервером и позволяет браузеру проверить имя сервера. Сертификат технического поддомена не подходит автоматически для qwe.ru.
Статус «Настраиваем HTTPS» отличается от состояния DNS. Пока сертификат не готов, не считайте подключение завершённым и не предлагайте посетителю обходить предупреждение браузера. Статус «Домен подключён» появляется после проверки и действительного сертификата, и работающего маршрута к вашему сайту. Одного сертификата недостаточно. В настройках также указан срок его действия. Ориентируйтесь на результат завершённой проверки, а не на факт сохранения домена или принятия запроса в очередь.
Выпуск и продление выполняются сервером автоматически при работающем подключении и соблюдении условий удостоверяющего центра. Не требуется покупать сертификат у регистратора, загружать закрытый ключ в проект или сообщать пароль от DNS-панели. Не меняйте вручную служебные ACME-записи по совету, относящемуся к другому хостингу.
Если выпуск не завершается, проверьте, что DNS ведёт напрямую на выданные адреса, не включён внешний CDN или прокси и домен не истёк. Ограничивающая CAA-запись может запретить выбранному удостоверяющему центру выпуск. Не удаляйте CAA вслепую: передайте сообщение об ошибке администратору DNS и согласуйте разрешение нужного центра по его официальной инструкции.
Не пытайтесь ускорить выпуск постоянным отключением и повторным добавлением домена. У удостоверяющих центров есть ограничения на попытки и выдачу сертификатов. При временной ошибке сохраняйте корректные DNS, смотрите статус и повторяйте проверку после разрешённого ожидания. Если срок действующего сертификата приближается к концу, а ошибка сохраняется, обратитесь в поддержку с доменным именем, временем проверки и текстом ошибки без паролей.
Проверка HTTPS происходит до получения страницы сайта. При неправильном или истёкшем сертификате браузер может остановить соединение раньше ответа HTTP. В этом случае страница 404 не появится, и её изменение не исправит сертификат. Аналогично ToolKitch не может показать свою ошибку, если DNS уже направляет посетителя на посторонний сервер.
Главная страница, внутренние пути и настоящая 404
Адрес https://qwe.ru открывает главную страницу сайта. Не нужно добавлять /page к домену в настройках. Внутренние страницы продолжают использовать собственные пути, например /contacts.html. Домен не создаёт отсутствующий файл и не меняет структуру вашей сборки.
Если главная возвращает 404, проверьте публичный доступ, наличие index.html именно в корне и правильный регистр имени. Папка dist с вложенным dist/index.html не равна index.html в корне. Загрузите содержимое сборки в правильное место. Не публикуйте папку с личными файлами ради исправления пути.
Если главная работает, а внутренний адрес нет, сравните ссылку с реальным именем файла и каталогом. Учитывайте регистр букв и окончание .html. Для изображения или CSS проверьте относительный путь и то, что файл действительно загружен. Ссылки с прежним абсолютным доменом могут продолжать уводить на старый сайт, их нужно исправить в самих файлах.
Отсутствующий ресурс получает настоящий HTTP-статус 404. Если в корне публичного доступного сайта загружен 404.html, он используется для оформления такой ошибки. Сохраняйте в нём понятную ссылку на главную и проверяйте пути к стилям: страница ошибки может открываться по вложенному отсутствующему адресу. Без 404.html посетитель увидит общую страницу ошибки.
Пользовательская 404.html не показывается вместо проверки прав доступа. Закрытый, заблокированный или удалённый сайт получает общую страницу 404 без раскрытия причины. Служебные сбои БД или хранилища относятся к ошибкам сервера 5xx. Они не доказывают отсутствие файла, поэтому не требуют его повторной загрузки.
Автоматической подмены любого пути на index.html нет. У приложения с клиентской маршрутизацией главная может работать, а прямое открытие вложенного адреса давать 404. Подготовьте статический экспорт с реальными страницами либо используйте поддерживаемую вашей сборкой маршрутизацию через фрагмент адреса. Не считайте ответ 200 с текстом «Не найдено» правильной серверной 404.
Отключение, смена домена и возврат прежнего сайта
В настройках нажмите «Отключить домен» и подтвердите точное имя. Это отключает привязку, сохраняя проект и его файлы. Действие отличается от удаления сайта. После отключения прежняя ссылка на собственном домене больше не должна открывать файлы этого проекта.
ToolKitch не редактирует вашу DNS-зону. Если хотите вернуть прежний хостинг, восстановите сохранённые A/AAAA/CNAME именно выбранного имени в панели провайдера. Например, при отключении qwe.ru восстанавливайте сохранённые веб-записи qwe.ru, а не записи www.qwe.ru или почтового сервера. Не меняйте MX, почтовые TXT и NS ради отключения сайта. Удаляйте только добавленный проверочный TXT после завершения отключения, не затрагивая другие проверки. Восстановление записей тоже может быть видно разным посетителям в разное время из-за кешей.
Технический адрес сохраняется при подключении собственного домена, но сам по себе не возвращает прежний сайт на qwe.ru. Для возврата нужны и работающий прежний хостинг, и его DNS-значения, и подходящий HTTPS-сертификат. Проверьте результат отдельным браузером и не закрывайте старое размещение до завершения переноса.
Чтобы заменить собственный домен, сохраните нужные записи, отключите старую привязку и начните подключение нового имени. Получите новый TXT-код и пройдите проверки заново. Если переносите домен в другой проект ToolKitch, используйте данные из нового проекта. Истёкшая или прежняя проверка не подтверждает новое подключение.
При временном закрытии публичного доступа файлы сохраняются, а посетители получают общую 404 при доступном HTTPS. Не используйте отключение домена как обещание вечной страницы ошибки: после удаления маршрута, истечения сертификата или изменения DNS поведение соединения зависит от действующего размещения. Не оставляйте ненужные DNS-записи направленными на сервис.
Диагностика по симптомам
- В настройках нет доступного подключения
- Подключение пока недоступно. Пользуйтесь техническим адресом и инструкцией размещения. Сначала дождитесь возможности начать подключение в настройках, затем меняйте DNS.
- TXT не найден, хотя запись добавлена
- Проверьте действующую DNS-панель, полное имя записи и отсутствие удвоенного окончания домена. Сравните код целиком. Убедитесь, что редактировали TXT нужного подключения, затем повторите проверку с учётом кеша.
- IPv4 правильный, но открывается старый сайт
- Проверьте оставшуюся AAAA, несколько A, цепочку CNAME, кеш браузера и DNS. Сравните именно тот адрес, который введён в строке браузера: www и корень различаются.
- DNS подтверждён, но браузер предупреждает о сертификате
- Проверьте отдельный статус HTTPS. Не обходите предупреждение и не загружайте заново сайт. При ошибке CAA или ограничений выпуска используйте соответствующую рекомендацию выше.
- HTTPS работает, но страница отвечает 404
- Проверьте публичность, блокировку, корневой index.html и точный путь файла. Сначала сравните с техническим адресом, сохраняя различие между приватным просмотром владельца и обычным посещением.
- При открытии происходит переход на другой адрес
- Проверьте настройку перенаправления ToolKitch, затем перенаправления в HTML или JavaScript ваших файлов. DNS сам по себе не является HTTP-перенаправлением.
- После подключения перестала работать почта
- Сравните сохранённую зону с текущей, проверьте MX и почтовые TXT, а также адрес назначения MX. Обратитесь к оператору почты. Не восстанавливайте всю зону из чужого примера.
- Проверка временно недоступна или ограничена
- Сохраните значения, посмотрите время последней проверки и повторите позднее. Не создавайте новые привязки ради обхода ограничения. Для поддержки укажите домен и сообщение об ошибке без секретов.
Для обращения в поддержку подготовьте точное имя домена, видимый статус, время проверки и описание ожидаемого результата. На скриншоте оставьте только относящуюся к вопросу область. Не отправляйте пароль регистратора, коды входа, ключи API, закрытые ключи сертификата или полный экспорт зоны с посторонними проверками.
Вопросы и итоговая проверка
Нужно переносить домен к ToolKitch?
Нет. Регистрация и управление DNS остаются у ваших провайдеров. Вы меняете нужные записи самостоятельно, а ToolKitch проверяет их и связывает имя с сайтом.
Достаточно записи CNAME на технический поддомен?
Нет. Сервер должен знать собственный домен и иметь сертификат для него. Начинайте с настройки сайта, затем используйте выданные записи.
Можно подключить домен к приватной папке?
Собственный домен не предоставляет приватный просмотр. Проверьте файлы через технический адрес владельца, затем осознанно включите публичный доступ для посетителей.
Сколько ждать?
Проверяйте конкретный этап. Обновление DNS, подтверждение владения и выпуск HTTPS имеют разные причины задержки. Универсальное обещание «через несколько минут всё заработает» здесь было бы неточным.
Как убедиться, что всё готово?
Статус подключения активен, HTTPS не вызывает предупреждений, главная и нужные файлы открываются без входа в аккаунт. Отсутствующий путь возвращает 404, кнопка возврата на главную работает, почта и прочие поддомены продолжают работать. Вы сохранили прежние значения DNS и понимаете порядок отключения.
Какие документы помогут разобраться глубже?
Ниже официальные объяснения механизмов. Значения адресов, команды и настройки другого хостинга не переносите в ToolKitch. Источник точных DNS-данных вашего подключения находится в настройках сайта.
- Типы записей DNS: Cloudflare
- Принципы собственного домена: GitHub Pages
- Проверка доменов при выпуске HTTPS: Let’s Encrypt
Источники проверены 14 ноября 2026 года. Статья описывает порядок подключения при доступной функции. Доступность конкретного подключения и актуальные значения проверяйте в настройках вашего проекта.