Orbit
Добавление пользовательского домена к вашему проекту
Every Orbit project serves on a free kaps.run address, and you can attach your own domains alongside it with an SSL certificate provisioned automatically. This guide covers adding a domain, the DNS…
Каждый проект Orbit обслуживается по бесплатному адресу kaps.run, и вы можете прикрепить свои собственные домены вместе с ним, при этом SSL-сертификат будет предоставлен автоматически. В этом руководстве рассказывается о добавлении домена, о записи DNS, которая вам нужна, о том, как читать состояния проверки, о выборе основного домена и о том, что проверить, если домен остаётся зависшим.
Перед началом работы
Вам нужен проект Orbit с хотя бы одним успешным развёртыванием, домен, для которого вы контролируете DNS, и план, включающий пользовательские домены. Пользовательские домены включены в Liftoff и Apex; бесплатный план Launch их не включает. Смотрите Лимиты плана Orbit.
Шаг 1: добавьте домен в Orbit
- Откройте ваш проект в Orbit.
- Откройте вкладку Domain или нажмите Manage domains из карточки Custom domains в Settings.
- В разделе Add a domain введите имя хоста, например
app.example.com. - Нажмите Add.
Введите простое имя хоста. Не включайте https://, косую черту в конце или путь: форма отклонит всё, что не является простым именем хоста, с сообщением "Enter a valid hostname like app.example.com".
Вы можете добавить до 25 доменов к проекту. Первый добавленный вами домен становится основным доменом.
Если домен уже прикреплён к другому проекту Orbit, Orbit его отклонит. Сначала удалите его из другого проекта.
Шаг 2: добавьте запись DNS
Orbit показывает панель DNS setup с точной записью для создания: CNAME с именем и значением для использования. Целевой объект одинаков независимо от того, кто размещает ваш DNS.
Если ваш домен использует Kapsule DNS
- Нажмите Domains на боковой панели KPanel.
- Нажмите ваш домен.
- В редакторе DNS добавьте запись CNAME, используя имя и значение, показанные на вкладке Domain в Orbit.
Если ваш домен использует другого провайдера DNS
Войдите к этому провайдеру и добавьте ту же запись CNAME. Интерфейс отличается, но тип записи, имя и значение остаются неизменными.
Доменные вершины (example.com без поддомена) не могут содержать простую CNAME по стандарту DNS. Многие провайдеры предлагают сглаживание CNAME или запись ALIAS или ANAME, которые достигают того же результата; используйте это, если ваш провайдер это поддерживает. Если нет, опубликуйте на поддомене, например www.example.com, и перенаправьте вершину на него у вашего провайдера DNS или регистратора.
Шаг 3: ожидайте проверки и SSL
Orbit проверяет DNS самостоятельно, и вкладка Domain показывает, на каком этапе вы находитесь:
| Что вы видите | Что это означает |
|---|---|
| Checking DNS… | Проверка выполняется прямо сейчас |
| CNAME not detected yet | Запись не распространилась или неправильна |
| CNAME verified: SSL provisioning… | Запись разрешена, сертификат выпускается |
| SSL active: CNAME verified | Домен активен и обслуживается по HTTPS |
Нажмите Re-check DNS для принудительной проверки вместо ожидания следующей автоматической.
Распространение DNS может занять от нескольких минут до нескольких часов в зависимости от TTL ваших старых записей. Сертификат выпускается в течение минуты или двух после обнаружения CNAME и автоматически обновляется, пока домен остаётся прикреплённым.
Перед добавлением записи снизьте TTL существующей записи для этого имени хоста и дождитесь истечения старого TTL. Переключение затем занимает минуты, а не часы. Это особенно важно, когда вы переносите живой хост, а не добавляете новый.
Выбор основного домена
Если прикреплено несколько доменов, один отмечен как Primary. Нажмите Set as primary domain на любом проверенном домене, чтобы изменить его. Основной домен является каноническим адресом проекта; остальные продолжают обслуживаться.
Удаление домена
Нажмите Remove domain на строке.
Удаление домена немедленно выводит его из обслуживания. Посетители перестают достигать ваш проект по этому имени хоста сразу же, и сертификат для него больше не поддерживается. Запись DNS у вашего провайдера не удаляется: удалите её сами после того, как она вам больше не понадобится, иначе она будет продолжать указывать на имя хоста, которое больше вам не отвечает.
Ваш проект продолжает обслуживаться по его адресу kaps.run независимо от этого.
SSL автоматический и бесплатный
Вы никогда не покупаете, не загружаете и не обновляете сертификат для домена Orbit. После разрешения CNAME сертификат выпускается, а затем автоматически обновляется. Нет экрана управления сертификатом, потому что нечего управлять.
Устранение неполадок
Зависает на "CNAME not detected yet".
- Проверьте тип записи. Запись A, указывающая на IP-адрес, не проверяется; это должна быть CNAME на значение, которое дал вам Orbit.
- Проверьте имя записи. Многие редакторы DNS добавляют зону за вас, поэтому ввод
app.example.comможет производитьapp.example.com.example.com. Введите простоapp, если редактор показывает зону как суффикс. - Проверьте конфликтующие записи. Существующая A, AAAA или CNAME с тем же именем будет иметь приоритет или сделает зону недействительной. Удалите её.
- Проверьте, что вы редактировали зону, которая на самом деле авторитетна. Если вы недавно переместили серверы имён, вы можете редактировать копию старого провайдера.
- Выждите TTL записи, которую вы заменили.
Проверено, но сертификат не активируется. Запись CAA на домене может предотвратить выпуск. Либо удалите её, либо добавьте запись, разрешающую центр сертификации, который использует Kapsule. Если вы не уверены, свяжитесь с поддержкой с названием домена.
"This domain is already attached to another project." Ровно то, что написано. Найдите другой проект Orbit и сначала удалите домен там.
"Domain limit reached." Вы находитесь на 25 доменах этого проекта. Удалите один, который вам больше не нужен.
Домен разрешается, но показывает неправильный сайт. Проверьте целевой символ CNAME символ за символом. Легко прикрепить домен к одному проекту и указать DNS на другой.
Дополнительное чтение
- Что такое Orbit? о том, как работает адрес
kaps.run - Настройка перенаправлений и переписей для отправки старых путей на новые после активации домена
- Лимиты плана Orbit для того, какие планы включают пользовательские домены