首页/开发/CI/CD 与发布速查/GitLab Pages 静态发布
工具链要点63 条

GitLab Pages 静态发布

用 pages 作业发布静态站点:产物放到约定目录后由 Pages 服务托管,适合文档站、演示站点与前端预览。

CI/CD 与发布速查开发更新于 2026-10-12
产物job 名为 pages 或声明 pages 的作业产出 public/ 目录
分支通常只在默认分支或受保护分支发布
域名支持默认域名与自定义域名
预览可按分支发布预览站点

Pages 作业

Pages 作业
pages:
  stage: deploy
  script:
    - mkdir -p public
    - cp -r dist/* public/
  artifacts:
    paths: [public]
  rules:
    - if: '$CI_COMMIT_BRANCH == "main"'
发布目录与站点路径要对齐:产物路径写错时站点 404,但流水线显示成功。

易错点

  • 发布不在受保护分支上做:任何分支都能覆写线上站点
  • 把 secrets 打进静态产物:前端构建的环境变量要区分公开与敏感

数据来源与参考

  • GitLab Docs《GitLab Pages》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌