目前 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 等不同静态网站生成工具和主题,就可以轻松打造出一个酷炫的个人站点/博客了。