GeoServer Web UI经Nginx反向代理后重定向至HTTP问题排查

这是GeoServer 2.21.x版本的典型反向代理适配缺陷，核心问题出在内置Wicket Web框架的重定向逻辑优先级上：

• Wicket作为Web UI的底层框架，其初始页面跳转逻辑执行顺序早于GeoServer全局配置加载、CSRF校验等业务逻辑，既不会读取用户配置的Proxy Base URL参数，也不会默认识别反向代理传递的X-Forwarded-Proto协议头，只会直接读取后端服务收到的原始请求协议。
• 由于Nginx反向代理到后端GeoServer时走的是HTTP协议，Wicket生成首页跳转地址时会硬编码HTTP前缀，直接返回http://myserver/geoserver/web/?0的跳转响应，后续的CSRF校验、代理URL替换逻辑根本不会触发，因此提前配置CSRF白名单、开启Use headers for Proxy URL选项都无法解决该问题。
• 地图瓦片、OWS服务接口不经过Wicket的跳转逻辑，会正常走GeoServer的服务层代理地址适配流程，因此这部分功能可以正常响应。

按以下步骤操作即可解决问题，无需升级GeoServer版本：

1. 配置GeoServer启动参数，强制Wicket识别反向代理头
   如果你用的是独立版GeoServer（自带Jetty容器），找到安装目录下的start.ini文件，在JVM启动参数区块追加以下两行配置：

   -Dorg.apache.wicket.protocol.http.servlet.ServletWebRequest.forceForwardedHeader=true
   -Djetty.httpConfig.forwardedProtocolHeader=X-Forwarded-Proto
   

   保存文件后重启GeoServer服务，Wicket会优先读取反向代理传递的协议头生成跳转地址。
2. 修正Nginx反向代理配置
   原配置的根路径匹配容易出现路径转发、地址替换偏差，调整为GeoServer专属路径匹配规则，同时补充协议跳转替换逻辑，参考配置如下：

   location /geoserver/ {
       proxy_pass http://127.0.0.1:9191/geoserver/;
       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-Host $host;
       proxy_set_header X-Forwarded-Server $host;
       proxy_set_header X-Forwarded-Port $server_port;
       proxy_set_header X-Forwarded-Proto $scheme;
       proxy_redirect http://$host/ https://$host/;
   }
   

   保存配置后执行nginx -t校验语法无误，执行nginx -s reload重载配置即可。
3. 验证前清空浏览器缓存，避免之前缓存的302跳转响应影响测试结果。

内容的提问来源于stack exchange，提问作者Blake M.