在现代Web开发中，GitHub Pages因其免费、稳定且与Git工作流无缝集成的特性，成为许多开发者托管个人博客、项目文档或静态网站的首选平台，默认情况下，GitHub Pages仅支持通过.github.io子域名或自定义自定义域名的单一绑定，当用户需要为同一仓库绑定多个域名（主域名、备用域名、品牌相关域名或不同语言版本的域名）时，就需要借助特定的配置方法，本文将详细介绍如何实现GitHub Pages的多域名绑定，涵盖配置步骤、注意事项及常见问题解决方案。
多域名绑定的基本原理
GitHub Pages的多域名绑定本质上是通过DNS（域名系统）解析和GitHub Pages的CNAME配置共同实现的，每个域名都需要通过DNS记录指向GitHub Pages的托管服务器，然后在GitHub仓库的根目录下创建一个CNAME文件，声明所有要绑定的域名，GitHub Pages会根据CNAME文件中的域名信息，自动处理HTTP请求的跳转和HTTPS证书的签发,确保多个域名都能正常访问。
配置前的准备工作
在开始配置之前,需要确保以下条件已满足：
- 拥有多个域名：这些域名已完成注册,并能够通过DNS管理面板进行解析。
- GitHub仓库已启用GitHub Pages：仓库的设置中已选择“GitHub Actions”或“Deploy from a branch”作为发布源,且页面已成功构建。
- 本地Git环境配置：已安装Git工具，并配置好SSH密钥或Personal Access Token用于仓库操作。
多域名绑定的详细步骤
配置DNS解析
登录到你的域名注册商提供的DNS管理面板,为每个域名添加以下记录：
- A记录：将域名指向GitHub Pages的IP地址（
199.108.153、199.109.153、199.110.153、199.111.153）,这是为了确保HTTP请求能够到达GitHub的服务器。 - CNAME记录（可选）：如果希望通过子域名（如
blog.example.com）访问，可以添加CNAME记录指向<username>.github.io（用户仓库）或<organization>.github.io（组织仓库），对于多域名绑定,A记录是更通用的选择。
| 记录类型 | 主机/记录名称 | 值/指向地址 | 优先级 | TTL |
|---|---|---|---|---|
| A | 199.108.153 | 3600 | ||
| A | 199.109.153 | 3600 | ||
| A | 199.110.153 | 3600 | ||
| A | 199.111.153 | 3600 | ||
| CNAME | www | example.com | 3600 |
注意：表示根域名，
www表示子域名，TTL（生存时间）建议设置为3600秒（1小时）,修改后DNS解析可能需要几分钟到24小时生效。
创建或修改CNAME文件
在GitHub仓库的根目录下，创建一个名为CNAME的文本文件（无扩展名），文件内容为你想要绑定的所有域名,每个域名占一行。
example.com
www.example.com
blog.example.com重要提示：
CNAME文件必须位于仓库的根目录,且文件名必须为大写。- 如果仓库之前已绑定自定义域名，直接修改
CNAME即可,无需删除重新创建。- 每次修改
CNAME文件后，GitHub会自动重新生成网站的HTTPS证书,但证书签发可能需要几分钟到几小时。
提交并推送更改
使用Git命令将CNAME文件推送到GitHub仓库：
git add CNAME git commit -m "Add multiple domains to CNAME file" git push origin main
等待GitHub Pages重新部署（通常在几分钟内完成），然后通过浏览器访问各个域名,确认是否正常显示网站内容。
强制HTTPS访问（可选）
默认情况下，GitHub Pages会自动为绑定的域名签发Let’s Encrypt证书，如果访问HTTP域名时未自动跳转HTTPS,可以检查以下设置：
- 在GitHub仓库的“Settings”>“Pages”中，确保“Enforce HTTPS”选项已开启。
- 确保DNS解析已完全生效，且没有其他中间服务（如CDN）拦截HTTPS请求。
多域名绑定的注意事项
- DNS解析延迟：修改DNS记录后，全球DNS缓存更新需要时间，可能导致部分用户仍能访问旧域名，可以通过
ping命令或DNS查询工具（如dig）检查解析状态。 - HTTPS证书签发：新增域名后，GitHub需要时间申请和部署SSL证书，在此期间，访问HTTPS域名可能会显示“不安全”提示，耐心等待即可，一致性**：所有绑定的域名指向同一份网站内容，如果需要不同域名显示不同内容，需考虑使用多个仓库或通过服务器配置（如Nginx）进行反向代理。
- SEO影响：多个域名指向同一网站可能导致搜索引擎认为内容重复，建议在
robots.txt中指定主域名，并在其他域名上使用301重定向指向主域名（需自定义服务器支持）。
常见问题与解决方案
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 访问自定义域名显示“Repository not found” | DNS解析未生效或CNAME文件配置错误 | 检查DNS记录是否正确指向GitHub IP，确认CNAME文件位于根目录且内容无误 |
| HTTPS证书显示无效或过期 | 域名DNS解析错误或GitHub证书签发失败 | 确保A记录正确配置，等待24小时后仍未解决可联系GitHub支持 |
| 部分地区无法访问域名 | DNS污染或网络运营商限制 | 尝试更换DNS服务器（如Cloudflare、Google DNS） |
| 修改CNAME文件后域名未更新 | 本地Git推送失败或GitHub Pages部署延迟 | 检查Git推送日志，手动触发GitHub Pages重新部署 |
通过以上步骤，你可以轻松实现GitHub Pages的多域名绑定，灵活管理多个网站入口，合理利用多域名不仅能提升品牌形象，还能为用户提供更便捷的访问体验，在实际操作中，建议耐心等待DNS和HTTPS证书的生效时间，并定期检查域名的访问状态,确保配置的稳定性和可靠性。
