Nginx无单个缓存文件大小限制参数，因缓存以条目为单位存储；实际由proxy_buffering、proxy_buffer_size、proxy_buffers控制内存缓冲，max_size和inactive管控整体磁盘用量。

Nginx 本身没有直接限制“单个缓存文件大小”的配置指令，proxy_cache 不按文件粒度管理缓存内容，而是将响应体整体存为一个缓存条目（entry），其底层存储是二进制块+元数据，不对应操作系统中可直观看到的“单个大文件”。因此，不存在 proxy_cache_max_file_size 或类似参数。

真正影响单个响应能否被缓存的关键限制

虽然不能设“单个缓存文件上限”，但以下参数共同决定一个响应是否会被写入缓存、以及写入时的行为边界：

FastAPI Flask Proxy

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

下载

• proxy_buffering on; —— 必须开启，否则响应直接流式转发，不进入缓存流程
• proxy_buffer_size 16k; + proxy_buffers 8 128k; —— 决定内存缓冲总容量（如 1MB）。若响应头+响应体前段超出此范围，Nginx 才可能落盘并考虑缓存
• client_max_body_size 和 client_header_timeout 等 —— 防止超大请求在代理入口就被拒绝，间接避免缓存系统面对畸形大响应
• proxy_cache_valid 200 304 1h; —— 控制哪些状态码和多长时间内允许缓存，不满足条件的响应根本不会进 cache

控制缓存占用的实质手段：max_size + inactive

你真正能配置的“大小相关”参数，都在 proxy_cache_path 指令中：

• max_size=5g —— 整个缓存区磁盘用量上限（例如 5GB），Nginx 会主动淘汰最久未访问的条目来维持该限额
• inactive=1h —— 缓存条目若在 1 小时内未被再次命中，就会被清理，不管是否过期
• levels=1:2 keys_zone=mycache:64m —— 内存中缓存键索引区大小（64MB），影响并发查找效率，也间接限制可管理的缓存条目总数

如果业务需规避大响应缓存，应从源头控制

当后端可能返回几十 MB 的报表或视频片段时，不建议让它们进入 proxy_cache（易撑满磁盘、拖慢清理）。推荐做法是：

• 用 location 匹配路径特征，对大文件响应显式关闭缓存：
  

  location ~* \.(pdf|zip|mp4|iso)$ {<br>  proxy_cache off;<br>  proxy_buffering off;<br>}

• 用 proxy_no_cache 和 proxy_cache_bypass 结合响应头判断，例如：
  proxy_no_cache $upstream_http_x_no_cache;（后端返回 X-No-Cache: 1 时跳过缓存）
• 设置 proxy_cache_min_uses 3;，只缓存被重复请求 3 次以上的资源，天然过滤一次性大响应