Nginx 反代 S3 报 SignatureDoesNotMatch 错误

Sat, 28 Mar 2026 10:32:22 +0800

现象

访问通过 Nginx 反代的 MinIO 时, 出现以下报错:

SignatureDoesNotMatch: The request signature we calculated does not match the signature you provided.

直接通过内网 IP 访问没问题, 过 Nginx 不行; 切换到旧的 V2 签名协议能通, V4 不行

在 Nginx 配置中使用了: proxy_set_header Host $host;

S3 的 V4 签名协议对请求头极其敏感. 它在计算哈希时, 会将 Host 字段作为一个关键参数

$host: Nginx 的这个变量不包含端口号（如果是非标准端口）

$http_host: 这个变量会完整保留客户端请求中的域名:端口

如果 S3 服务运行在非 80/443 端口（例如 9000）, 客户端生成的签名里包含端口, 在 Nginx 转发时被丢弃, 服务器端校验时就会认为请求被篡改, 直接拒绝访问

修改 Nginx 配置文件中的 Host

1
2
3
4
5
6


# 使用 $http_host 保留原始端口信息
proxy_set_header Host $http_host;

# 建议同时关闭缓冲，提升大文件备份稳定性
proxy_request_buffering off;
proxy_buffering off;

如果你是在反代 MiniO Console 后发现无法在 WebUI 操作桶内文件请尝试检查这个问题