验证 GitHub Pages 的自定义域

您可以通过验证您的域来提高自定义域的安全性并避免接管攻击。

谁可以使用此功能？

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共存储库，以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和专用存储库。 有关详细信息，请参阅 GitHub的计划。

在本文中

关于 GitHub 页面的域验证

验证个人帐户的自定义域时，只能使用个人帐户拥有的存储库将 GitHub Pages 站点发布到已验证的自定义域或域的直接子域。 同样，验证组织的自定义域时，只能使用组织拥有的存储库将 GitHub Pages 站点发布到已验证的自定义域或域的直接子域。

验证您的域名可以阻止其他GitHub用户抢占您的自定义域，并用其发布他们自己的GitHub Pages 网站。 当您删除存储库、降低计费计划等级，或在任何其他情况下取消链接自定义域名或禁用 GitHub Pages 时，如果该域名仍然配置为 GitHub Pages 且尚未验证，可能会发生域名接管。

验证域时，验证中还会包含任何直接子域。 例如，如果已验证 github.com 自定义域，docs.github.com、support.github.com 和任何其他直接子域也将受到保护，以防止被接管。

警告

我们强烈建议勿使用通配符 DNS 记录，例如 *.example.com。 即使验证域，这些记录也会立即面临域接管风险。 例如，如果验证 example.com，这会阻止某人使用 a.example.com，但他们仍可以接管 b.a.example.com（由通配符 DNS 记录所涵盖）。

你也可以为你的组织 或企业验证域，这将在组织或企业配置文件上显示“已验证”徽章，并在 GitHub Enterprise Cloud 上允许你将通知限制为使用该验证域的电子邮件地址。 有关更多信息，请参阅 验证或批准您组织的域名 和 验证或批准公司域名 。

验证已注册的域名

你可能正在验证自己所拥有的域（当前正被其他用户或组织使用），以使其可用于你的 GitHub Pages 网站。 在这种情况下，该域将立即从其他用户或组织拥有的 GitHub Pages 网站中释放。 如果尝试验证已通过验证的域（已由其他用户或组织验证），则释放过程不会成功。

验证您的网站域名

注意

如果没有看到下面描述的选项，请确保位于“Profile”设置中，而不是仓库设置中****。 域验证发生在配置文件级别。

  1. 在 GitHub 任意页面的右上角，单击你的个人资料照片，然后单击“ Settings”****。

  2. 在边栏的“代码、计划和自动化”部分，点击“ Pages”****。

  3. 在右侧，单击“添加域”。

  4. 在“要添加什么域？”下，输入要验证的域，然后选择“添加域”。

    用于为 GitHub Pages 站点添加已验证域的字段的屏幕截图。 字段下方显示了一个绿色的“添加域”按钮。

  5. 按照“添加 DNS TXT 记录”下的说明，使用域托管服务创建 TXT 记录。

    用于将 TXT 记录添加到 example.com 的 DNS 配置的 GitHub Pages 说明的屏幕截图。

  6. 等待您的 DNS 配置更改，这可能是立即更改或最多需要 24 小时。 可以通过在命令行上运行 dig 命令来确认对 DNS 配置的更改。 在以下命令中，将 USERNAME 替换为你的用户名，将 example.com 替换为要验证的域。 如果您的 DNS 配置已更新，您应该会在输出中看到新的 TXT 记录。

    dig _github-pages-challenge-USERNAME.example.com +nostats +nocomments +nocmd TXT

  7. 确认 DNS 配置已更新后，可以验证域。 如果更改不是立即进行的，并且你已离开上一页，请按照最初的几个步骤返回“页面”设置，在域右侧单击 ，然后单击“继续验证”。

    “Verified domains”设置的屏幕截图。 在右侧的水平烤肉串图标下，“Continue verifying”选项用橙色框出。

  8. 若要验证该域，请单击“验证”。

  9. 若要确保自定义域保持验证状态，请将 TXT 记录保留在域的 DNS 配置中。

验证组织网站的域名

组织所有者可以验证其组织的自定义域。

注意

如果没有看到下面描述的选项，请检查是否位于“Organization”设置中****。 域验证不会在仓库设置中进行。

  1. 在 GitHub 的右上角，单击个人资料图片，然后单击“ Your organizations”****。1. 单击以选择一个组织。

  2. 在组织名称下，单击 “Settings”****。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  3. 在边栏的“代码、计划和自动化”部分中，单击“ Pages”****。

  4. 在右侧，单击“添加域”。

  5. 在“要添加什么域？”下，输入要验证的域，然后选择“添加域”。

    用于为 GitHub Pages 站点添加已验证域的字段的屏幕截图。 字段下方显示了一个绿色的“添加域”按钮。

  6. 按照“添加 DNS TXT 记录”下的说明，使用域托管服务创建 TXT 记录。

    用于将 TXT 记录添加到 example.com 的 DNS 配置的 GitHub Pages 说明的屏幕截图。

  7. 等待 DNS 配置更改。 这可能会立即发生或最多需要 24 小时。 可以通过在命令行上运行 dig 命令来确认对 DNS 配置的更改。 在以下命令中，将 ORGANIZATION 替换为组织的名称，将 example.com 替换为要验证的域。 如果您的 DNS 配置已更新，您应该会在输出中看到新的 TXT 记录。

    dig _github-pages-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT

  8. 确认 DNS 配置已更新后，可以验证域。 如果更改不是立即进行的，并且你已离开上一页，请按照最初的几个步骤返回“页面”设置，在域右侧单击 ，然后单击“继续验证”。

    “Verified domains”设置的屏幕截图。 在右侧的水平烤肉串图标下，“Continue verifying”选项用橙色框出。

  9. 若要验证该域，请单击“验证”。

  10. 若要确保自定义域保持验证状态，请将 TXT 记录保留在域的 DNS 配置中。