GitHub Pages域名绑定(2019)
2018年5月,谷歌放出.app顶级域名,随手在GoDaddy注册了 chenqi.app,想着未来可以把一些开源小项目归档在这里。
拖延症半年......上周末花了一点时间搭建完成。基本遵循https://pages.github.com/的帮助文档即可。
- 在GitHub个人账号下新建一个与账号名称相同的仓库:9468305.github.io。
- 进入仓库的
Setting
配置页面。
- GitHub会自动识别为Pages,简单的配置一下。勾选确认
Source
,master branch
。 - 偷懒直接使用
Jekyll
,在Theme Chooser
选择一个喜欢的主题风格。 -
Custom domain
填入chenqi.app
,保存。 - 最后勾选
Enforce HTTPS
,启用HTTPS。
稍等几分钟就可以用浏览器成功访问 https://9468305.github.io。
- 在GoDaddy配置域名
GitHub推荐尽量优先使用ALIAS
或ANAME
。所以根据这个文档 setting-up-an-apex-domain 配置如下:
类型 | 名称 | 值 | TTL |
---|---|---|---|
A | @ | 185.199.108.153 | 1 小时 |
A | @ | 185.199.109.153 | 1 小时 |
A | @ | 185.199.110.153 | 1 小时 |
A | @ | 185.199.111.153 | 1 小时 |
顺便再配置CNAME
:
类型 | 名称 | 值 | TTL |
---|---|---|---|
CNAME | www | 9468305.github.io | 1 小时 |
- 使用浏览器测试 chenqi.app 已经可以成功访问。但www.chenqi.app的SSL证书始终显示错误。
咨询了 GitHub Support 团队,回复如下:
Thanks for reaching out about this! We don't currently support creating a certificate that covers both your root domain and your
www
subdomain. We only generate a certificate for the exact domain that you specify in the custom domain input box. I will add your +1 to that feature request internally though!
In the meantime you can work around this by pointing yourwww
subdomainCNAME
at[username.github.io](http://username.github.io/)
, and entering the non-www version of your domain into the input in the repository settings.
Keep in mind that this redirect will only work when using a protocol-less or http:// link. If you explicitly specify https://www.example.com you will still likely encounter a certificate error.
- Troubleshooting
- Chrome,Safari可能提示SSL证书不被信任。耐心等待半小时。因为GitHub后台会触发一个Job,添加自定义域名至SSL证书中,同步证书信息需要一段时间。
- Chrome,Safari可能提示SSL证书错误
NET::ERR_CERT_COMMON_NAME_INVALID
,继续耐心等待半小时。 如果很长时间都没有生效,那么回到前面第二步,在GitHub Pages仓库的设置页面,删除Custom domain
和Enforce HTTPS
,再重新添加一遍。这样可以再次触发GitHub后台Job。
- Finally
可以开始编写markdown内容了。