支持的自定义域
GitHub Pages 可使用两种类型的域名:子域名和 apex 域名。 有关不支持的自定义域名列表,请参阅“自定义域名和 GitHub Pages 疑难解答“。
支持的自定义域类型 | 示例 |
---|---|
www 子域 | www.example.com |
自定义子域 | blog.example.com |
Apex 域 | example.com |
You can set up either or both of apex and www
subdomain configurations for your site. For more information on apex domains, see "Using an apex domain for your GitHub Pages site."
建议始终使用 www
子域名,即使您也同时使用 apex 域。 When you create a new site with an apex domain, we automatically attempt to secure the www
subdomain for use when serving your site's content. If you configure a www
subdomain, we automatically attempt to secure the associated apex domain. 更多信息请参阅“管理 GitHub Pages 网站的自定义域。
在配置用户或组织网站的自定义域后,自定义域名将替换未配置自定义域的帐户所拥有的任何项目网站 URL 的 <user>.github.io
或 <organization>.github.io
部分。 例如,如果您的用户网站的自定义域名为 www.octocat.com
,并且您拥有一个未自定义域名的项目网站,该网站从名为 octo-project
的仓库发布,则该仓库的 GitHub Pages 网站将在 www.octocat.com/octo-project
上提供。
对您的 GitHub Pages 网站使用子域名
子域名是根域前 URL 的一部分。 您可以将子域名配置为 www
或网站的独特部分,如 blog.example.com
。
子域名配置通过 DNS 提供商使用 CNAME
记录配置。 更多信息请参阅“管理 GitHub Pages 网站的自定义域。
www
子域
www
子域名是最常用的一种子域名。 例如,www.example.com
包含 www
子域名。
www
子域名是最稳定的一种自定义域,因为 www
子域名不受 GitHub 服务器 IP 地址变动的影响。
自定义子域
A custom subdomain is a type of subdomain that doesn't use the standard www
variant. 自定义子域主要在您需要将网站分为两个不同的部分时使用。 例如,您可以创建一个名为 blog.example.com
并自定义该部分与 www.example.com
分开。
对您的 GitHub Pages 网站使用 apex 域
Apex 域是一个不包含子域的自定义域,如 example.com
。 Apex 域也称为基础域、裸域、根 apex 域或区域 apex 域。
Apex 域配置通过 DNS 提供商使用 A
, ALAS
或 ANAME
记录配置。 更多信息请参阅“管理 GitHub Pages 网站的自定义域。
如果使用 apex 域作为自定义域名,建议还设置一个 www
子域。 如果通过 DNS 提供程序配置每种域类型的正确记录,GitHub Pages 将自动在域之间创建重定向。 例如,如果您配置 www.example.com
作为站点的自定义域,并且为 apex 和 www
域设置了 GitHub Pages DNS 记录,则 example.com
将重定向到 www.example.com
。 请注意,自动重定向仅适用于 www
子域。 自动重定向不适用于任何其他子域,如 blog
。更多信息请参阅“管理 GitHub Pages 站点的自定义域”。
在 GitHub Pages 站点禁用时更新自定义域
如果您的 GitHub Pages 站点设置了自定义域,并且站点已禁用,您应立即通过 DNS 提供商更新或删除 DNS 记录,以避免域接管的风险。 在您的网站被禁用时拥有通过 DNS 提供商配置的自定义域,可能会导致其他人在您的一个子域上托管网站。 更多信息请参阅“管理 GitHub Pages 网站的自定义域。
有许多原因会导致您的网站被自动禁用。
- 如果您从 GitHub Pro 降级到 GitHub Free,则目前发布自您的帐户中私有仓库的任何 GitHub Pages 站点都会取消发布。 更多信息请参阅“Downgrading your GitHub 结算方案”。
- 如果将私人仓库转让给使用 GitHub Free 的个人帐户,仓库将失去对 GitHub Pages 功能的访问,当前发布的 GitHub Pages 站点将取消发布。 更多信息请参阅“转让仓库”。