Пользователи с разрешениями администратора для репозитория могут настроить личный домен для сайта GitHub Pages.
Сведения о конфигурации личного домена
Прежде чем настраивать личный домен с помощью поставщика DNS, добавьте личный домен на сайт GitHub Pages. Настройка личного домена с помощью поставщика DNS без добавления личного домена в GitHub Enterprise Cloud может привести к тому, что другой пользователь сможет разместить сайт на одном из поддоменов.
Команда dig
, которую можно использовать для проверки правильности конфигурации записей DNS, не включена в Windows. Прежде чем проверять правильность настройки записей DNS, необходимо установить BIND.
Примечание. Распространение изменений DNS может занять до 24 часов.
Настройка поддомена
Чтобы настроить www
или личный поддомен, например www.example.com
или blog.example.com
, необходимо добавить домен в параметры репозитория. После этого с помощью поставщика DNS настройте запись CNAME.
-
В GitHub Enterprise Cloudперейдите в репозиторий сайта. 1. Нажмите Параметры под именем репозитория.
-
В разделе «Код и автоматизация» на боковой панели щелкните Страницы .
-
В поле "Личный домен" укажите личный домен и нажмите Сохранить. Если публикация выполняется из ветви, будет создана фиксация, которая добавляет файл
CNAME
в корень исходной ветви. Если публикация выполняется с помощью пользовательского рабочего процесса GitHub Actions, файлCNAME
не создается. Дополнительные сведения об источнике публикации см. в статье "Настройка источника публикации для сайта GitHub Pages".Примечание: Если личный домен является интернационализированным доменным именем, необходимо ввести версию в кодировке Punycode.
Дополнительные сведения о Punycodes см. в разделе Имя международного домена.
-
Перейдите к поставщику DNS и создайте запись
CNAME
, указывающую поддомен в домен по умолчанию для сайта. Например, если вы хотите использовать поддоменwww.example.com
для сайта пользователя, создайте записьCNAME
, указывающуюwww.example.com
в<user>.github.io
. Если вы хотите использовать поддоменanother.example.com
для сайта организации, создайте записьCNAME
, указывающуюanother.example.com
в<organization>.github.io
. ЗаписьCNAME
всегда должна указывать в<user>.github.io
или<organization>.github.io
, за исключением имени репозитория. Дополнительные сведения о создании правильной записи см. в документации поставщика DNS. Дополнительные сведения о домене по умолчанию для вашего сайта см. в разделе Сведения о GitHub Pages.Предупреждение: Настоятельно рекомендуется не использовать записи DNS с подстановочными знаками, например
*.example.com
. Эти записи подвергают вас немедленному риску поглощения домена, даже если вы проверяете домен. Например, если вы убедитесьexample.com
, что это предотвращает использованиеa.example.com
пользователем, но он все еще может взять на себяb.a.example.com
(на что распространяется запись DNS с подстановочными знаками). Дополнительные сведения см. в разделе Подтверждение личного домена для GitHub Pages. -
Чтобы проверить правильность настройки записи DNS, используйте команду
dig
, заменив WWW.EXAMPLE.COM своим поддоменом.$ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd > ;WWW.EXAMPLE.COM. IN A > WWW.EXAMPLE.COM. 3592 IN CNAME YOUR-USERNAME.github.io. > YOUR-USERNAME.github.io. 43192 IN CNAME GITHUB-PAGES-SERVER . > GITHUB-PAGES-SERVER . 22 IN A 192.0.2.1
-
Если вы используете генератор статических сайтов для локального создания сайта и отправляете созданные файлы в GitHub Enterprise Cloud, вытяните фиксацию, которая добавила файл CNAME в локальный репозиторий. Дополнительные сведения см. в разделе Устранение неполадок с личными доменами и GitHub Pages. 1. При необходимости, чтобы применить шифрование HTTPS для сайта, выберите Принудительно использовать HTTPS. Этот параметр может стать доступным в течение 24 часов. Дополнительные сведения см. в разделе Защита сайта GitHub Pages с помощью HTTPS.
Настройка домена apex
Чтобы настроить домен apex, например example.com
, необходимо с помощью поставщика DNS настроить личный домен в параметрах репозитория и как минимум одну запись ALIAS
, ANAME
или A
.
Если вы используете домен вершины в качестве личного домена, рекомендуется также настроить поддомен www
. Если вы настроите правильные записи для каждого типа домена с помощью поставщика DNS, GitHub Pages автоматически создаст перенаправления между доменами. Например, если вы настраиваете www.example.com
в качестве личного домена для сайта, а у вас есть записи DNS GitHub Pages, настроенные для вершины и доменов www
, то example.com
выполняет перенаправление в www.example.com
. Обратите внимание, что автоматические перенаправления применяются только к поддомену www
. Автоматические перенаправления не применяются к другим поддоменам, таким как blog
. Дополнительные сведения см. в статье Настройка поддомена.
-
В GitHub Enterprise Cloudперейдите в репозиторий сайта. 1. Нажмите Параметры под именем репозитория.
-
В разделе «Код и автоматизация» на боковой панели щелкните Страницы .
-
В поле "Личный домен" укажите личный домен и нажмите Сохранить. Если публикация выполняется из ветви, будет создана фиксация, которая добавляет файл
CNAME
в корень исходной ветви. Если публикация выполняется с помощью пользовательского рабочего процесса GitHub Actions, файлCNAME
не создается. Дополнительные сведения об источнике публикации см. в статье "Настройка источника публикации для сайта GitHub Pages". -
Перейдите к поставщику DNS и создайте запись
ALIAS
,ANAME
илиA
. Вы также можете создавать записиAAAA
для поддержки IPv6. Дополнительные сведения о создании правильной записи см. в документации поставщика DNS.- Чтобы создать запись
ALIAS
илиANAME
, укажите свой домен apex в домене по умолчанию для вашего сайта. Дополнительные сведения о домене по умолчанию для вашего сайта см. в разделе Сведения о GitHub Pages. - Чтобы создать записи
A
, укажите свой домен apex в IP-адресе для GitHub Pages.185.199.108.153 185.199.109.153 185.199.110.153 185.199.111.153
- Чтобы создать записи
AAAA
, укажите свой домен apex в IP-адресе для GitHub Pages.2606:50c0:8000::153 2606:50c0:8001::153 2606:50c0:8002::153 2606:50c0:8003::153
Предупреждение: Настоятельно рекомендуется не использовать записи DNS с подстановочными знаками, например
*.example.com
. Эти записи подвергают вас немедленному риску поглощения домена, даже если вы проверяете домен. Например, если вы убедитесьexample.com
, что это предотвращает использованиеa.example.com
пользователем, но он все еще может взять на себяb.a.example.com
(на что распространяется запись DNS с подстановочными знаками). Дополнительные сведения см. в разделе Подтверждение личного домена для GitHub Pages. - Чтобы создать запись
-
Чтобы проверить правильность настройки записи DNS, используйте команду
dig
, заменив EXAMPLE.COM своим доменом apex. Убедитесь, что результаты соответствуют IP-адресам для GitHub Pages выше.- Для записей
A
.$ dig EXAMPLE.COM +noall +answer -t A > EXAMPLE.COM 3600 IN A 185.199.108.153 > EXAMPLE.COM 3600 IN A 185.199.109.153 > EXAMPLE.COM 3600 IN A 185.199.110.153 > EXAMPLE.COM 3600 IN A 185.199.111.153
- Для записей
AAAA
.$ dig EXAMPLE.COM +noall +answer -t AAAA > EXAMPLE.COM 3600 IN AAAA 2606:50c0:8000::153 > EXAMPLE.COM 3600 IN AAAA 2606:50c0:8001::153 > EXAMPLE.COM 3600 IN AAAA 2606:50c0:8002::153 > EXAMPLE.COM 3600 IN AAAA 2606:50c0:8003::153
- Для записей
-
Если вы используете генератор статических сайтов для локального создания сайта и отправляете созданные файлы в GitHub Enterprise Cloud, вытяните фиксацию, которая добавила файл CNAME в локальный репозиторий. Дополнительные сведения см. в разделе Устранение неполадок с личными доменами и GitHub Pages. 1. При необходимости, чтобы применить шифрование HTTPS для сайта, выберите Принудительно использовать HTTPS. Этот параметр может стать доступным в течение 24 часов. Дополнительные сведения см. в разделе Защита сайта GitHub Pages с помощью HTTPS.
Настройка домена apex и варианта поддомена www
При использовании домена apex рекомендуется настроить сайт GitHub Pages для размещения содержимого как в домене apex, так и в варианте поддомена www
этого домена.
Чтобы настроить поддомен www
наряду с доменом apex, необходимо сначала настроить домен apex путем создания записи ALIAS
, ANAME
или A
с помощью поставщика DNS. Дополнительные сведения см. в статье Настройка домена apex.
После настройки домена apex необходимо с помощью поставщика DNS настроить запись CNAME.
- Перейдите к поставщику DNS и создайте запись
CNAME
, указывающуюwww.example.com
в домене по умолчанию для вашего сайта:<user>.github.io
или<organization>.github.io
. Не указывайте имя репозитория. Дополнительные сведения о создании правильной записи см. в документации поставщика DNS. Дополнительные сведения о домене по умолчанию для вашего сайта см. в разделе Сведения о GitHub Pages. - Чтобы проверить правильность настройки записи DNS, используйте команду
dig
, заменив WWW.EXAMPLE.COM своим вариантом поддоменаwww
.$ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd > ;WWW.EXAMPLE.COM IN A > WWW.EXAMPLE.COM. 3592 IN CNAME YOUR-USERNAME.github.io. > YOUR-USERNAME.github.io. 43192 IN CNAME GITHUB-PAGES-SERVER. > GITHUB-PAGES-SERVER. 22 IN A 192.0.2.1
Удаление личного домена
-
В GitHub Enterprise Cloudперейдите в репозиторий сайта. 1. Нажмите Параметры под именем репозитория.
-
В разделе «Код и автоматизация» на боковой панели щелкните Страницы .
-
В разделе "Личный домен" нажмите Удалить.
Защита личного домена
Если ваш сайт GitHub Pages отключен, но для него настроен личный домен, существует риск перехвата домена. Если личный домен настраивался с использованием поставщика DNS пока как ваш сайт отключен, это может привести к тому, что другой пользователь разместит сайт в одном из ваших поддоменов.
Проверка вашего личного домена запрещает другим пользователям GitHub использовать ваш домен со своими репозиториями. Если домен не проверен и ваш сайт GitHub Pages отключен, необходимо немедленно обновить или удалить записи DNS с помощью поставщика DNS. Дополнительные сведения см. в статье Проверка личного домена для GitHub Pages.