GitLab Pages

GitLab Pages 是代码托管平台 GitLab 提供的免费静态网站托管服务，可以把仓库中的代码通过 CI/CD 流水线自动构建成静态网页并对外发布。

概述

GitLab Pages 的定位与 GitHub Pages 类似：开发者把网站源码（纯 HTML，或 Hugo、Hexo、Jekyll、VitePress 等静态网站生成器项目）推送到 GitLab 仓库，平台就会自动构建并托管成一个可公开访问的网站，常用于搭建个人博客、项目主页、开源文档和简历页。

它的部署方式深度绑定 GitLab 自家的 CI/CD 体系：在仓库根目录编写 .gitlab-ci.yml 配置文件，定义一个名为 pages 的任务，把构建产物输出到 public 目录，流水线跑完后网站即自动上线。网站默认使用 gitlab.io 下的子域名，也可以绑定自己的域名，并通过集成的 Let's Encrypt 自动签发免费 HTTPS 证书。

主要特点

• 免费托管：在 GitLab.com 上使用无需付费，适合个人博客与开源项目文档。
• CI/CD 驱动：构建流程由流水线定义，几乎支持任何静态网站生成器，自由度高。
• 自定义域名与 HTTPS：可绑定自有域名，自动申请和续期 SSL 证书。
• 访问控制：可将页面设为仅项目成员可见，适合托管团队内部文档，这是它相对 GitHub Pages 的特色功能。
• 支持自建实例：私有化部署的 GitLab 同样可以启用 Pages 功能。

与 GitHub Pages 的区别

两者都是「代码仓库 + 静态托管」的组合，但 GitLab Pages 的构建完全走通用 CI/CD，任何构建工具都能用，配置更灵活；同时提供页面级访问控制和私有化部署能力。GitHub Pages 则胜在生态和访问知名度。需要注意的是，gitlab.io 域名在中国大陆的访问速度和稳定性一般，面向国内读者的站点建议绑定自有域名并搭配 CDN。

常见问题

问：GitLab Pages 收费吗？答：在 GitLab.com 上托管静态网站本身免费，只是构建要消耗账户的 CI/CD 流水线额度，个人博客的用量通常绰绰有余。

问：可以托管带后端的动态网站吗？答：不可以。它只托管纯静态文件（HTML、CSS、JS），不支持运行 PHP、Node.js 等服务端程序，动态功能需借助第三方接口实现。

问：部署后网站打不开怎么办？答：先确认流水线任务名为 pages 且构建产物输出在 public 目录，再检查项目的 Pages 设置和域名解析是否正确，首次部署生效可能需要等待几分钟。