GitHub Pages 自定义域名（Cloudflare）极简配置教程

目标

让 GitHub Pages 正常使用自定义域名（支持 HTTPS）

---

一、前提条件

• 已有 GitHub 仓库
• 仓库已开启 Pages，已有 GitHub Pages 仓库（能用 xxx.github.io 访问）
• 已有一个域名，域名已托管到 Cloudflare

---

二、Cloudflare DNS 配置

例如我要配置 book.qingyang.ai 映射到 github仓库 随心书斋

1️⃣ Apex 域名（example.com）

在 Cloudflare → DNS → Records 中新增 4 条 A 记录：

Type: A
Name: book
IPv4: 185.199.108.153
Proxy: DNS Only

Type: A
Name: book
IPv4: 185.199.109.153
Proxy: DNS Only

Type: A
Name: book
IPv4: 185.199.110.153
Proxy: DNS Only

Type: A
Name: book
IPv4: 185.199.111.153
Proxy: DNS Only

---

2️⃣ 子域名（方案2 - 推荐）

Type: CNAME
Name: book
Target: QingYang1807.github.io
Proxy: DNS Only

username 替换为你的 GitHub 用户名

---

三、GitHub Pages 设置

进入仓库：

Settings → Pages

在 Custom domain 中填写：

book.qingyang.ai

点击 Save

---

四、HTTPS 开启

• 等待 GitHub 自动签发证书（通常 5–30 分钟）
• 勾选 Enforce HTTPS

---

五、完成校验

访问：

https://book.qingyang.ai

均能正常打开即成功。

---

常见踩坑（只看一遍就行）

• ❌ 不要把多个 IP 写进一条 A 记录
• ❌ 不要开启 Cloudflare 橙色云朵代理
• ❌ 不要手动加 AAAA（IPv6）
• ✅ 所有记录保持 DNS Only

---

标准配置速查表

@    A      185.199.108.153   DNS Only
@    A      185.199.109.153   DNS Only
@    A      185.199.110.153   DNS Only
@    A      185.199.111.153   DNS Only
www  CNAME  username.github.io  DNS Only

---

一句话总结

Cloudflare 只管解析，GitHub Pages 只管内容，HTTPS 交给 GitHub。

这套配置长期稳定，不折腾。