目前 Github
和 Gitee码云
都提供了基于 Jekyll
、Hugo
、Hexo
的在线Pages服务,本文将记录分享 Gitee Pages Pro
的使用经历和体验。
- 平台:码云 Gitee.com
- 服务:
Pages Pro
Gitee Pages 功能介绍
Gitee Pages
是面向码云用户开放的静态页面搭建托管服务,用户可以通过默认提供的域名 gitee.io
来发布自己的站点。
目前,Gitee Pages 已支持 Jekyll
、Hugo
、Hexo
等静态网站生成引擎,可以很方便的在线编译这几类静态站点项目。当然,原始的HTML也是支持的。
Gitee Pages Pro
是支持自定义域名版本的 Gitee Pages
。目前在码云GVP、码云推荐项目和码云付费企业版中可以免费使用。
开启 Gitee Pages
以个人开源的 码云博客小程序 为例,通过「项目主页」->「服务」->「Gitee Pages」打开 Gitee Pages
服务。默认操作下直接点击「启动」并确认,即可开启服务。
Gitee Pages 配置选项介绍
- 部署分支:用于部署
Pages
的分支 - 部署目录:自定义
Pages
源文件的目录 - 个性域名:用户自定义域名,需要解析
CNAME
到gitee.gitee.io
生效后使用 - 配置域名证书:用于配置自定义域名
HTTPS 证书
- 启动/暂停:启动/暂停
Gitee Pages
服务
对于一个项目来说,项目的 Pages 可能存在于不同的分支上, 或存在于某个分支的二级目录。比如「docs」、「pages」目录等。
通过指定部署分支和部署目录,我们就可以很方便的完成 Pages 的自定义部署。
申请HTTPS证书 & 解析域名 CNAME
为了让我们的网站支持 HTTPS
访问,我们需要申请一个 HTTPS
证书。当然,我们首先还是要有一个域名:)
在这里我们使用的是 Freessl 提供的免费 SSL
服务。访问 Freessl ,在首页输入自己的域名,此处可以根据使用需求选择证书的类型。
以 Let's Encrypt V2
为例,在输入申请域名后,点击「创建」按钮,进入下一步。
输入签发证书的接收邮箱,自行选择证书的类型、验证方式和CSR文件生成方式后,点击创建。
如果是使用浏览器创建 CSR
文件,务必保存好生成后下载的私钥文件。点击创建后,需要验证相关域名的 DNS
信息。
按照要求修改了域名 DNS
并解析对应的TXT记录后,可以点击「配置完成,检测一下」验证一下解析是否正确配置。如果在弹出页面出现了下图的检测内容,就说明解析完成了。
此时可以点击「点击验证」完成验证。完成验证后就可以得到一份有效的 HTTPS
证书。
将对应的证书、私钥粘贴到 Gitee Pages
的证书设置位置,点击「提交」后并重新部署,确认将域名 CNAME
成功解析到 gitee.gitee.io
后,即可通过自己的域名正常访问网站。
最终效果如下:
总结
通过 上传代码
->申请证书
->域名解析
->部署 Gitee Pages
四个步骤,我们用 Gitee Pages
部署一个支持 HTTPS
的静态网站。除此之外,通过选择 Jekyll
、Hugo
、Hexo
等不同静态网站生成工具和主题,就可以轻松打造出一个酷炫的个人站点/博客了。