Nginx反向代理环境下Apache Guacamole共享磁盘上传权限异常问题排查求助

兄弟，你这个情况我碰到过好几次——直接连Guacamole的时候共享磁盘传文件啥事没有，一经过Nginx反向代理就报权限错误，偏偏其他功能都正常，这大概率是Nginx的配置漏了点东西！结合你给的配置片段，我给你列几个最该先查的点：

• 先补全Nginx的location转发规则
  你贴出来的配置只有upstream和server的基础监听配置，完全没写处理/guacamole路径的location规则啊！Nginx根本不知道该把请求转发到后端的Guacamole服务路径上，这很可能是核心问题。赶紧在server块里加上这段：

  location /guacamole/ {
      proxy_pass http://GUACAMOLE/guacamole/;
      proxy_set_header X-Forwarded-For $remote_addr;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_set_header Host $host;
  
      # Guacamole依赖WebSocket，必须加这段配置
      proxy_http_version 1.1;
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection $connection_upgrade;
      proxy_read_timeout 86400;
  }
  

  另外记得在Nginx的http块里提前定义connection_upgrade变量，不然会报错：

  http {
      # 其他原有配置...
      map $http_upgrade $connection_upgrade {
          default upgrade;
          '' close;
      }
  }
  

• 检查Nginx的客户端上传大小限制
  Nginx默认的client_max_body_size只有1M，要是你传的文件超过这个大小，Nginx会直接拦截请求，有些场景下错误提示会被误导成“权限不足”。在server块里加上合适的大小限制：

  client_max_body_size 100M; # 可以根据你实际上传需求调整数值
  

• 查看日志找细节
  要是上面两步做完还不行，就去翻日志找线索：

  • 看Nginx的错误日志（一般在/var/log/nginx/error.log），有没有上传时的请求拦截、大小超限之类的报错；
  • 看Guacamole的日志（比如Tomcat的catalina.out或者Guacamole的专属日志），确认后端有没有收到上传请求，有没有真实的权限报错信息。

• 最后再排除一下目录权限（概率较低）
  虽然你直接连接正常，但还是可以确认下Guacamole服务器上的上传临时目录（通常在/var/lib/guacamole/或者配置文件指定的路径）权限，确保运行Guacamole的用户（比如tomcat用户）有读写权限，避免代理过来的请求因为用户上下文问题触发权限限制。

备注：内容来源于stack exchange，提问作者Benoît