GitLab Plain HTML模板部署流水线后无法访问问题求助
GitLab Pages无法访问的排查方案
- 检查流水线状态:进入项目的CI/CD > 流水线页面,确认部署Pages的流水线是否成功跑完。如果流水线失败,查看日志里的错误细节,比如构建脚本是否报错、public目录是否正确生成。
- 验证域名解析:你的访问地址
http://example-group.swaggerui-poc.abc.com/gitlab-pages-plain-html属于自定义内部域名,需要确认DNS服务器已配置该域名的A/CNAME记录,指向GitLab Pages服务器的IP。可以用nslookup example-group.swaggerui-poc.abc.com命令测试解析是否生效。 - 确认访问权限:在Settings > Pages里,检查页面的访问权限设置。如果设为“Only project members”,访问时必须登录有权限的GitLab账号;如果要公开访问,需改为“Everyone”。
- 核对public目录结构:确保
index.html直接放在public根目录下(即public/index.html),而非嵌套子文件夹。如果文件路径不对,GitLab Pages找不到默认首页。 - 本地验证页面:把public目录的文件在本地浏览器打开,确认index.html本身能正常显示,排除页面自身的语法或资源加载问题。
- 检查GitLab实例配置:如果是企业自托管GitLab,联系管理员确认Pages功能已开启,且服务器(如Nginx)的反向代理配置正确,能正常路由Pages请求。
内容的提问来源于stack exchange,提问作者Kai
相关产品推荐
相关产品推荐

