GitLab Pages设置相对URL路径报错，求可行解决方案

GitLab官方确实限制Pages使用子URL路径（如/pages），但可以通过反向代理+内部端口转发的方式实现需求，具体步骤如下：

1. 调整GitLab配置文件（gitlab.rb） #

将Pages的外部URL改为域名根路径，同时指定独立的监听端口，避免和主GitLab服务冲突：

pages_external_url "https://my-domain.com"
gitlab_pages['enable'] = true
gitlab_pages['listen_port'] = 8090
gitlab_pages['external_http'] = ['0.0.0.0:8090']

修改完成后，重新配置GitLab：

gitlab-ctl reconfigure

2. 配置反向代理（以Nginx为例） #

在反向代理服务器（宿主机或Docker中的Nginx服务）中添加规则，将/pages路径的请求转发到GitLab容器的8090端口：

location /pages/ {
    proxy_pass http://<你的GitLab容器IP>:8090/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

如果使用Docker Compose，确保GitLab和Nginx在同一网络下，容器IP可直接用服务名代替。

3. 验证配置 #

• 重启Nginx服务和GitLab容器
• 访问https://my-domain.com/pages，确认Pages服务正常加载

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