脚本宝典收集整理的这篇文章主要介绍了GitHub Pages 自定义域名实践整理,脚本宝典觉得挺不错的,现在分享给大家,也给大家做个参考。
这篇博客将整理在配置博客以及项目 Pages 的自定义域名过程,遇到的问题以及解决方法。Github 的文档对于如何配置自定义域名有详细的介绍,这里不会全部翻译,只重点记录实践的过程,内容涉及为用户网站,公司网站,以及项目网站添加 APEx
域名(qiwihui.COM),二级域名(www.qiwihui.com)以及开启 HTTPS。最后,所有指向 www.qiwihui.com
的请求将会被重定向至 https://qiwihui.com
。
<!--more-->
一些注意
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
:
其中,选择 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.153
185.199.109.153
185.199.110.153
185.199.111.153
同时,设置 CNAME
记录将 www.qiwihui.com
指向 qiwihui.github.io
,即 <你的 github 用户名>.github.io
。对于公司来说,这个地址是 <公司名称>.github.io
。
@H_368_304@
确认 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
SSL(HTTPS)配置,强烈推荐开启
勾选 Enforce HTTPS
Github 会自动保持 HTTPS 证书的有效。
项目 Pages
当给项目设置 Pages 时,一般都已经有一个个人或者公司的 Pages 了,如果没有,就可以按以上的过程添加。如果已经设置了,则只需要很简单的两步即可:
以下以个人项目 [qiwihui/fullstackpython.com](https://github.com/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
。
一段时间后即可。
参考
以上是脚本宝典为你收集整理的GitHub Pages 自定义域名实践整理全部内容,希望文章能够帮你解决GitHub Pages 自定义域名实践整理所遇到的问题。
本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。
如您有任何意见或建议可联系处理。小编QQ:384754419,请注明来意。