如何将我的域名绑定到 GitHub Pages？

将域名绑定到 GitHub Pages 之前需要准备什么？

DotAlmanac 是域名后缀指南兼注册商：先对比各个域名后缀，再无需 KYC 注册，并用加密货币支付。按照本指南操作，你需要准备三样东西。

• 一个使用 DotAlmanac 域名服务器（DNS 服务器）的域名。 该域名的“域名服务器”选项卡必须显示“我们的域名服务器”。如果域名使用的是其他域名服务器，请在对应的 DNS 服务商处添加相同的记录。
• 一个已开启 GitHub Pages 的仓库。 可以从分支发布，也可以通过 GitHub Actions 工作流发布。
• 你的 GitHub 用户名或组织名。 它要填在 www 记录中，仓库名则永远不需要填。

很多开发者会为项目网站选择 .dev 或 .app。请先看续费价格：根据 DotAlmanac 价格表，截至 2026 年 10 月 29 日，.dev 的续费价比首年价格高 44%，.app 高 67%。.dev 首年 US$8.99/年，之后 US$12.99/年。这两个域名后缀都强制要求 HTTPS，而 GitHub Pages 会提供 HTTPS。可在 .app vs .dev 中对比两者。

可以直接以区域文件（zone file）的形式粘贴记录吗？

可以。打开 DNS › 导入 / 导出 › 导入区域文件，选择“添加到现有记录”，然后粘贴下面的内容。将 octocat 替换为你自己的用户名。导入功能支持标准 BIND 语法，会显示预览，在你保存之前不会提交任何更改。

@    3600  IN  A      185.199.108.153
@    3600  IN  A      185.199.109.153
@    3600  IN  A      185.199.110.153
@    3600  IN  A      185.199.111.153
@    3600  IN  AAAA   2606:50c0:8000::153
@    3600  IN  AAAA   2606:50c0:8001::153
@    3600  IN  AAAA   2606:50c0:8002::153
@    3600  IN  AAAA   2606:50c0:8003::153
www  3600  IN  CNAME  octocat.github.io.

GitHub Pages 应该用裸域名还是 www？

两者都配置，然后在仓库中填写你偏好的那一个。当根域名和 www 的记录都正确时，GitHub Pages 会把另一个自动跳转到它。

GitHub 每个网站只支持一个根域名或一个 www 域名。不支持两个根域名、两个 www 域名，也不支持根域名与另一个自定义子域名同时使用。如果项目放在子域名上，例如 docs.example.com，只需添加一条从 docs 指向 USERNAME.github.io 的 CNAME 记录，无需添加 A 记录。

域名多久才能在 GitHub Pages 上生效？

这取决于你修改之前解析器所看到的记录的 TTL。TTL 是解析器将应答保存在缓存中的秒数。

• 如果该名称之前没有任何记录，保存后即可立即解析。
• 如果是替换已有记录，部分缓存会保留旧值，直到旧的 TTL 到期。模板记录使用 3600 秒，即 1 小时。
• 迁移前请提前规划：在修改前一天将旧记录的 TTL 降低到 300 秒。

GitHub 官方文档指出，DNS 更改最长可能需要 24 小时才能全球生效。DNS 检查通过后，才会签发 HTTPS 证书。

为什么 GitHub 提示我的域名配置不正确？

大多数情况下，是同一名称下仍有旧记录在应答。请按顺序检查以下几点：

• 残留记录。 @ 上旧的 A、AAAA 或 ALIAS 记录，或停放（parking）记录，会与 GitHub 的记录冲突。模板会自动删除它们；手动修改时常常会漏掉一条。
• CNAME 中包含仓库名。 www 的目标只能是 USERNAME.github.io。
• 泛解析记录。 GitHub 警告，诸如 *.example.com 这样的记录会带来域名被劫持的风险。请将其删除。
• 使用了其他域名服务器。 如果域名使用的是其他 DNS 服务商，DotAlmanac DNS 标签页中的记录将不会生效。
• CAA 记录。 如果你发布了 CAA 记录，GitHub 要求至少有一条值为 letsencrypt.org 的记录，才能启用 HTTPS。

可使用 dig example.com +short 或任意在线 DNS 查询工具检测结果。