要在 GitHub Pages 上设置自定义域名,请按以下步骤操作：
步骤 1：在 GitHub 仓库中配置域名
- 进入你的 GitHub 仓库 → Settings → Pages
（仓库需已启用 GitHub Pages，分支通常为gh-pages、main或docs）。 - 在 Custom domain 栏输入你的域名（如
example.com或www.example.com）→ Save。 - （可选）勾选 Enforce HTTPS 强制启用 HTTPS。
步骤 2：配置 DNS 解析（域名注册商处操作）
使用根域名（如 example.com）
- 方法：添加 A 记录
在 DNS 管理面板添加 4 条 A 记录，指向 GitHub Pages 的 IP：199.108.153 185.199.109.153 185.199.110.153 185.199.111.153- 主机名：（或留空,代表根域名）
- TTL：默认值（600 秒）
使用子域名（如 www.example.com）
- 方法：添加 CNAME 记录
创建一条 CNAME 记录：- 主机名：
www（或自定义子域名） - 目标地址：
<你的用户名>.github.io
（octocat.github.io，不要包含仓库路径）
- 主机名：
步骤 3：验证 HTTPS（自动生效）
- GitHub 会自动为你的域名申请 Let’s Encrypt 证书（需等待几分钟至几小时）。
- 在 Pages 设置 中看到 Enforce HTTPS 可选时,勾选启用。
可选操作：同时支持根域名和 www
- DNS 配置：
- 根域名
example.com→ 按 选项一 配 A 记录。 - www 子域名
www.example.com→ 按 选项二 配 CNAME 记录。
- 根域名
- GitHub 设置：
- 在仓库的 Custom domain 栏填写
www.example.com（推荐用 www）。
- 在仓库的 Custom domain 栏填写
- 重定向根域名到 www（通过 DNS 服务商）：
- 在 DNS 中添加 URL 重定向（301）：
- 类型：
显性URL转发或Redirect - 来源：
example.com→ 目标：https://www.example.com
- 类型：
- 在 DNS 中添加 URL 重定向（301）：
常见问题
- DNS 生效慢：最长需 48 小时（通常几分钟生效），可用
dig example.com或在线工具检查。 - HTTPS 证书延迟：等待 GitHub 自动签发，失败时检查 DNS 是否正确。
- CNAME 文件冲突：GitHub 会自动生成
CNAME文件，无需手动添加（除非需要多个域名）。 - 仓库类型限制：
- 个人/组织站点：仓库名必须为
<用户名>.github.io。 - 项目站点：可位于任意仓库的
gh-pages分支或docs文件夹。
- 个人/组织站点：仓库名必须为
配置示例
DNS 记录（以 Cloudflare 为例）
| 类型 | 名称 | |
|---|---|---|
| A | 199.108.153 | |
| A | 199.109.153 | |
| A | 199.110.153 | |
| A | 199.111.153 | |
| CNAME | www |
octocat.github.io |
| 重定向 | example.com → https://www.example.com (301) |
完成以上步骤后，访问你的域名即可显示 GitHub Pages 内容，若遇到问题，可在 GitHub 仓库的 Settings → Pages 页面查看错误提示。
图片来源于AI模型，如侵权请联系管理员。作者：酷小编，如若转载，请注明出处：https://www.kufanyun.com/ask/288589.html
评论列表（5条）
看到这个标题第一反应是：终于能给我的代码小屋挂上门牌了！虽然步骤看着有点技术含量，但作者拆解得挺清晰的，比官方文档更有人味儿。 其实最戳中我的是那种微妙的仪式感——当你在浏览器里敲下自己名字的域名，跳转到亲手搭的页面时，那种“这片数字领土属于我”的掌控欲瞬间被满足。特别是绑定后看到小锁图标亮起https的时候，莫名想起给日记本扣上铜锁的童年。 不过每次操作dns都像在走高空钢丝，特别是等解析的那几十分钟，反复刷新到快把F5键按穿。作者要是能多写点翻车案例就好了，比如CNAME冲突时那种抓狂，或者域名服务商后台UI突然改版找不到入口的窒息感…这些血泪史反而让我觉得技术教程更真实。 说到底，GitHub Pages像块免费的自留地，而绑域名就是插了块亲手写的木牌子。下次或许该试试把404页面改成首小诗？反正技术宅的浪漫，就是把冷冰冰的代码变成带体温的创作。
@happy251er：哈哈你描述得也太有画面感了！给代码小屋挂牌子这个比喻我直接偷走了！每次等DNS解析确实像在产房外踱步，反复刷新到怀疑人生。其实CNAME冲突那次我差点把键盘吃了——后来发现是手滑多打了个点，这种蠢事果然没好意思写进教程里（捂脸）。把404改成诗这个点子太妙了，我这就去给404页面塞首打油诗！技术人的浪漫就是要在01世界里留下温度啊，握手握手～
@kind797lover：哈哈，太懂你了！每次等DNS我也急得抓狂，上次配置时手抖少了个斜杠，差点把显示器踹飞。404加诗这个点子超赞，技术人的温度就该藏在细节里～握手！
这篇文章的指南太实用了！作为一个编程新手，我之前在GitHub绑定域名时总卡住，但看完后按步骤操作，一次就成功了，感觉超有成就感。真心推荐给想尝试的人！
这篇文章真心实用！我之前绑定GitHub域名老卡在DNS设置上，现在读完豁然开朗，步骤清晰易懂，推荐给想建专业网站的朋友们。