详细介绍：NGINX 高级配置解析：`proxy_request_buffering` 使用详解

在使用 NGINX 作为反向代理服务器时，处理客户端请求体（如上传文件或大体积 POST 请求）的方式会直接影响应用性能与资源使用。其中，proxy_request_buffering 是一个非常关键但容易被忽略的配置项。

本文将详细介绍该指令的作用、典型使用场景及其在 Kubernetes（Ingress NGINX）环境中的配置方法。

一、什么是 proxy_request_buffering？

proxy_request_buffering 是 NGINX 的一个 反向代理模块指令，用于控制 NGINX 在将客户端请求体转发给后端之前，是否先将其缓存在本地（内存或磁盘）。

✅ 语法

proxy_request_buffering on | off;

• on（默认）：NGINX 会在转发请求前，先将整个请求体读完并缓存在本地。
• off：NGINX 会 边读取请求体边转发到后端，即 流式转发。

---

二、为什么重要？有哪些影响？

✅ 启用（默认 on）时：

• 请求体完整读入 NGINX 缓冲区后再发送到后端。
• 避免后端被慢速上传客户端阻塞（Slowloris 攻击防护）。
• 更利于请求体完整性验证（如文件大小检查）。
• 可能会使用更多 NGINX 主机的内存或磁盘。

✅ 关闭（off）时：

• 实现流式转发：适合处理大文件上传，降低延迟。
• 对后端实时处理上传数据的服务（如视频流处理、websocket）更友好。
• 后端可能暴露于慢速客户端风险（除非自行控制超时）。

---

三、典型使用场景

场景	是否建议关闭 buffering	说明
大文件上传（如视频、镜像）	✅ 建议关闭	减少 NGINX 内存/磁盘使用
实时视频流 / API 流数据接口	✅ 建议关闭	实现低延迟实时传输
普通 Web 表单提交	❌ 保持默认开启	更安全、控制资源使用
防御慢速客户端	❌ 保持开启	防止慢速上传拖垮后端资源

---

四、Kubernetes 中如何配置？

在 Ingress NGINX 中，可以通过注解的方式配置 proxy-request-buffering。

✅ 配置方式（Ingress 注解）

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: my-app
annotations:
nginx.ingress.kubernetes.io/proxy-request-buffering: "off"
spec:
...

注意：值必须是字符串 "on" 或 "off"，不能写成布尔值。

五、验证生效

你可以进入某个 NGINX Ingress Controller Pod 中，查看生成的 NGINX 配置：

kubectl exec -it <nginx-ingress-pod> -n ingress-nginx -- cat /etc/nginx/nginx.conf | grep proxy_request_buffering

输出类似：

proxy_request_buffering off;