受支持的自定义域名
提示
我们建议在将自定义域名添加到仓库之前先进行验证，以提升安全性并避免被劫持。更多信息请参阅 验证您的自定义域名以用于 GitHub Pages。
GitHub Pages 支持两类域名：子域名和根域名。有关不受支持的自定义域名列表，请参阅 故障排除自定义域名和 GitHub Pages。
| 受支持的自定义域名类型 | 示例 |
|---|---|
www 子域名 | www.example.com |
| 自定义子域名 | blog.example.com |
| 根域名 | example.com |
您可以为站点设置根域名、www 子域名或两者兼备。有关根域名的更多信息，请参阅 为您的 GitHub Pages 站点使用根域名。
我们建议始终使用 www 子域名，即便您也使用根域名。创建使用根域名的新站点时，我们会自动尝试为其内容服务保留 www 子域名，但您仍需进行 DNS 更改以使用 www 子域名。如果您配置了 www 子域名，我们会自动尝试保护相应的根域名。更多信息请参阅 管理您的 GitHub Pages 站点的自定义域名。
在多个仓库中使用自定义域名
如果您为用户或组织站点设置自定义域名，默认情况下，同一账户拥有的所有项目站点都将使用相同的自定义域名。有关站点类型的更多信息，请参阅 GitHub Pages 是什么？。
例如，如果您的用户站点的自定义域名是 www.octocat.com，且您有一个未配置自定义域名、从名为 octo-project 的仓库发布的项目站点，那么该仓库的 GitHub Pages 站点将位于 www.octocat.com/octo-project。
您可以通过为单独的仓库添加自定义域名来覆盖默认的自定义域名。
注意
私有发布的项目站点的 URL 不受用户或组织站点自定义域名的影响。有关私有发布站点的更多信息，请参阅 GitHub Enterprise Cloud 文档中的 更改 GitHub Pages 站点的可见性。
若要移除默认自定义域名，必须从您的用户或组织站点删除自定义域名。
为您的 GitHub Pages 站点使用子域名
子域名是 URL 中根域名之前的部分。您可以将子域名配置为 www，或作为站点的独立部分，例如 blog.example.com。
子域名通过您的 DNS 提供商使用 CNAME 记录进行配置。更多信息请参阅 管理您的 GitHub Pages 站点的自定义域名。
www 子域名
www 子域名是最常用的子域名类型。例如，www.example.com 包含了一个 www 子域名。
www 子域名是最稳定的自定义域名类型，因为 www 子域名不会受到 GitHub 服务器 IP 地址变更的影响。
自定义子域名
自定义子域名是一种不使用标准 www 形式的子域名。当您希望站点拥有两个独立的部分时，通常会使用自定义子域名。例如，您可以创建名为 blog.example.com 的站点，并独立于 www.example.com 自定义该部分。
为您的 GitHub Pages 站点使用根域名
根域名是指不包含子域名的自定义域名，例如 example.com。根域名也称为基础域名、裸域名、根域、区域根域等。
根域名通过您的 DNS 提供商使用 A、ALIAS 或 ANAME 记录进行配置。更多信息请参阅 管理您的 GitHub Pages 站点的自定义域名。
如果您将根域名用作自定义域名，建议同时设置一个 www 子域名。只要通过 DNS 提供商为每种域名类型配置了正确的记录，GitHub Pages 会自动在这些域名之间创建重定向。例如，如果您将 www.example.com 配置为站点的自定义域名，并且已为根域和 www 域名设置了 GitHub Pages DNS 记录，则 example.com 会重定向到 www.example.com。如果相反将 example.com 配置为自定义域名，则 www.example.com 会重定向到 example.com。自动重定向同样适用于其他子域名，例如 www.blog.example.com 会重定向到 blog.example.com，反之亦然。不能配置以 www.www. 开头的域名。更多信息请参阅 管理您的 GitHub Pages 站点的自定义域名。
为您的 GitHub Pages 站点保护自定义域名
如果您的 GitHub Pages 站点已被停用但仍保留自定义域名，则该域名面临被劫持的风险。自定义域名仍在 DNS 提供商处配置，而站点被停用，可能导致他人在您的某个子域名上托管站点。
验证自定义域名可防止其他 GitHub 用户将您的域名用于他们的仓库。如果您的域名未验证且 GitHub Pages 站点已被停用，您应立即在 DNS 提供商处更新或删除相应的 DNS 记录。更多信息请参阅 验证您的自定义域名以用于 GitHub Pages 和 管理您的 GitHub Pages 站点的自定义域名。
您的站点可能被自动禁用的原因有几项。
- 如果您从 GitHub Pro 降级到 GitHub Free，您账户中当前从私有仓库发布的所有 GitHub Pages 站点都会被取消发布。更多信息请参阅 降级账户计划。
- 如果您将私有仓库转移到使用 GitHub Free 的个人账户，该仓库将失去 GitHub Pages 功能，已发布的 GitHub Pages 站点也会被取消发布。更多信息请参阅 转移仓库。