GitHub Pages 自定义域名实践整理

这篇博客将整理在配置博客以及项目 Pages 的自定义域名过程，遇到的问题以及解决方法。Github 的文档对于如何配置自定义域名有详细的介绍，这里不会全部翻译，只重点记录实践的过程，内容涉及为用户网站，公司网站，以及项目网站添加 Apex 域名（qiwihui.com），二级域名（www.qiwihui.com）以及开启 HTTPS。最后，所有指向 www.qiwihui.com 的请求将会被重定向至 https://qiwihui.com。

一些注意

Github 支持的自定义域名类型

支持的自定义域名类型	域名例子
www subdomain	`www.example.com`
one apex domain & one www subdomain	`example.com` & `www.example.com`
apex domain	`example.com`
custom subdomain	`blog.example.com`

GitHub Pages 站支持的域名

GitHub Pages 站类型	在 Github 上 Pages 的默认域名和主机地址	页面被如何重定向	自定义域名举例
User Pages 站	`username.github.io`	自动重定向到设置的自定义域名	`user.example.com`
Organization Pages 站	`orgname.github.io`	自动重定向到设置的自定义域名	`org.example.com`
用户拥有的 Project Pages 站	`username.github.io/projectname`	自动重定向到 User Pages 站自定义域名的子目录（`user.example.com/projectname`）	`project.example.com`
公司拥有的 Project Pages 站	`orgname.github.io/projectname`	自动重定向到 Organization Pages 站自定义域名的子目录（`org.example.com/projectname`）	`project.example.com`

以个人 Pages 项目为例子

开启 Github Pages 功能

在项目 Settings 中，找到 GitHub Pages 这一区域，选择 Source 为对应的要部署的分支，这里我选择 gh-pages branch：

gh-pages

其中，选择 master branch 会视 /README.md 为 web 的 index.html，选择 master branch /docs folder 会视 /docs/README.md 为 web 的 index.html。

在项目配置中自定义域名

在 Custom domain 中添加自己的域名并保存：

custom-domain

或者，在项目分支中添加 CNAME 文件，CNAME 文件的内容为

qiwihui.com

这里推荐第二种，尤其对于有设置 CI 的项目，因为 CI 上将第一种设置覆盖。这一步是比较重要却又容易忽视的一步：

如果添加到 GitHub Pages 中的是 qiwihui.com，那么 www.qiwihui.com 会被重定向到 qiwihui.com；
如果添加到 GitHub Pages 中的是 www.qiwihui.com，那么 qiwihui.com 会被重定向到 www.qiwihui.com；

这里我选择重定向到 www.qiwihui.com，所以设置为 qiwihui.com

添加 DNS 记录

为了能设置Apex 域名，需要在 DNS 中配置 A 记录指向 github 的 IP：

185.199.108.153
185.199.109.153
185.199.110.153
185.199.111.153

a-record

同时，设置 CNAME 记录将 www.qiwihui.com 指向 qiwihui.github.io，即 <你的 github 用户名>.github.io。对于公司来说，这个地址是 <公司名称>.github.io。

www-record

确认 DNS 记录

以下是设置好之后的 DNS 记录情况：

$ dig +noall +answer qiwihui.com
qiwihui.com.            60      IN      A       185.199.111.153
qiwihui.com.            60      IN      A       185.199.110.153
qiwihui.com.            60      IN      A       185.199.108.153
qiwihui.com.            60      IN      A       185.199.109.153

$ dig www.qiwihui.com +nostats +nocomments +nocmd 

; <<>> DiG 9.10.6 <<>> www.qiwihui.com +nostats +nocomments +nocmd
;; global options: +cmd
;www.qiwihui.com.               IN      A
www.qiwihui.com.        28      IN      CNAME   qiwihui.github.io.
qiwihui.github.io.      28      IN      A       185.199.110.153
qiwihui.github.io.      28      IN      A       185.199.108.153
qiwihui.github.io.      28      IN      A       185.199.111.153
qiwihui.github.io.      28      IN      A       185.199.109.153