Nginx代理分布式文件存储需正确配置proxy_pass路径重写、upstream负载均衡、S3兼容Header透传及大文件上传优化。关键包括proxy_pass末尾加/、启用proxy_request_buffering off、显式透传Authorization等Header、复用keepalive连接，并避免修改请求体以保障签名有效。
在 Nginx 中用 proxy_pass 代理访问分布式文件存储服务（如 MinIO、Ceph RGW、SeaweedFS 或自建多节点对象存储），核心是把客户端的 HTTP 请求正确转发到后端存储节点，并处理好路径重写、鉴权透传、Header 适配和负载均衡等细节。
基础 proxy_pass 配置与路径映射
假设你有多个存储节点（storage1.example.com:9000、storage2.example.com:9000），且它们以标准 S3 兼容方式提供服务（根路径即 API 入口）：
直接代理时需注意 URL 路径是否携带前缀。例如，想用 https://files.example.com/bucket1/object.jpg 访问后端 http://storage1.example.com:9000/bucket1/object.jpg，配置如下：
location / {
proxy_pass http://storage1.example.com:9000/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}关键点：proxy_pass 后带结尾斜杠（/）才能剥离 location 匹配前缀。若写成 proxy_pass http://storage1.example.com:9000;（无斜杠），Nginx 会原样拼接路径，导致请求变成 http://.../bucket1/object.jpg → http://...//bucket1/object.jpg，多数存储服务会返回 400 或 404。
多节点负载均衡与健康检查
为实现高可用，应将多个存储节点定义为 upstream，并启用主动健康检查（需 nginx-plus 或开源版配合第三方模块如 nginx-upstream-check-module）。简易轮询配置示例：
upstream file_storage {
server storage1.example.com:9000 max_fails=3 fail_timeout=30s;
server storage2.example.com:9000 max_fails=3 fail_timeout=30s;
keepalive 32;
}
<p>server {
listen 443 ssl;
server_name files.example.com;</p><pre class="brush:php;toolbar:false;">location / {
proxy_pass http://file_storage/;
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_http_version 1.1;
proxy_set_header Connection '';
proxy_buffering off;
proxy_request_buffering off; # 避免大文件上传被缓存
}}
- keepalive 复用后端连接，提升吞吐
- proxy_request_buffering off 对大文件 PUT/POST 必开，防止 Nginx 缓存整个请求体导致内存暴涨或超时
- 若需健康检查，可加
check interval=3 rise=2 fall=5 timeout=1（需编译模块）
适配 S3 兼容服务的 Header 与签名透传
S3 协议依赖特定 Header（如 Authorization、x-amz-date、x-amz-content-sha256）完成签名验证。Nginx 默认会过滤下划线开头的 Header，而部分 SDK 使用 x-amz- 头，需显式放行：
proxy_pass_request_headers on; proxy_set_header Authorization $http_authorization; proxy_set_header X-Amz-Date $http_x_amz_date; proxy_set_header X-Amz-Content-Sha256 $http_x_amz_content_sha256; proxy_set_header X-Amz-Security-Token $http_x_amz_security_token; # 禁用自动添加 Host 头（由上面 proxy_set_header 控制） proxy_pass_request_headers on;
同时确保 Nginx 不修改原始请求体长度或编码 —— 不要启用 gzip、chunked transfer encoding 代理压缩，S3 签名基于原始 payload 计算，任何改动都会使签名失效。
静态资源路径分离与权限控制（可选增强）
若仅开放公开 bucket 的只读访问（如 CDN 场景），可限制 method 并重写路径：
location ^~ /public/ {
# 剥离 /public/ 前缀，转发到 bucket 名
rewrite ^/public/(.+)$ /$1 break;
proxy_pass http://file_storage/;
proxy_method GET;
proxy_cache my_cache;
proxy_cache_valid 200 1h;
}也可结合 auth_request 模块对接鉴权服务，在代理前校验 token 或 referer：
location / {
auth_request /auth;
proxy_pass http://file_storage/;
# ...其他 proxy 设置
}
<p>location = /auth {
proxy_pass <a href="https://www.php.cn/link/e2e426e8f76b4c00c2616ce9139b130d">https://www.php.cn/link/e2e426e8f76b4c00c2616ce9139b130d</a>;
proxy_pass_request_body off;
proxy_set_header Content-Length "";
proxy_set_header X-Original-URI $request_uri;
}不复杂但容易忽略。关键是路径处理干净、Header 不丢不改、大文件不缓冲、后端连接不频繁重建。
