关键在于整条链路协同支持Range：需显式透传Range/If-Range头、源站返回206响应、缓存key区分Range范围、合理设置cache_valid，进阶可用slice模块分片代理。
要让缓存系统（如 Nginx 作为反向代理）真正支持大文件断点续传并实现加速，关键不是只加一行 proxy_set_header Range $http_range，而是整条链路对 Range 请求的识别、透传、响应与缓存协同工作。下面从实操角度拆解核心环节：
确保客户端 Range 请求能完整抵达源站
Nginx 默认在 proxy_pass 场景下不会自动透传 Range 和 If-Range 头，尤其当配置了自定义 proxy_set_header 时，原有请求头可能被覆盖或丢失。必须显式声明：
-
proxy_set_header Range $http_range; -
proxy_set_header If-Range $http_if_range;
这两行需放在location块中proxy_pass之前。若$http_range为空（即客户端没发 Range），Nginx 会传空值或不传该头，不影响正常 200 响应，安全可靠。
让后端服务真正返回 206 响应，而非降级为 200
源站（如另一台 Nginx、OSS、S3 或 PHP 文件服务）必须：
- 支持字节范围读取（例如静态文件服务未禁用
range指令） - 文件可读且未被认证、重写等逻辑拦截（比如
satisfy any+allow/deny可能跳过 range 处理） - 对
Range: bytes=100-199这类请求，返回HTTP/1.1 206 Partial Content+Content-Range: bytes 100-199/1234567
可用 curl 快速验证：curl -I -H "Range: bytes=0-1023" https://your-domain.com/video.mp4
看到
206和Content-Range才算通过。
FastAPI Flask Proxy下载FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
合理缓存 206 响应，避免重复回源
CDN 或 Nginx 缓存层若把 206 响应全量缓存，但 key 没区分 Range 范围，就会导致“一个分片缓存覆盖全部请求”。正确做法是：
- 使用
$slice_range（配合slice模块）或$http_range构建唯一缓存 key - 示例：
proxy_cache_key "$uri$is_args$args$slice_range"; - 同时启用
proxy_cache_valid 200 206 1h;—— 明确允许缓存 206 -
禁用对 Range 请求的强制缓存策略，比如不要设
Cache-Control: public, max-age=31536000，否则 CDN 可能直接返回旧的 200 全量缓存。
（进阶）用 slice 模块实现智能分片代理
当源站较慢或带宽受限时，slice 是提升并发下载效率的关键：
- 在
location中启用：slice 1m;（每片最大 1MB） -
proxy_set_header Range $slice_range;（Nginx 自动注入当前切片范围） -
proxy_http_version 1.1;（Range 是 HTTP/1.1 特性，必须声明） - 后端必须支持 Range（如标准 Web 服务器、对象存储），否则会返回 416 或完整体
这样，多个用户请求不同区间时，Nginx 可并行拉取不同 slice 并分别缓存，显著降低源站压力。
不复杂但容易忽略
