proxy_max_temp_file_size仅限制单个临时文件大小，不控制总量；需结合后端响应特征与磁盘余量设定合理值，并同步调整proxy_buffering、proxy_buffers等参数以减少落盘。
要通过 proxy_max_temp_file_size 限制代理过程中的磁盘占用、防止磁盘打满导致服务异常，关键不是盲目调大或设为 0，而是结合业务响应特征与磁盘容量做精准约束——它不控制总空间，只管“单个临时文件能写多大”，超限即拒，从而从源头掐断失控写入。
明确它的作用边界：只限单文件，不管总量
该参数仅限制 Nginx 在代理后端响应时，单个临时磁盘文件的最大尺寸（例如设为 20m，则任何单次响应若需落盘，最多写一个 20MB 文件）。它不控制：
- proxy_temp_path 目录下所有临时文件的总大小
- proxy_cache 缓存占用的磁盘空间（那是
proxy_cache_path max_size管的） - 客户端上传请求体产生的临时文件（归
client_body_temp_path和client_max_body_size管） - 日志、SSL 缓存等其他磁盘行为
按磁盘余量和响应特征设合理上限
值过大，单个大响应可能占满 SSD 分区；值过小，又会频繁触发流式转发或 502。建议按以下逻辑确定：
- 查清你后端最常返回的响应体大小（如 API 返回 JSON 多在 100KB 内，静态资源下载常见 5–50MB）
- 确认
proxy_temp_path所在分区空闲空间 ≥ 3 × 该值（预留并发写入余量） - 机械盘或低配云盘建议 ≤10m；NVMe SSD 可放宽至 20m–50m
- 若后端基本不返回 >1MB 响应，可设为
1m或2m，既防异常大响应，又避免无效缓冲
必须同步调整的配套参数
单独改 proxy_max_temp_file_size 几乎无效，需组合控制：
-
proxy_buffering on;—— 确保该参数生效（默认开启） -
proxy_buffer_size 16k;+proxy_buffers 8 128k;—— 提升内存缓冲总容量（如 1MB），减少落盘概率 -
proxy_temp_path /ssd/nginx/proxy_temp 1 2;—— 显式指定 SSD 上专用路径，避免与系统日志争盘 -
client_max_body_size必须 ≥ 该值（否则大请求在代理前就被拦截）
验证是否真正起效
上线后重点观察三项：
- Nginx error log 中是否出现
"an upstream response is buffered to a temporary file"—— 出现说明有响应正在落盘；若大量出现且文件持续增长，说明值仍偏大或缓冲不足 -
ls -l /path/to/proxy_temp/*/* | wc -l查看临时文件数量波动，长期稳定在低位较理想 - iostat -x 1 观察
await和%util，高并发下无明显尖刺，说明磁盘压力受控
