怎么在GitHub绑定自定义域名 | GitHub自定义域名设置指南

要在 GitHub Pages 上设置自定义域名,请按以下步骤操作：

步骤 1：在 GitHub 仓库中配置域名

1. 进入你的 GitHub 仓库 → Settings → Pages

   （仓库需已启用 GitHub Pages，分支通常为 gh-pages、main 或 docs）。

2. 在 Custom domain 栏输入你的域名（如 example.com 或 www.example.com）→ Save。
3. （可选）勾选 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

1. DNS 配置：
   • 根域名 example.com → 按 选项一 配 A 记录。
   • www 子域名 www.example.com → 按 选项二 配 CNAME 记录。
2. GitHub 设置：
   • 在仓库的 Custom domain 栏填写 www.example.com（推荐用 www）。
3. 重定向根域名到 www（通过 DNS 服务商）：
   • 在 DNS 中添加 URL 重定向（301）：
     • 类型：显性URL转发 或 Redirect
     • 来源：example.com → 目标：https://www.example.com

常见问题

1. DNS 生效慢：最长需 48 小时（通常几分钟生效），可用 dig example.com 或在线工具检查。
2. HTTPS 证书延迟：等待 GitHub 自动签发，失败时检查 DNS 是否正确。
3. CNAME 文件冲突：GitHub 会自动生成 CNAME 文件，无需手动添加（除非需要多个域名）。
4. 仓库类型限制：
   • 个人/组织站点：仓库名必须为 <用户名>.github.io。
   • 项目站点：可位于任意仓库的 gh-pages 分支或 docs 文件夹。

配置示例

DNS 记录（以 Cloudflare 为例）

完成以上步骤后，访问你的域名即可显示 GitHub Pages 内容，若遇到问题，可在 GitHub 仓库的 Settings → Pages 页面查看错误提示。