GitLab私有项目如何通过浏览器直接打开作业制品？

API 探路者

2026-8-3

解决方案：私有自托管GitLab项目GitLab Pages无法打开制品HTML报告

问题原因

私有项目的作业制品默认需要用户认证才能访问，而GitLab Pages在直接引用制品链接时未携带认证信息，导致浏览器无法加载内容。

可行解决方法

1. 启用GitLab Pages访问控制（自托管实例专属）

编辑GitLab实例的/etc/gitlab/gitlab.rb配置文件，添加或修改以下配置：

pages_access_control = true

执行命令重新配置GitLab使设置生效：

sudo gitlab-ctl reconfigure

该配置会让GitLab Pages强制对私有项目内容进行权限校验，具备项目访问权限的用户就能正常打开制品中的HTML文件。

2. 将测试报告直接发布为GitLab Pages内容

修改.gitlab-ci.yml，新增一个pages作业，把测试报告文件复制到GitLab Pages默认的public目录并发布：

# 保留原有的制品归档配置
artifacts:
    name: ${TESTREPORT_TITLE}
    when: always
    paths:
        - ${ARTIFACT_REPORT}
    reports:
        junit: ${ARTIFACT_REPORT}${TESTREPORT_TITLE}.html.junit.xml
    expire_in: 60 days

# 新增pages作业发布测试报告
pages:
  stage: deploy
  when: always
  script:
    - mkdir -p public
    - cp -r ${ARTIFACT_REPORT}/* public/
  artifacts:
    paths:
      - public
    expire_in: 60 days

部署完成后，可通过项目的GitLab Pages域名直接访问测试报告，无需依赖制品链接。