proxy_max_temp_file_size在回源缓存未命中时，控制单个临时磁盘文件最大大小：响应体≤该值则完整落盘供后续缓存，超限则直接流式转发不落盘，避免磁盘被单个大响应占满。
在缓存未命中（cache miss）需回源获取内容时，Nginx 会先接收后端响应，再决定是否写入 proxy_cache 或暂存为临时文件。此时 proxy_max_temp_file_size 不控制缓存本身，而是约束“回源响应暂存阶段”单个磁盘临时文件的大小——它直接决定 Nginx 是把整个响应落盘缓存，还是被迫转为流式转发。
它在回源场景中起什么作用
当发生缓存未命中，且满足以下全部条件时，该参数才生效：
-
proxy_buffering on（默认开启） - 后端响应体超过内存缓冲总和（
proxy_buffer_size + proxy_buffers） - 响应头未标记
Cache-Control: no-store或no-cache，且状态码非 5xx - 后端未使用
Transfer-Encoding: chunked或主动关闭连接
此时，若响应体 ≤ proxy_max_temp_file_size，Nginx 将其完整写入一个临时文件，后续再刷入 cache 目录；若超过该值，Nginx 不拆分、不轮转，而是直接放弃缓存，改为边收边发（streaming），不生成临时文件——也就不会占用 proxy_temp_path 磁盘空间。
WebChat Voice Proxy
下载
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
如何设值才能兼顾缓存可用性与磁盘安全
目标不是“禁用临时文件”，而是让常见回源响应能顺利缓存，同时拦住异常大响应：
- 若业务回源内容多为 HTML/JSON/API 响应（通常 1024m 即可，无需调整
- 若回源含静态资源（如压缩包、文档、小视频），最大常见尺寸约 300MB：设为 360m～450m（留 1.2–1.5 倍余量）
- 若明确禁止 GB 级回源（如防误配置导出接口）：设为 512m，超限请求将被流式处理，不缓存也不落盘
必须配套做的三件事
单靠调这个参数无法防止磁盘撑爆，尤其在高并发回源时：
-
指定独立临时目录：用
proxy_temp_path /mnt/ssd/nginx/temp 1 2;指向有监控、配额、足够空闲空间（建议 ≥3×proxy_max_temp_file_size）的 SSD 分区 -
限制单次回源响应上限：在后端或网关层校验
Content-Length，或通过proxy_buffering off+limit_rate控制突发流量 -
记录并识别异常回源：在 log_format 中加入
$upstream_http_content_length，配合日志分析定位长期输出超大响应的 upstream location
验证是否按预期工作
上线后观察真实行为，而非仅看配置：
- 检查 error_log：出现
upstream response is buffered to a temporary file表示正常走缓存路径；若大量出现upstream sent too big header或无相关日志但响应变快，说明已触发流式降级 - 监控
proxy_temp_path目录文件数与总大小：稳定在低位波动，且峰值不超过预设值 × 并发请求数 - 用
curl -I检查回源响应头：确认X-Cache: MISS且Content-Length在预期范围内
