max_ranges 控制HTTP范围请求中允许的最大不连续区间数，默认200，超限返回416；它不限制单段断点续传，仅限制多段合并请求（如bytes=0-1023,2048-3071），需与range指令配合使用。
在 Nginx 中，max_ranges 指令用于控制 HTTP 范围请求（Range Requests）中允许的最大分片数量，直接影响断点续传行为。它不是限制“是否支持断点续传”，而是限制客户端一次请求中可指定的 Range 头里包含多少个不连续区间（如 bytes=0-1023,2048-3071,4096-5119 这样的多段请求）。默认值为 200，超出则返回 416 Range Not Satisfiable。
max_ranges 的作用与常见误解
它不关闭断点续传，也不影响单段 Range 请求——比如 Range: bytes=1000- 或 bytes=500-1499 始终可用，只要文件可读且未禁用 range。真正被限制的是“多区间合并请求”（multipart/byteranges 响应），这类请求极少用于普通浏览器下载，但可能出现在某些定制下载器、P2P 工具或压测脚本中。
典型误用场景：
- 把
max_ranges 1当作“强制单段下载”来规避分片攻击——实际无效，因为单段 Range 仍完全支持； - 调低后导致某些旧版下载工具失败，却未意识到问题根源是多段请求而非断点续传本身。
如何安全配置 max_ranges
若确需限制（例如防范恶意构造大量 Range 区间耗尽内存），建议保留合理余量：
- 常规静态文件服务：保持默认
max_ranges 200即可； - 高并发小文件场景：可降至
50～100，兼顾兼容性与资源保护； - 明确禁用多段请求（极少数需求）：设为
max_ranges 1，此时仅接受至多一个 Range 区间（仍支持标准断点续传）； - 注意：该指令只能在
http或server块中使用，不可写在location内。
配合 range 指令协同控制
max_ranges 需与 range 指令配合生效。若关闭范围请求：range off;，则所有 Range 头都会被忽略，返回完整响应（状态码 200），此时 max_ranges 不起作用。
推荐组合策略：
- 允许断点续传但防滥用：
range on; max_ranges 50; - 彻底禁用分片能力（含单段）：
range off;（此时不走 206，也不校验 Range 头）； - 日志中排查问题：开启
log_format记录$sent_http_content_range和$status，便于识别 416 是否由超限触发。
验证配置是否生效
用 curl 发送含多个 Range 的请求测试：
curl -H "Range: bytes=0-1023,2048-3071,4096-5119" http://your-site/file.zip -I
若返回 416 且响应头含 Content-Range: */SIZE，说明 max_ranges 生效；若返回 206 且 Content-Type: multipart/byteranges，说明未触发限制。
注意：部分客户端（如现代 Chrome/Firefox）默认只发单段 Range，需手动构造多段请求才能验证。
