如何为GitLab Pages实例配置根页面（root page）？

一、修复根域名重定向异常 #

你遇到的https://pages.example.com多次重定向到带大量斜杠的地址，大概率是GitLab Pages默认根路由配置缺失导致的，可通过以下两种方式修复：

• 方式1：利用GitLab Pages根项目映射
  在GitLab中创建一个顶级项目（不属于任何组，直接归属实例根用户），命名必须和你的Pages根域名完全一致（即pages.example.com）。启用该项目的Pages功能，部署一个静态页面（比如简单的index.html），访问根域名时会直接加载这个项目的Pages内容，同时解决重定向问题。
• 方式2：反向代理层配置跳转
  如果你的GitLab Pages前端有Nginx等反向代理，可在代理配置中添加根路径规则：

  server {
    listen 443 ssl;
    server_name pages.example.com;
    # 保留原有SSL配置...
  
    location = / {
      # 跳转到指定的默认Pages页面
      return 301 https://pages.example.com/your-group/your-default-project;
      # 也可直接返回自定义静态页面
      # root /path/to/your/local/static-root-page;
      # index index.html;
    }
  
    # 保留原有GitLab Pages代理配置...
  }
  

二、配置类似pages.gitlab.io的实例级跳转 #

若要实现类似pages.gitlab.io的跳转效果，可结合上述方法：

1. 通过方式1创建根域名对应的顶级项目，部署一个导航页面，列出实例内所有公开的Pages项目；
2. 或在反向代理层直接配置根路径跳转到实例内的默认组/项目Pages页面，参考上述Nginx的301跳转规则。

三、注意事项 #

• 确保GitLab版本为11.0及以上（该版本开始支持顶级项目的Pages映射）；
• 使用反向代理方案时，需保证代理配置和GitLab Pages内部路由无冲突；
• 配置完成后清理浏览器缓存再测试，避免旧重定向缓存干扰结果。

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