要在 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
