proxy_temp_file_write_size控制nginx代理落盘时每次write系统调用的数据量，默认32k；仅在proxy_buffering on且响应超出内存缓冲时生效，需配合proxy_buffers、proxy_max_temp_file_size等协同优化。

proxy_temp_file_write_size 是 Nginx 代理模块中一个影响临时文件写入行为的参数，它控制 Nginx 在将上游响应写入磁盘临时文件时，每次 write 系统调用写入的数据量大小。

这个参数的作用和适用场景

当后端响应体较大、且未启用 proxy_buffering off 时，Nginx 会先将响应内容缓存到内存 buffer 中；若 buffer 不足，则把超出部分写入磁盘临时文件（如 /var/lib/nginx/proxy/ 下的文件）。proxy_temp_file_write_size 就决定了每次向这些临时文件写数据的 chunk 大小。

默认值是 32k（即 32768 字节），适用于大多数情况。在高吞吐、大响应体或 I/O 较慢的存储设备上，适当调大该值可减少系统调用次数、降低 CPU 开销；但设得过大可能增加延迟或内存压力。

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

如何配置 proxy_temp_file_write_size

该指令只能出现在 http、server 或 location 块中，语法简单：

• 在对应作用域内添加：proxy_temp_file_write_size 64k;
• 支持单位：k（KB）、m（MB），例如 128k、1m
• 必须是 512 字节的整数倍，否则启动时报错
• 不能小于 proxy_buffer_size，通常也不建议小于 proxy_buffers 的单 buffer 大小

搭配使用的相关参数

单独调整这个值效果有限，需结合其他代理缓冲参数协同优化：

• proxy_buffering on; —— 必须开启，否则不走临时文件逻辑
• proxy_buffer_size 4k; —— 设置首块响应头缓冲区大小，应 ≤ proxy_temp_file_write_size
• proxy_buffers 8 16k; —— 总共 8 个 buffer，每个 16KB；建议单 buffer 大小 ≤ proxy_temp_file_write_size
• proxy_max_temp_file_size 1024m; —— 控制临时文件最大容量，避免磁盘写满

验证与调优建议

修改后需重载 Nginx 并观察实际效果：

• 检查 error 日志是否有 “writev() failed” 或 “could not send response to client” 类报错，可能与写入粒度过大或磁盘 I/O 能力不足有关
• 用 strace -p $(pidof nginx) -e write 观察实际 write 调用的字节数是否符合预期
• 对大文件下载或流式响应服务，可尝试从 32k → 64k → 128k 逐步测试，关注吞吐提升与延迟变化
• SSD 环境下提升不明显，HDD 或网络存储（如 NFS）上更值得调整