Устранение неполадок с личными доменами и страницами

Кто может использовать эту функцию?

Pages is available in public repositories with Free and Free for organizations, and in public and private repositories with Pro, Team, Enterprise Cloud, and Enterprise Server. For more information, see ’s plans.

Pages now uses Actions to execute the Jekyll build. When using a branch as the source of your build, Actions must be enabled in your repository if you want to use the built-in Jekyll workflow. Alternatively, if Actions is unavailable or disabled, adding a .nojekyll file to the root of your source branch will bypass the Jekyll build process and deploy the content directly. For more information on enabling Actions, see Managing Actions settings for a repository.

В этой статье

При публикации из пользовательского рабочего процесса Actions любой файл CNAME игнорируется и не требуется.

Если публикация выполняется из ветви, личные домены хранятся в файле CNAME в корне источника публикации. Вы можете добавить или обновить этот файл с помощью параметров репозитория либо вручную. Дополнительные сведения см. в разделе Управление личным доменом для сайта "Страницы ".

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

Затем убедитесь, что файл CNAME отформатирован правильно.

  • Имя файла CNAME должно быть записано прописными буквами.
  • Файл CNAME может содержать только один домен. Чтобы указать несколько доменов на сайт, необходимо настроить перенаправление через поставщика DNS.
  • Файл CNAME должен содержать только доменное имя. Например, www.example.com, blog.example.com или example.com.
  • Доменное имя должно быть уникальным для всех сайтов Pages. Например, если файл CNAME другого репозитория содержит example.com, нельзя использовать example.com в файле CNAME для репозитория.

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

Вы также можете использовать один из следующих методов для проверки правильности настройки записей DNS личного домена:

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

Убедитесь, что сайт:

  • Не использует несколько доменов Apex. Например, значения example.com и anotherexample.com.

  • Не использует несколько поддоменов www. Например, значения www.example.com и www.anotherexample.com.

  • Не использует ни домен Apex, ни пользовательский поддомен. Например, значения example.com и docs.example.com.

    Единственным исключением является поддомен www. При правильной настройке поддомен www автоматически перенаправляется в домен Apex. Дополнительные сведения см. в разделе Управление личным доменом для сайта "Страницы ".

Предупреждение

Настоятельно рекомендуется не использовать подстановочные записи DNS, например *.example.com. Эти записи ставят вас под непосредственный риск отработки домена, даже если вы проверяете домен. Например, если проверить example.com это, кто-то не сможет использовать a.example.com , но он по-прежнему может взять на себя b.a.example.com (который рассматривается подстановочными знаками DNS-записи). Дополнительные сведения см. в разделе Проверка личного домена для Pages.

Список поддерживаемых пользовательских доменов см. в разделе Сведения о личных доменах и страницах .

Доступ к сайтам Pages, использующим личные домены, которые правильно настроены с помощью записей DNS CNAME, ALIAS, ANAME или A, можно получить по протоколу HTTPS. Дополнительные сведения см. в разделе Защита сайта Pages с помощью HTTPS.

После настройки личного домена может потребоваться около часа, чтобы ваш сайт стал доступным по протоколу HTTPS. После обновления существующих параметров DNS может потребоваться удалить и повторно добавить личный домен в репозиторий сайта, чтобы активировать процесс включения HTTPS. Дополнительные сведения см. в разделе Управление личным доменом для сайта "Страницы ".

Если вы используете записи авторизации центра сертификации (CAA), должна существовать по крайней мере одна такая запись со значением letsencrypt.org для сайта, чтобы он был доступен по протоколу HTTPS. Дополнительные сведения см. в документации по авторизации центра сертификации (CAA).

Если URL-адрес сайта содержит имя пользователя или название организации, которое начинается либо заканчивается тире или содержит последовательные тире, пользователи, выполняющие просмотр, используя Linux, при попытке посетить сайт получат ошибку сервера. Чтобы устранить эту проблему, измените имя пользователя на удаление символов, отличных от буквенно-цифровых символов. Дополнительные сведения см. в разделе Изменение имени пользователя для .

Если вы недавно изменили или удалили личный домен и не можете получить доступ к новому URL-адресу в браузере, вам может потребоваться очистить кэш браузера для получения доступа. Дополнительные сведения об очистке кэша см. в документации браузера.

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