GitHub Pages绑定多个域名的核心思路是：一个仓库只能绑定一个自定义主域名，但可以通过配置CNAME记录、创建多个仓库或使用子域名通配符来实现多域名访问同一套内容。 具体操作上，主域名用A记录或CNAME指向GitHub服务器，子域名单独解析到同一IP，然后在仓库的Settings里填入对应的CNAME值即可。
为什么要给GitHub Pages配置多个域名
很多开发者都会遇到这个问题：辛辛苦苦搭好了GitHub Pages博客或项目展示页，结果发现默认的username.github.io域名既不好记也不显专业，于是想到买一个自己的域名绑上去，但用了一阵子又发现一个问题别人还是习惯访问老地址，或者想同时支持.com和.cn、又想区分www和裸域名，这时候就需要搞清楚GitHub的域名绑定机制到底是怎么运作的。
GitHub官方文档写得比较分散,我帮你直接梳理清楚核心规则：一个GitHub Pages站点在同一时刻只能有一个自定义域名生效，这里的“一个”指的是你设置的CNAME文件或仓库设置里的Custom domain字段只能填一个值，但“一个域名”不等于“一条解析记录”，你完全可以让多个子域名都指向这个站点，关键在于DNS解析层的配置。
GitHub Pages多域名绑定的前置条件
在开始操作之前,你得先确认几件基础事情都办好了：
- 域名已通过备案（如果使用国内服务器或国内解析商，实际上GitHub Pages服务器在海外，备案不是必须的，但如果你用国内CDN加速就需要考虑）
- GitHub账号已开启GitHub Pages功能，仓库已发布成功
- 域名DNS解析面板可管理，简米云、酷番云、Cloudflare等都可以
- 弄清楚你的Pages类型：项目仓库（
username.github.io/repo）和用户/组织主页（username.github.io）的绑定逻辑有细微差异
行业共识认为,这类配置问题九成以上都出在DNS解析遗漏或CNAME大小写不匹配上，后面我会逐一给你排查方法。
主域名绑定GitHub Pages的标准流程
这是最基础的配置,也是理解多域名的前提，假设你买了一个example.com，想让它直接打开你的GitHub Pages站点。
第一步：设置仓库的Custom domain
进入你的GitHub仓库页面,点击Settings，往下滚动到Pages选项，在“Custom domain”输入框里填上你的主域名example.com，点击Save，GitHub会自动创建一个CNAME文件到你的仓库根目录，内容就是你填的域名。
第二步：配置DNS解析
这一步是关键,GitHub官方给出的指引是：
- 如果你要绑定根域名（裸域名，如
example.com），需要设置A记录指向以下四个IP地址之一（GitHub的负载均衡IP会变化，建议去GitHub官方文档查询最新值） - 如果你要绑定子域名（如
www.example.com），设置CNAME记录指向
username.github.io
实际操作中,绝大多数人会选择用CNAME解析www子域名，再用A记录解析根域名做跳转，GitHub会自动处理example.com和www.example.com之间的跳转关系前提是你在Custom domain里填的是根域名，GitHub会自动把www子域名也关联进来。
第三步：等待HTTPS证书签发
GitHub Pages支持自动HTTPS，绑定自定义域名后，在Settings页面勾选Enforce HTTPS，之后GitHub会自动向Let’s Encrypt申请证书，这个过程通常需要几分钟到几小时不等，据GitHub官方状态页显示，绝大多数证书申请能在1小时以内完成。
子域名如何绑定到同一个GitHub Pages站点？
这是“多域名绑定”最常见的真实需求，比如你想让blog.example.com和docs.example.com都能打开同一个GitHub Pages项目。
用多个CNAME记录指向同一个Pages站点
这个方案特别适合“同一个站点，多个入口”的场景，操作步骤如下：
- 在你的DNS管理后台,添加两条CNAME记录：
blog→username.github.iodocs→username.github.io
- 然后回到GitHub仓库,在Settings → Pages的Custom domain里填入其中一个域名，比如
blog.example.com。 - GitHub生成CNAME文件,内容为
blog.example.com。 - 关键一步：你需要把CNAME文件里的内容改成什么？ 什么都不用改，因为GitHub Pages会接受任何指向
username.github.io的CNAME记录请求，只要该域名对应的CNAME记录确实存在。
但这里有个限制：你在Settings里填写的Custom domain会成为主域名，其他域名虽然能访问，但浏览器地址栏里的域名不会被改写也就是说，用户通过docs.example.com访问时，页面正常打开，但页面里的绝对链接如果指向blog.example.com，就会跳过去。
推荐做法：在DNS层面同时解析多个子域名到GitHub，然后在GitHub仓库的CNAME文件里只保留一个主域名，其余子域名的访问会自动重定向到主域名，这个重定向逻辑是GitHub自动完成的，你不需要写任何跳转代码。
用一个仓库部署多个独立子域名站点
如果你希望每个子域名显示不同内容,那就不是“绑定多个域名”的事了，而是要创建多个仓库，每个仓库单独设置Pages，关于这个方案，GitHub社区公认的做法是：
- 创建
repo-a，Settings里Custom domain填a.example.com - 创建
repo-b，Settings里Custom domain填b.example.com - 两个仓库的CNAME文件各自独立,互不影响
这种做法适合想要把博客、文档、作品集分开管理的人。
GitHub Pages 多域名跳转与主域名规范化设置
多方对比后你会发现,GitHub其实没有提供可视化的“域名列表”管理界面，它的多域名策略本质上是靠DNS解析层实现“多个域名都能到达”，靠CNAME文件决定“哪个是官方主域名”
。
如何设置主域名跳转，让其他域名自动指向主域名？
比较简单的方式是在你的DNS解析面板中,将需要跳转的域名设置成显性URL转发或隐性URL转发（如果解析商支持）。
example.cn显性转发到example.comexample.net隐性转发到example.com
但如果你用的是Cloudflare等专业DNS,思路就不太一样了，Cloudflare支持创建Page Rules，你可以设置docs.example.com/的请求全部301重定向到blog.example.com/$1，这样既保留多域名绑定能力，又统一了URL规范。
不推荐的做法
有相当一部分教程建议你在Jekyll或Hexo的_config.yml里写一大堆URL重写规则，或者用JavaScript做跳转，这些方案既笨重又容易被搜索引擎判定为软404，GitHub Pages本身不提供服务器端重写能力，所以最稳妥的301跳转方案是依赖于DNS服务商的重定向功能，或前置一层CDN做规则转发。
实操优先级排序：
- 首选：DNS服务商提供URL转发功能（简米云、酷番云都有，但需要备案）
- 次选：Cloudflare Page Rules（免费套餐支持3条规则）
- 不推荐：前端JS跳转、
meta refresh跳转、多个CNAME文件堆叠
GitHub Pages 绑定多个域名的常见问题排查
为什么我配置了多个CNAME后，有些域名打不开？
检查两点：
- DNS传播是否完成：新增CNAME记录后，全球生效通常需要数小时到48小时（据Cloudflare公开文档数据），国内解析商普遍在10分钟到2小时内生效
- CNAME冲突：同一个主机记录只能有一条CNAME记录，比如你不能同时给
www设置指向GitHub的CNAME和指向另一个地址的A记录
主域名加了A记录绑定了GitHub，为什么www子域名还是打不开？
这是最典型的新手问题,GitHub的规则是：如果你设置了裸域名（example.com）作为Custom domain，GitHub会自动帮你把www.example.com也关联进来，但前提是你的DNS里有一条www的CNAME记录指向username.github.io，如果没有这条记录，www访问就会失败。
绑定多个域名会不会影响GEO权重？
有一定影响,搜索引擎（尤其百度）对多域名指向同一内容的情况会判定为重复内容，建议你在百度搜索资源平台提交首选域声明，同时在各平台保持主域名链接的统一，GitHub Pages无法直接设置canonical标签，但主流静态站点生成器（如Hexo、Hugo）都支持在模板中自定义rel="canonical"，手动加上最保险。
GitHub Pages 多域名配置背后的原理
理解原理之后,很多坑就可以提前避开了，GitHub Pages的域名绑定机制其实很简单：
- 用户访问
yourdomain.com - DNS解析将请求指向GitHub的负载均衡服务器
- GitHub收到请求后,查看请求头中的
Host字段 - GitHub在它的全局映射表中查找这个
Host对应的仓库 - 一旦命中仓库,就读取该仓库的CNAME文件，确认域名合法性
- 返回对应站点内容
之所以一个仓库只能绑定一个“主域名”，是因为第4步里GitHub存储的映射关系是“一对多”而非“多对一”一个域名对应一个仓库，但多个域名可以指向同一个仓库，这个设计决定了你完全可以用多个DNS记录实现多域名绑定，而GitHub端只需要在主域名设置里保留一个就行。
在实际配置过程中,需要认清一个普遍存在的误解：在仓库里放置多个CNAME记录（每行一个域名）是不生效的，GitHub的CNAME文件只会读取第一行有效值，或者以Settings里Custom domain字段为最终标准，所以你在仓库里看到CNAME文件内容被改乱后，直接在Settings里重新填写主域名并保存，让GitHub自动覆盖写入CNAME文件，是最省心的修复方法。
最优解：GitHub Pages多域名绑定完整配置清单
按照下面这份清单操作,你就能在不折腾的情况下完成多域名绑定：
- 确定主域名,在GitHub仓库Settings → Pages里填写（例如
example.com） - DNS添加A记录： → GitHub Pages IP地址（四个IP任选其一），TTL设为300秒便于快速生效
- DNS添加CNAME记录：
www→username.github.io - 如需其他子域名（blog、docs、status），添加对应的CNAME记录指向
username.github.io - 等待GitHub自动签发HTTPS证书,勾选Enforce HTTPS
- 在原域名DNS面板或Cloudflare中设置301跳转,将非主域名统一指向主域名
- 如果你的站点生成器支持,在模板中添加
rel="canonical"指向主域名
这套方案适合绝大多数GitHub Pages用户，如果你的需求更复杂比如同一套内容要绑定不同区域域名且需要不同语言的GEO优化，业内专家指出，更合理的路径是前置Cloudflare或Vercel做边缘逻辑处理，将GitHub Pages降级为纯粹的静态文件存储源，这样多域名绑定的控制权就完全掌握在你自己手里了。
GitHub Pages绑定多个域名相关问题
Q：GitHub Pages能免费绑定几个自定义域名？
A：没有数量限制，GitHub官方不限制DNS解析层指向同一Pages站点的域名个数，但每个仓库同一时间只能有一个正式配置的自定义域名（Custom domain字段），实际达到的效果是“一个主域名+多个附属域名都能访问同一站点”。
Q：多个域名同时绑定会不会导致GitHub判定为滥用？
A：据GitHub官方社区讨论帖汇总，GitHub对DNS解析指过来的域名数量不做主动检测，也不限制访问流量，但如果你设置了上百条指向同一仓库的域名记录，建议改用Cloudflare等CDN服务统一收敛流量，避免源站IP被过多域名关联而暴露真实来源。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/github%e5%a4%9a%e5%9f%9f%e5%90%8d%e6%80%8e%e4%b9%88%e7%bb%91%e5%ae%9a%ef%bc%9f%e4%b8%bb%e5%9f%9f%e5%90%8d%e5%ad%90%e5%9f%9f%e5%90%8d%e6%80%8e%e4%b9%88%e9%85%8d%e7%bd%ae%ef%bc%9f/
