Gitlab Pages 使用自定义域名和https

开启属于你的 Gitlab Pages

  1. 首先你得有一个 gitlab 账号,没有请到 Gitlab 申请。
  2. 到这个页面 https://gitlab.com/pages 选择一个项目作为模板,例如 Hexo , 点击 Fork
  3. 这时你的 projects 中就创建了一个 Hexo 的副本。
  4. 进入你的项目,点击 设置 –> Advanced settings 找到 Remove fork relationship 删除 fork 关系。
  5. 找到 Rename repository设置为自己的 namespace.gitlab.io
  6. 进入你的项目点击 设置 –> CI/CD,开启共享 Runner
  7. 点击 CI/CD ,点击 Run Pipline ,这里会根据项目中的 .gitlab-ci.yml 文件进行部署

  8. 故障排除:通过浏览器访问 namespace.gitlab.io,这里缺少 CSS 样式

    修改项目中的 _config.yml 文件,修改提交后,会重新运行,右上角会有图标显示,等运行完后,即可正常访问

最后可以将你的hexo项目clone到本地,进行修改后提交。

相关参考文档:
https://docs.gitlab.com/ee/user/project/pages/index.html
https://about.gitlab.com/features/pages/
https://gitlab.com/pages/hexo

申请 SSL 证书

  1. 免费的域名证书申请平台:

  2. freessl.org 操作比较简单,适合入门

  3. 点击创建后,会让你到域名控制台,建一个类型为 TXT 的解析,验证通过后会生成 CA证书 证书公钥 以及 私钥,注意,一定要将私钥用文本保存下来,谨防丢失。

  4. 最后可以到控制台将证书下载下来保存。
  5. 最终的访问效果

特别说明:国内的网络访问 gitlab Pages 可能会出现无法访问的情况,需要通过一些特殊方式。

绑定自定义域名

  1. 点击 设置 –> Pages –> New Domain,填写自己的域名和证书信息。
  2. 到你的域名控制台,添加两条记录
    CNAME namespace.gitlab.ui
    TXT 提供的 Verification status


    修改完后点击重新验证按钮

  3. 点击 设置 –> Pages ,能看到如下信息
  4. 最后通过自定义域名镜像访问。

    这里遇到一个问题,浏览器显示的证书并不是我申请的证书,我弄了半天也没弄好。
    不用担心,大概等一个小时,等gitlab通过后,访问的就是自己的证书