proxy_cache_max_range_offset 与分块传输编码（chunked transfer encoding）完全无关，仅限制缓存range请求的最大字节偏移量；真正影响chunked流式透传的是proxy_buffering off、proxy_http_version 1.1、proxy_set_header connection ''和proxy_cache off等配置。

proxy_cache_max_range_offset 并不用于优化“分块传输”（Chunked Transfer Encoding），它和 Chunked 完全无关。

这个指令只影响 HTTP Range 请求（即 Range: bytes=0-1023 这类分片下载）在启用 proxy_cache 时的缓存行为，具体作用是：
限制 Nginx 缓存单个 Range 请求响应的最大偏移量。超出该值的 Range 请求将不走缓存，直接回源。

---

它和 Chunked 为什么无关？

• Chunked 是传输编码（Transfer-Encoding），属于 HTTP/1.1 的底层数据打包机制，用于动态生成、长度未知的响应体（如流式 API、SSE、导出接口）。
• Range 是内容寻址（Content-Range），客户端明确请求资源某一段字节，常用于视频拖拽、大文件断点续传等场景，响应状态码通常是 206 Partial Content，且带 Content-Range 头。

Nginx 的 proxy_cache 默认根本不缓存 Chunked 响应（无论是否开启该参数），因为：

• 缺少 Content-Length
• 无法可靠提取 ETag 或 Last-Modified
• 缓存需完整解码所有 chunk 才能存储原始 payload，开销大且易出错

所以，调高 proxy_cache_max_range_offset 不会让 Chunked 响应变快，也不会让它被缓存。

---

真正影响 Chunked 流式传输的关键配置

如果你的目标是让后端返回的 Chunked 响应实时透传给客户端（比如 GPT 流式输出、日志推送、导出进度条），应关注：

FastAPI Flask Proxy

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

下载

• proxy_buffering off;
  关键一步：禁用缓冲，避免 Nginx 攒满整个响应才转发

• proxy_http_version 1.1;
  Chunked 是 HTTP/1.1 原生特性，必须显式声明

• proxy_set_header Connection '';
  清除 Connection 头，防止 Nginx 或上游误加 close

• proxy_cache off;
  显式关闭缓存，避免干扰流式语义（默认也不缓存 Chunked，但显式关更稳妥）

• proxy_redirect off;
  防止重定向头污染原始流式响应

---

那 proxy_cache_max_range_offset 到底怎么设？

仅在你同时满足以下条件时才需要调整它：

• 后端支持 Range 请求（如静态文件服务、对象存储）
• Nginx 启用了 proxy_cache
• 你希望缓存部分 Range 响应（例如前几 MB 的视频首帧），但又不想缓存超大偏移（如 bytes=500M-500M+1023）导致缓存膨胀或磁盘写入压力

常见设置示例：

proxy_cache_max_range_offset 10485760;  # 10MB，适合缓存封面图、音频头等小范围
# 超过 10MB 的 Range 请求一律不缓存，直接回源

注意：该值对 200 OK 全量响应无影响；对 206 响应，只有当 Range 起始偏移 ≤ 此值时，才可能命中缓存（还需满足 proxy_cache_valid 206 ... 等条件）。

---

不复杂但容易忽略