GitHub Pages 自定义域名实践整理

这篇博客将整理在配置博客以及项目 Pages 的自定义域名过程，遇到的问题以及解决方法。Github 的文档对于如何配置自定义域名有详细的介绍，这里不会全部翻译，只重点记录实践的过程，内容涉及为用户网站，公司网站，以及项目网站添加 Apex 域名（qiwihui.com），二级域名（www.qiwihui.com）以及开启 HTTPS。最后，所有指向 www.qiwihui.com 的请求将会被重定向至 https://qiwihui.com。<!–more–>一些注意Github 支持的自定义域名类型支持的自定义域名类型域名例子www subdomainwww.example.comone apex domain & one www subdomainexample.com & www.example.comapex domainexample.comcustom subdomainblog.example.comGitHub Pages 站支持的域名GitHub Pages 站类型在 Github 上 Pages 的默认域名和主机地址页面被如何重定向自定义域名举例User Pages 站username.github.io自动重定向到设置的自定义域名user.example.comOrganization 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：其中，选择 master branch 会视 /README.md 为 web 的 index.html，选择 master branch /docs folder 会视 /docs/README.md 为 web 的 index.html。在项目配置中自定义域名在 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.153185.199.109.153185.199.110.153185.199.111.153同时，设置 CNAME 记录将 www.qiwihui.com 指向 qiwihui.github.io，即 <你的 github 用户名>.github.io。对于公司来说，这个地址是 <公司名称>.github.io。确认 DNS 记录以下是设置好之后的 DNS 记录情况：$ dig +noall +answer qiwihui.comqiwihui.com. 60 IN A 185.199.111.153qiwihui.com. 60 IN A 185.199.110.153qiwihui.com. 60 IN A 185.199.108.153qiwihui.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 Awww.qiwihui.com. 28 IN CNAME qiwihui.github.io.qiwihui.github.io. 28 IN A 185.199.110.153qiwihui.github.io. 28 IN A 185.199.108.153qiwihui.github.io. 28 IN A 185.199.111.153qiwihui.github.io. 28 IN A 185.199.109.153SSL（HTTPS）配置，强烈推荐开启勾选 Enforce HTTPSGithub 会自动保持 HTTPS 证书的有效。项目 Pages当给项目设置 Pages 时，一般都已经有一个个人或者公司的 Pages 了，如果没有，就可以按以上的过程添加。如果已经设置了，则只需要很简单的两步即可：以下以个人项目 qiwihui/fullstackpython.com，设置地址为 fullstackpython.qiwihui.com在项目中开启 Github Pages，并添加 CNAME 文件指向 fullstackpython.qiwihui.com：在 DNS 记录中添加 CNAME 记录将 fullstackpython.qiwihui.com 指向 qiwihui.github.io，即 <你的 github 用户名>.github.io。对于公司来说，这个地址是 <公司名称>.github.io。一段时间后即可。参考Using a custom domain with GitHub PagesCustom domain redirects for GitHub Pages sitesCustom domain for GitHub project pages 的回答Custom subdomains in GitHub project pages