GitHub Pages如何绑定自定义域名?2016.opentechsummit.net的CNAME配置全解

原创2026-11-01 13:04:121,459 阅读

GitHub Pages如何绑定自定义域名?2016.opentechsummit.net的CNAME配置全解

想让 GitHub Pages 摆脱默认地址、换上自己购买的域名?本文以开源项目 2016.opentechsummit.net(OpenTechSummit 2016 活动站点)为实例,完整讲解 GitHub Pages 绑定自定义域名的 CNAME 配置方法,新手照着做即可 3 分钟上手 🎉

先认识一下:CNAME 文件是什么?

CNAME 是 DNS(域名系统)中的一种记录类型,作用是把一个域名"指向"另一个域名。在 GitHub Pages 的语境下,CNAME 文件承担着一个特殊职责:

只要你的仓库根目录下存在名为 CNAME 的纯文本文件,GitHub Pages 就会自动把该文件中写的域名绑定到这个站点。

也就是说,一个文件 = 一条绑定指令,简单直接。

看实例:本仓库的 CNAME 长什么样?

打开 CNAME 文件,内容只有一行:

2016.opentechsummit.net

再看 README.md,项目描述同样指向这个域名:

2016.opentechsummit.net
OpenTechSummit 2016

再配合 index.html 中的 meta 刷新跳转标签,整个站点就完成了"自定义域名 → 实际内容"的完整链路。这就是一个典型的 超轻量级 CNAME 配置:仓库里没有任何复杂代码,核心就是那个不到 30 字节的 CNAME 文件。

GitHub Pages绑定自定义域名:5步操作流程

第1步:购买并准备你的域名

你需要一个自己拥有管理权限的域名(如 yoursite.com)。登录域名服务商的控制台,确保你能添加 DNS 记录。

第2步:在仓库根目录创建 CNAME 文件

在你的 Pages 仓库根目录下新建一个 CNAME 文件,内容只写一行域名:

www.yoursite.com

⚠️ 注意事项清单:

  • 文件名必须全大写 CNAME,不能写成 cname.txt 或 CNAME.md
  • 文件里只能有一个域名,末尾不加 www 之外的多余内容
  • 不要带 https:// 前缀,只写裸域名

第3步:到域名服务商添加 DNS 解析记录

根据你的站点类型选择记录:

场景 记录类型 主机记录 记录值
绑定 www.yoursite.com CNAME www <你的用户名>.github.io
绑定主域 yoursite.com A 记录 @ GitHub Pages 官方 IP

主域名(不带 www)无法使用 CNAME 记录,需要改用 A 记录指向 GitHub Pages 的 IP 段——这是新手最常踩的坑之一。

第4步:在 GitHub 站点设置中确认域名

进入仓库的 Settings → Pages 页面,在 "Custom domain" 一栏填入你的域名,保存即可。若仓库里已有 CNAME 文件,这里通常会自动带出对应域名。

第5步:等待 DNS 生效并验证

DNS 传播通常需要几分钟到 48 小时。生效后可用 ping 你的域名 或在线 DNS 查询工具确认记录已生效,浏览器访问该域名应能看到你的 Pages 站点。

常见报错排查:自定义域名不生效怎么办?

  • 显示 "This domain isn't connected to GitHub":检查 CNAME 文件名大小写、是否有多余空行
  • 浏览器提示证书错误:确认你绑定的是 www 子域名,免费证书不支持裸主域名的自动签发
  • 访问跳转到空白页:确认 DNS 记录指向了正确的 username.github.io 地址,而不是旧 IP

小结

通过一个纯文本的 CNAME 文件,GitHub Pages 就能把站点挂到自定义域名下——2016.opentechsummit.net 这个项目用最少的文件演示了完整流程:README.md 声明项目信息、CNAME 完成域名绑定、index.html 承载页面逻辑。掌握"建 CNAME 文件 → 加 DNS 记录 → Settings 确认"这三步,你就能为任何 Pages 站点换上专属域名 🚀

登录后查看全文
2016.opentechsummit.net