proxy_max_temp_file_size限制nginx内存不足时单个临时磁盘文件的最大容量，仅在proxy_buffering为on、缓冲区不足、响应可缓存且非流式传输时生效；设太小增i/o，设太大或0易占满磁盘。
当 Nginx 作为反向代理转发大文件（如 ISO、视频、安装包）时，若后端响应体过大且未启用流式传输，Nginx 默认会将响应暂存为临时文件。此时 proxy_max_temp_file_size 的设置就非常关键——它直接决定单个临时文件能写多大；设得太小会频繁切片、增加 I/O 开销；设得太大或为 0（即不限制），又可能让一个超大响应占满磁盘，导致服务异常。
理解 proxy_max_temp_file_size 的作用时机
该指令只在以下条件同时满足时生效：
- Nginx 缓冲区（由
proxy_buffer_size和proxy_buffers控制）不足以容纳整个响应体； -
proxy_buffering为 on（默认值）； - 响应未被标记为不可缓存（如含
Cache-Control: no-store或状态码为 5xx）； - 后端未显式关闭连接或使用
Transfer-Encoding: chunked流式响应。
换句话说：它不是限制“下载文件大小”，而是限制“Nginx 在内存不够时，单个临时磁盘文件的最大容量”。超过该值，Nginx 会把响应拆成多个临时文件（受 proxy_temp_path 管理），但总占用仍可能失控。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
合理设置值：兼顾安全与性能
不建议设为 0（禁用上限）或过大的值（如 2G）。推荐按业务最大常见响应体的 1.2–1.5 倍设定，并留出 buffer：
- 普通 API 或小资源（1024m（即 1GB）完全足够，无需调整；
- 大文件下载服务（如 500MB 安装包）：设为 600m～800m，避免单个异常响应（如日志 dump）意外写满磁盘；
- 明确流式场景（如视频点播、实时日志流）：应关闭缓冲：
proxy_buffering off;，此时该参数失效，也更节省内存和磁盘。
配套必须做的防护措施
单靠调这个参数不能根治磁盘爆满问题，还需组合配置：
-
限定临时目录位置与磁盘配额：用
proxy_temp_path /data/nginx/temp 1 2指向独立、有监控的磁盘分区，并配置系统级磁盘告警或 quota； -
设置超时与限速：搭配
proxy_read_timeout（防后端挂起）、proxy_buffering off+sendfile on（流式转发）或limit_rate（防客户端拖库）； -
记录并监控临时文件行为：开启
error_log ... debug;（临时）可看到upstream already buffered或using temp file日志；生产环境建议用log_format记录$upstream_http_content_length，识别大响应来源。
验证是否生效的小技巧
可通过构造一个略大于设定值的响应来测试：
- 启动一个 Python HTTP server 返回 900MB 随机内容（确保 >
proxy_max_temp_file_size）； - 用
watch -n1 'df -h /data/nginx/temp'观察磁盘变化； - 检查 Nginx error log 是否出现
too large response或反复创建/删除 temp 文件的痕迹； - 对比设为 0 与设为 600m 时，同一请求下
/data/nginx/temp目录的文件数量与总大小差异。
