Home
img of docs

掌握如何为你的GitHub Pages项目配置自定义域名,让网站更具专业性和品牌感。

chou403

/ GitHub

/ c:

/ u:

/ 3 min read

一学一个不吱声

要将 GitHub Pages 和阿里云域名连接起来,您需要进行以下步骤:

1. 在 GitHub 上配置自定义域名

  1. 打开您的 GitHub 仓库页面,进入 Settings。
  2. 向下滚动到 Pages 章节,找到 Custom Domain,并输入您的自定义域名(如 example.com 或 www.example.com)。
  3. 保存后,GitHub 会自动生成两个 DNS 记录(CNAME 或 A 记录)来验证域名的归属。

2. 在阿里云域名控制台配置 DNS

  1. 登录到 阿里云控制台 并进入 域名与网站 > 域名。
  2. 选择您的域名,进入 解析设置。
  3. 根据 GitHub 提供的 DNS 配置,添加以下解析记录:
    • 如果 GitHub 提供了 CNAME 记录,则添加一条 CNAME 记录,将 www 子域名指向 username.github.io,将主机记录设为 www 或空白(对应裸域),记录类型设为 CNAME。
    • 如果 GitHub 提供了 A 记录,则添加两条 A 记录,指向 GitHub 提供的 IP 地址(一般是 185.199.108.153,185.199.109.153,185.199.110.153 和 185.199.111.153)。确保主机记录对应的是裸域名或 www。

3. GitHub Pages 设置 HTTPS(可选)

返回 GitHub 仓库的 Settings > Pages 页面,确认 Enforce HTTPS 被勾选。GitHub 会自动为您设置 HTTPS 证书,通常会在一段时间后生效。

4. GitHub Pages 执行工作流配置 Domain

github 执行工作流会重置配置,会把设置的 domain 清除,若需要每次执行工作流默认添加 domain,修改 .github/workflows 中的配置文件内容

   - name: Deploy to GitHub Pages
  uses: peaceiris/actions-gh-pages@v4
  with:
    personal_token: ${{ secrets.GITHUB_TOKEN }}
    publish_dir: ./dist
    publish_branch: docs
    cname: uchou.me ## 添加自定义域名,自动在 docs 分支生成 cname 文件
    force_orphan: true

出现异常 can’t open the page “https://uchou.me/. The error is: “Load cannot follow more than 20 redirections”

检查 Cloudflare 的 SSL/TLS 设置

  • 在 Cloudflare 的 SSL/TLS 设置中,确保 SSL 设置为”灵活(Flexible)“或”完全(Full)“。通常,“灵活”会导致不必要的重定向循环。尝试使用”完全”并确保您的 GitHub Pages 已启用 HTTPS。
#github