Nginx中$http_range变量可捕获客户端Range请求头，需结合log_format记录$http_range、$status（206）、$sent_http_content_range三者协同验证断点续传行为，缺一不可。
在 Nginx 中，$http_range 变量能捕获客户端发起的 Range 请求头（如 bytes=1024-2047），是监控大文件断点续传行为的关键线索。要有效利用它，核心在于：**将该变量写入访问日志，并结合日志分析识别续传模式**。
确认 $http_range 是否可用并正确提取
Nginx 原生支持 $http_range，它对应请求头中的 Range 字段（注意大小写，http_ 前缀会自动将首字母转小写，所以 Range → $http_range）。但需注意：
- 该变量仅在请求携带
Range:头时有值，否则为空字符串； - 若客户端发的是
If-Range头，$http_range不会捕获它——需额外用$http_if_range； - 建议搭配
$status和$sent_http_content_range（响应头中实际返回的范围）一起记录，便于比对是否成功续传。
配置 log_format 包含 $http_range
在 http 块中定义自定义日志格式，例如：
log_format range_log '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'"$http_range" "$sent_http_content_range" '
'$request_time $upstream_response_time';然后在 server 或 location 块中启用：
access_log /var/log/nginx/range-access.log range_log;
重启 Nginx 后，日志中会出现类似这样的行：
192.168.1.100 - - [10/Jul/2024:14:22:33 +0800] "GET /video.mp4 HTTP/1.1" 206 10240 "-" "curl/7.68.0" "bytes=10240-20479" "bytes 10240-20479/104857600" 0.002 0.002
通过日志识别典型断点续传行为
关注以下特征组合，可判断是否为真实续传行为：
- 状态码为 206（Partial Content）——这是断点续传成功的最直接标志；
-
$http_range 非空，且格式为
bytes=A-B或bytes=A-； -
$sent_http_content_range 匹配响应的实际范围，且末尾总长度一致（如
/104857600），说明服务端按需切片返回； - 同一文件、同一 IP 在短时间内出现多个 206 请求，且
$http_range起始偏移递增（如0-1023→1024-2047→2048-3071），基本可判定为顺序续传。
进阶：用 log_format 辅助统计与告警
可进一步结构化日志，方便下游采集（如 Filebeat + Elasticsearch）或脚本解析：
- 用
$request_uri和$args分离文件路径与查询参数； - 添加
$http_accept_ranges看服务端是否声明支持范围请求； - 用
$connection_requests或$msec辅助分析请求密集度； - 对关键大文件 location 单独配置 access_log，避免日志爆炸。
不复杂但容易忽略。真正起作用的不是单个变量，而是 $http_range + 206 + $sent_http_content_range 这组信号的协同验证。
