GitHub Pages 多个项目如何通过Cloudflare 绑定自定义域名?
GitHub Pages 多个项目如何通过Cloudflare 绑定自定义域名?
yuto📘 GitHub Pages 多项目绑定自定义域名 + Cloudflare 配置指南(新版控制面板)
🧱 场景描述
你有多个 GitHub 仓库(项目),希望分别绑定不同的自定义域名或子域名,如:
-
project-a → a.example.com
-
project-b → b.example.com
目标是:让用户访问 https://a.example.com 时,打开 GitHub Pages 上部署的 project-a 项目。
✅ 一、GitHub 仓库 Pages 设置(每个仓库)
对每个仓库(如 project-a)依次操作:
1. 开启 GitHub Pages
进入仓库 → Settings → 左侧 Pages:
-
Source: 选择 main 分支(或 gh-pages),目录为 / 或 /docs
-
保存后,会生成默认地址:https://yourusername.github.io/project-a
2. 添加自定义域名
-
在 Pages 页面下方的 Custom domain 栏填写域名,如:
a.example.com
-
提交后,GitHub 会自动生成或更新仓库根目录的 CNAME 文件,内容如下:
a.example.com
🌐 二、Cloudflare DNS 设置(为每个子域解析)
登录 Cloudflare → 选择你的域名(example.com) → 进入 DNS 页面,添加记录:
示例记录(针对 a.example.com):
类型
名称
内容(值)
代理状态(小云朵)
CNAMEayourusername.github.io
✅ 开启(橙色)
-
如果你绑定根域名(如 example.com 而非子域),请使用 A 记录指向 GitHub Pages 的 IP:
A @ 185.199.108.153(+ 4 个 GitHub IP 可轮询)
🔐 三、Cloudflare SSL / HTTPS 设置(新版控制面板)
Cloudflare 新面板将 SSL 简化为以下两种选项:
1. 保持默认设置
在 SSL/TLS > Overview 页面,保持:
-
✅ Automatic SSL/TLS (default)→ 相当于以前的 “Full” 模式,兼容 GitHub Pages
无需切换到 Custom SSL/TLS,除非你要上传自己的证书。
2. 启用 HTTPS 强制和重写
进入 SSL/TLS > Edge Certificates 页面:
-
✅ 开启 Always Use HTTPS
-
✅ 开启 Automatic HTTPS Rewrites
确保用户自动从 http:// 跳转到 https://,并避免 GitHub Pages 的重定向问题。
✅ 四、最终效果验证
访问你的自定义域名(如 https://a.example.com)时,验证以下几点:
-
页面成功加载,显示你仓库的 GitHub Pages 内容
-
地址栏显示 https,SSL 证书由 Cloudflare 签发
-
没有出现无限重定向、404、或者 ERR_SSL_PROTOCOL_ERROR
📌 总结表
步骤
操作说明
1️⃣
为每个仓库启用 GitHub Pages
2️⃣
设置仓库的 Custom Domain(自动生成 CNAME 文件)
3️⃣
在 Cloudflare 添加 CNAME 记录,开启代理
4️⃣
保持 Cloudflare 默认 SSL 设置(Automatic)
5️⃣
启用 HTTPS 强制跳转选项
✅
完成!你的项目现在通过自定义域名和 HTTPS 访问了
