如何正确配置激活内网部署的GitLab Pages服务？

核心问题定位 #

你当前配置中gitlab_pages['pages_external_url']字段缺少协议前缀，是导致URL生成规则不符合预期的直接原因。
当前配置值为pages.domain.xyz，GitLab无法识别该域名对应的服务协议，会错误拼接路径生成异常URL。

修复步骤 #

1. 修正gitlab.rb配置 #

找到gitlab_pages['pages_external_url']配置项，补全协议头，如果你部署HTTPS服务则修改为：

gitlab_pages['pages_external_url'] = "https://pages.domain.xyz"

如果仅部署HTTP服务则替换为http://pages.domain.xyz，协议头必须和实际对外提供服务的协议一致，不可省略。

可选配置调整：

• 若你期望Pages访问路径格式为https://pages.domain.xyz/<用户名>/<项目名>而非默认的子域名格式https://<用户名>.pages.domain.xyz/<项目名>，额外添加配置：

  gitlab_pages['namespace_in_path'] = true
  

• 已配置正确的pages_external_url后，可删除external_http、external_https、gitlab_server这几个配置项，使用默认值即可，避免手动指定监听地址、服务地址导致的配置冲突。

2. 重载配置生效 #

修改完成后依次执行以下命令让配置生效：

# 重载所有GitLab服务配置
sudo gitlab-ctl reconfigure

# 重启GitLab Pages服务
sudo gitlab-ctl restart gitlab-pages

3. 服务可用性校验 #

• 首先访问Pages内置状态地址https://pages.domain.xyz/@status，如果正常返回JSON格式的服务状态信息，说明Pages服务本身启动正常。
• 回到项目的Pages设置页面，此时展示的访问URL会恢复为符合规则的格式。
• 校验DNS解析：你现有DNS配置（主实例A记录、pages根域名A记录、*.pages泛域名A记录）符合要求，只需在内网客户端确认上述域名都能正确解析到GitLab服务所在IP即可。

后续排查方向 #

如果配置完成后仍无法正常访问，按以下顺序排查：

• 检查服务器防火墙、内网安全策略是否放行了80、443端口的入站流量
• 确认配置的SSL证书包含*.pages.domain.xyz泛域名匹配规则，避免子域名访问时出现证书不信任错误
• 执行sudo gitlab-ctl tail gitlab-pages查看Pages服务实时日志，定位具体报错信息

内容的提问来源于stack exchange，提问作者JMNSTYLZ