💻 FastGPT 升级后非要用 MinIO 存附件给大模型，结果文件上传一直失败，NPM 反代差点把我逼疯！

最近我把 FastGPT 升级了，这玩意儿是个 AI Agent 构建平台，能搞数据处理、模型调用，还能可视化编排工作流，挺酷的。结果新版本更新后，它居然搞了个 MinIO 附件存储的特性。说实话，我个人还是喜欢老老实实地用本地文件存储，简单又方便，非要整这些乱七八糟的，简直是增加复杂度。但既然它这么搞了，我也只能硬着头皮去部署 MinIO，然后用我的 Nginx Proxy Manager (NPM) 给它套了个反向代理，还顺手开了 HTTPS，想着至少能让 FastGPT 正常传个文件给大模型用吧。

结果呢？啪！打脸了！

我兴冲冲地在 FastGPT 里上传文件，小文件大文件都试了，结果全都给我蹦出个“Failed to create post presigned url”！我擦，这什么情况？MinIO 后台看了，没毛病啊，NPM 也显示跑得好好的，文件就是死活传不上去。那几天真是给我愁坏了，头都大了！

后来我硬着头皮，一点点地抠，终于把 FastGPT 往 MinIO 上传文件的这破事儿给搞定了！今天就跟你好好说说，我这趟“填坑”之旅，希望能帮你避开这些雷。

我的家底儿：MinIO 和 NPM，全 Docker 走起！

我的服务器上，MinIO 和 NPM 都是用 Docker 跑的。

1. MinIO 的 Docker 配置，这俩地方太重要了！

这是我的 docker-compose.yaml，MinIO 的配置：

services:
  minio:
    image: 'minio/minio:RELEASE.2025-04-22T22-12-26Z'
    network_mode: bridge
    restart: unless-stopped
    ports:
      - '9001:9001' # MinIO Console 端口，我映射到宿主机 9001 了
      - '9000:9000' # MinIO API 端口，我映射到宿主机 9000 了
    extra_hosts:
      - minio.mydomain.com:127.0.0.1 # 划重点！让 MinIO 知道它自己是谁
      - api.mydomain.com:127.0.0.1   # 同上，API 域名也得让它认识
    volumes:
      - /minio/data:/data # 数据都扔这儿
    environment:
      - MINIO_DATA_DIR=/data
      - MINIO_ROOT_USER=myusername # 我的管理员名
      - MINIO_ROOT_PASSWORD=mypassword # 我的管理员密码
      - MINIO_SERVER_URL=https://api.mydomain.com:98 # 告诉 MinIO，它的 API 对外是这个地址
      - MINIO_BROWSER_REDIRECT_URL=https://minio.mydomain.com:98 # 告诉 MinIO，它的管理界面对外是这个地址
    command: server /data --console-address ":9001" --address ":9000"

这里有俩地方我必须跟你强调下，这俩玩意儿没配对，后面绝对让你抓狂：

• extra_hosts: 这玩意儿简直是神来之笔！它能让 MinIO 容器“明白”，你给它配的 minio.mydomain.com 和 api.mydomain.com 这些域名，其实就是它自己！这样它在自己内部生成链接或者处理请求的时候，就不会因为“不认识自己”而搞砸了。
• MINIO_SERVER_URL 和 MINIO_BROWSER_REDIRECT_URL: 这两个环境变量，说白了就是给 MinIO 指路。告诉它，如果 FastGPT 或者其他客户端要访问它，应该用哪个 URL。这对于文件上传成功后，MinIO 返回给客户端的正确文件访问地址，简直是生命线！

然后，docker-compose up -d，MinIO 就跑起来了。

2. Nginx Proxy Manager (NPM) 的 Docker 配置

NPM 部署起来倒是挺省心的，也是 docker-compose 一把梭：

services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    restart: unless-stopped
    network_mode: bridge
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    ports:
      - '20080:80' # HTTP 端口
      - '20443:443' # HTTPS 端口
      - '20081:81' # NPM 管理界面端口
    volumes:
      - /nginx-proxy-manager/data:/data
      - /nginx-proxy-manager/certs:/etc/letsencrypt

跑起来之后，我就可以通过 http://我的服务器IP:20081 进 NPM 的管理界面了。

我遇到的鬼打墙：MinIO 文件上传死活不成功！

等我把 MinIO 的那些密钥啥的都填好后，那叫一个信心满满！结果呢？在 FastGPT 的对话窗口里一上传文件，就直接报错甩个上传失败的脸子。MinIO 后台也看不到任何新文件。当时我就懵逼了，MinIO 自己能跑，Console 也能进，手动上传也行，为啥通过反代就传不上去呢？

我寻思着，MinIO 没问题，那肯定就是通过 NPM 访问 MinIO API 的中间环节出问题了。

我的破局之路：NPM 的“高级配置”真是个宝藏！

经过一番抓耳挠腮、东查西找，我终于发现，MinIO 这货对 HTTP Header 和文件传输的要求还挺“讲究”的。NPM 默认的那些转发配置，对付一般网站还行，但遇到 MinIO 这种要传文件、要校验的，就有点力不从心了。我必须得去 NPM 的“Custom Locations”和“Advanced”里手动加点 Nginx 配置。

1. 反代 MinIO Console (minio.mydomain.com)

这个相对简单，主要是为了让我能进 MinIO 的管理界面。

• Proxy Host 设置：
  • 域名: minio.mydomain.com
  • 协议: https
  • 转发到: 我的 MinIO 容器 IP (比如 192.168.31.91)
  • 端口: 9001 (Console 映射的端口)
  • SSL: 我直接让 NPM 给我签了个 Let's Encrypt 证书，省事儿。

• Advanced 选项卡：
  为了 Console 里那些大文件操作和 WebSocket 连接能顺畅，我加了这些：

  ignore_invalid_headers off;
  client_max_body_size 0; # 允许上传任意大小的文件，Console 里手动上传也需要
  proxy_buffering off; # 关掉缓冲
  proxy_request_buffering off; # 关掉请求缓冲
  

保存后，MinIO Console 访问正常。

2. 反代 MinIO API (s3.mydomain.com) - 这才是解决文件上传的真功夫！

这个才是最要命的，文件上传就是卡在这儿了。我得确保 NPM 能把所有 API 请求，尤其是大文件上传，都处理得妥妥帖帖。

• Proxy Host 设置：
  • 域名: s3.mydomain.com
  • 协议: https
  • 转发到: 我的 MinIO 容器 IP (比如 192.168.31.91)
  • 端口: 9000 (API 映射的端口)
  • SSL: 还是让 NPM 自动签发 Let's Encrypt 证书。

• Advanced 选项卡 (划重点中的重点！)：

  我发现 NPM 默认给的 location / {} 块，对文件上传这种活儿，真的不行。我必须手动改它！特别是要让 Nginx 知道怎么处理大文件，还得把 Host 头原封不动地传给 MinIO。

  我的关键操作是这样的：

  • client_max_body_size 0;: 这个是上传大文件必备的！ 它告诉 Nginx，你别管文件多大，都给我放行！不然文件稍微大点就直接被 Nginx 拦下来了。
  • proxy_buffering off; 和 proxy_request_buffering off;: 这两个也很关键！ 它们是关掉 Nginx 对代理请求的缓冲。你想啊，文件上传是直接往 MinIO 里流的，如果 Nginx 先把文件全吞下去再吐给 MinIO，那肯定容易超时，也占用 Nginx 资源。关掉缓冲，直接流式传输，效率高多了。
  • proxy_set_header Host $http_host;: 这个也是核心！ 它确保 Nginx 把客户端发过来的原始 Host 头，一字不差地传给 MinIO。如果这里用 $host，Nginx 有时候会自己改这个值，MinIO 一看 Host 头不对，就直接给你报错了，文件当然也传不上去。
  • proxy_http_version 1.1; 和 proxy_set_header Connection "";: 这俩是为了更好地处理长连接和 WebSocket，虽然不一定直接影响文件上传，但对 MinIO 整体稳定性有好处。
  • 最后，确保 proxy_pass 指向的是我 MinIO API 的正确 IP 和端口。

  修改后的 Advanced 配置，大概长这样（你得把 IP 和端口改成你自己的）：

  ignore_invalid_headers off;
  client_max_body_size 0;
  proxy_buffering off;
  proxy_request_buffering off;
  location / {
      proxy_set_header Host $http_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;
  
      proxy_connect_timeout 300;
      # Default is HTTP/1, keepalive is only enabled in HTTP/1.1
      proxy_http_version 1.1;
      proxy_set_header Connection "";
      chunked_transfer_encoding off;
      proxy_pass http://192.168.31.91:9000;
  }
  

保存这些配置并等待 NPM 重新加载 Nginx 后，我再次尝试在 FastGPT 里上传文件。

这次，奇迹发生了！进度条嗖嗖地跑完了，文件上传成功！MinIO 后台也看到了新文件。那一刻，我感觉自己简直是打了一场胜仗！我的 MinIO 终于能正常地接收 FastGPT 传过来给大模型用的文件了，我的心头大患彻底解决了！

我的血泪教训总结

这次 MinIO 文件上传问题，真是给我上了一课。反向代理这玩意儿，真不是随便设个端口转发就完事儿的，特别是遇到 MinIO 这种对 HTTP Header 和数据流传输有“洁癖”的服务，更得细心。

总结一下，解决这个问题的核心就是：

1. MinIO 自己得“认识自己”： extra_hosts 和 MINIO_SERVER_URL 这俩环境变量，让 MinIO 知道自己对外叫啥名，用哪个地址。
2. NPM 的“高级配置”要到位：
   • client_max_body_size 0;：放行大文件上传，别让 Nginx 拦着。
   • proxy_buffering off; 和 proxy_request_buffering off;：关掉 Nginx 的缓冲，让文件直接流向 MinIO，提高效率，避免超时。
   • proxy_set_header Host $http_host;：最关键的！ 确保 Host 头原封不动地传给 MinIO，这是它内部校验的命根子。

希望我这番“血泪史”，能帮你少走弯路，早日把 MinIO 文件上传的问题搞定！**

原创不易，希望这篇文章对你有所帮助！如果觉得不错，记得点赞、收藏、分享哦！💖