Nginx反向代理SonarQube跳转至项目页而非登录页的解决咨询

问题场景 #

服务器部署Nginx，Docker容器内运行SonarQube服务，当前Nginx配置如下：

upstream sonarqube {
  server 127.0.0.1:9000 fail_timeout=0;
}

server {
  listen 80;
  server_name sonarqube.mydomain.com;
  return 301 https://$host$request_uri;
}

server{
  server_name sonarqube.mydomain.com;
  listen 443 ssl;

  ssl_certificate /etc/ssl/certificates/server.crt;
  ssl_certificate_key /etc/ssl/certificates/server.key;

  access_log /var/log/nginx/sonarqube.access.log;
  error_log /var/log/nginx/sonarqube.error.log;

  location / {
    proxy_set_header        Host $host:$server_port;
    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;
    proxy_pass              http://sonarqube;
    # Required for new HTTP-based CLI
    proxy_http_version 1.1;
    proxy_request_buffering off;
    proxy_buffering off; # Required for HTTP-based CLI to work over SSL
  }
}

访问sonarqube.mydomain.com时，页面自动跳转至sonarqube.mydomain.com/projects而非登录页，需配置实现访问域名直接跳转登录页。

解决方案 #

方法一：修改Nginx配置 #

在HTTPS的server块中新增精确匹配根路径的location规则，将根路径请求直接重定向到登录页：

server{
  server_name sonarqube.mydomain.com;
  listen 443 ssl;

  ssl_certificate /etc/ssl/certificates/server.crt;
  ssl_certificate_key /etc/ssl/certificates/server.key;

  access_log /var/log/nginx/sonarqube.access.log;
  error_log /var/log/nginx/sonarqube.error.log;

  # 精确匹配根路径，重定向到登录页
  location = / {
    return 302 https://$host/login;
  }

  location / {
    proxy_set_header        Host $host:$server_port;
    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;
    proxy_pass              http://sonarqube;
    # Required for new HTTP-based CLI
    proxy_http_version 1.1;
    proxy_request_buffering off;
    proxy_buffering off; # Required for HTTP-based CLI to work over SSL
  }
}

修改后重启Nginx服务：

nginx -s reload

此方式通过Nginx直接拦截根路径请求，强制跳转到登录页，无需修改SonarQube内部配置。

方法二：修改SonarQube配置（Docker环境） #

SonarQube支持通过配置参数指定根路径跳转目标，在Docker容器中可通过两种方式实现：

1. 使用环境变量启动容器：
   在docker run命令中添加环境变量：

   docker run -d \
     -e SONAR_WEB_ROOTREDIRECTTO=/login \
     # 保留原有端口映射、挂载卷等参数
     sonarqube:latest
   

2. 挂载自定义配置文件：
   复制容器内的sonar.properties到本地，添加以下配置项：

   sonar.web.rootRedirectTo=/login
   

   将修改后的文件挂载到容器默认配置路径（/opt/sonarqube/conf/sonar.properties），重启容器即可。

此方式通过SonarQube自身配置控制跳转逻辑，适合需要统一管理应用行为的场景。

内容的提问来源于stack exchange，提问作者Bilge Kaan Gençdoğan