Управление личным доменом для сайта "Страницы GitHub"

Пользователи с разрешениями администратора для репозитория могут настроить личный домен для сайта 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.

1. Откройте ТерминалТерминалGIT Bash.

Чтобы проверить правильность настройки записи 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.

1. Откройте ТерминалТерминалGIT Bash.

Чтобы проверить правильность настройки записи 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.

Дополнительные материалы

Устранение неполадок личных доменов и GitHub Pages