Nginx代理静态资源支持断点续传需透传Range/If-Range头、将$http_range加入cache_key、禁用sendfile与gzip干扰，并验证206响应。
要让 Nginx 代理静态资源时支持断点续传，关键不是“开启”某个功能，而是确保 Range 请求能完整、准确地透传到后端，并让缓存和响应行为与分片逻辑一致。Nginx 本身对静态文件（root/alias）默认就支持 Range，但走 proxy_pass 时，Range 头默认不会被转发——必须显式配置。
必须添加的透传头配置
在 proxy_pass 所在的 location 块中，加入以下两行：
- proxy_set_header Range $http_range; —— 把客户端发来的 Range 值原样塞进转发请求头
- proxy_set_header If-Range $http_if_range; —— 配合 Range 使用，避免条件不匹配导致整包返回
这两项缺一不可。只设 Range 而忽略 If-Range，在某些客户端（如部分浏览器或下载工具）重试时可能降级为 200 响应。
缓存键必须包含 Range 值
如果启用了 proxy_cache，默认 cache_key 只含 $uri，所有 Range 请求都命中同一个缓存条目，结果就是：第一次请求返回了 0–999 字节，后续请求不管 Range 是多少，都返回同一段内容——断点失效。
正确做法是把 Range 加入缓存键：
- proxy_cache_key $uri$is_args$args$http_range; 或更稳妥的写法：proxy_cache_key "$uri|$http_range";
- 同时建议加上 proxy_cache_valid 206 1h; 明确允许缓存 206 响应
注意：若 $http_range 为空（即普通全量请求），该 key 会变成类似 /file.zip|，与带 Range 的 key 自动区分开，自然实现“有断点走缓存分片，无断点走常规缓存”。
避免干扰响应头和传输机制
以下配置容易破坏断点续传，需检查并调整：
-
禁用 sendfile 用于小文件或不确定场景：某些内核+文件系统组合下，
sendfile on与 Range 冲突，可临时设为sendfile off;测试 -
gzip 对 Range 请求要限制：启用
gzip_disable "range";或gzip_disable "msie6|range";，防止压缩干扰 Content-Range 计算 -
不要设置 max_ranges 0;：这会直接关闭 Range 支持；保持默认或设为合理值如
max_ranges 10;
快速验证是否生效
用 curl 发起一个典型 Range 请求：
curl -I -H "Range: bytes=0-1023" https://your-domain.com/video.mp4
成功响应应包含：
- HTTP/1.1 206 Partial Content
- Accept-Ranges: bytes
- Content-Range: bytes 0-1023/12345678
- Content-Length: 1024
如果返回 200 或缺少 Content-Range，说明透传失败、后端不支持、或缓存覆盖了 Range 行为。
