proxy_temp_file_write_size 控制nginx代理落盘时单次写入大小，默认32k，推荐调至64k–256k；仅在响应超内存缓冲、启用proxy_buffering且需写临时文件时生效，需协同proxy_buffers、proxy_max_temp_file_size等参数优化。
proxy_temp_file_write_size 是 Nginx 代理模块中控制临时文件写入磁盘时单次 I/O 块大小的关键参数，直接影响大响应体（如文件下载、反向代理流式内容）场景下的磁盘写入效率和系统负载。
它实际影响哪些场景
该参数仅在以下情况生效：
- Nginx 作为反向代理，且后端响应体超过 proxy_buffer_size + proxy_buffers 总和时，开始将多余内容写入磁盘临时文件（如
/var/cache/nginx/proxy/下的文件）； - 响应为非缓存友好型（例如未带
Cache-Control、或设置了no-cache）、或明确配置了proxy_buffering off但又触发了临时存储逻辑； - 后端传输慢、客户端接收慢，导致 Nginx 必须缓冲大量数据到磁盘而非纯内存中。
默认值与合理调优范围
默认值是 32k（即 32768 字节），适用于多数通用场景。但并非越大越好：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 设得太小（如 4k 或 8k）：频繁发起小块 write() 系统调用，增加内核上下文切换和磁盘寻道开销，尤其在机械硬盘或高并发下明显拖慢吞吐；
- 设得过大（如 1m 或更高）：可能加剧内存暂留压力（Nginx 仍需预分配 buffer）、延长单次写入延迟，并在突发小响应时造成资源浪费；
- 推荐起点：**64k ~ 256k**，具体取决于你的存储介质和典型响应大小。SSD 可倾向 128k–256k；机械盘建议 64k–128k；若大量 1–5MB 文件下载，可试 256k。
配合其他参数协同调优
单独改 proxy_temp_file_write_size 效果有限，需结合以下设置：
-
确保
proxy_max_temp_file_size足够大：避免因临时文件超限而中断写入（例如设为1024m）； -
检查
proxy_buffering开关：若关闭 buffering，此参数不生效；开启时才进入磁盘缓冲路径； -
确认
proxy_buffers和proxy_busy_buffers_size合理：它们决定多少数据先驻留内存，减少落盘频次。例如：proxy_buffers 8 64k;+proxy_busy_buffers_size 128k;与proxy_temp_file_write_size 128k;更匹配； -
注意文件系统和挂载选项：XFS/ext4 推荐启用
noatime，并确保临时目录所在分区有足够 inodes 和空间。
验证是否生效及性能变化
调优后需实测验证：
- 用
strace -e trace=write -p $(pgrep nginx)观察 worker 进程 write() 调用的字节数是否接近你设置的值； - 通过
iostat -x 1查看avgrq-sz（平均请求大小）是否上升、%util是否下降或更平稳； - 对比大文件下载场景下的平均响应时间、95 分位延迟、以及 Nginx error log 中是否仍有
could not create a temporary file或writev() failed类报错。
不复杂但容易忽略：这个参数只在真正“落盘”时起作用，不是所有代理流量都会触发。找准瓶颈路径，再针对性调整，才能让磁盘写入更高效。
