HTTP 的 Range 请求使客户端能够要求服务器仅向其回传 HTTP 消息的一部分
HTTP 的 Range 请求头是 HTTP/1.1 协议的一个特性。它允许客户端请求仅传输资源的某个特定部分,而不是整个资源。
适用场景
- 支持随机访问的媒体播放器
- 明确只需大型文件某部分的数据处理工具
- 允许用户暂停及恢复下载的下载管理器
这对于需要只下载大文件中的一部分数据的应用场景非常有用
检测服务端是否支持范围请求
如果 HTTP 响应中存在 Accept-Ranges 标头,并且其值不是“none”,那么该服务器支持范围请求
通过使用像 cURL 这样的工具发出一个 HEAD 请求来进行手动检查
curl -I http://i.imgur.com/z4d4kWk.jpg
HTTP/1.1 200 OK
... ...
Accept-Ranges: bytes
Content-Length: 146515
Accept-Ranges: bytes 表示可以使用字节作为单位来定义范围
Content-Length 标头也很有用,它指示要检索的图像的完整大小
如果网站省略了 Accept-Ranges 标头,那么它们很可能不支持部分请求。
有些网站会包含这个标头,但明确将其值设为“none”,以表明它们不支持这一特性:
curl -I https://www.youtube.com/watch?v=EwTZ2xpQwpA
HTTP
HTTP/1.1 200 OK
... ...
Accept-Ranges: none
下载管理器可能会禁用暂停按钮
从服务器端请求特定的范围
如果服务器支持范围请求,只需在 HTTP 请求中包含 Range 标头,指定希望服务器返回文档的哪一部分或哪些部分
单一范围
使用 cURL 来测试。这里的“-H”选项会向请求中添加一个标头,即 Range 标头,用于请求前 1024 个字节
curl http://i.imgur.com/z4d4kWk.jpg -i -H "Range: bytes=0-1023"
GET /z4d4kWk.jpg HTTP/1.1
Host: i.imgur.com
Range: bytes=0-1023
服务器将会返回 206 Partial Content 状态
HTTP/1.1 206 Partial Content
Content-Range: bytes 0-1023/146515
Content-Length: 1024
... ...
Content-Range 响应标头,表示此部分消息在完整资源中的位置
Content-Length 标头,表示所请求范围的大小(而非完整大小)
多重范围
Range 标头还允许在文档中支持一次性获取多重范围。这些范围使用逗号分隔
curl http://www.example.com -i -H "Range: bytes=0-50, 100-150"
服务器以 206 Partial Content 状态码以及 Content-Type: multipart/byteranges; boundary=3d6b6a416f9b5 标头响应
表明随后的数据将采用多部分字节范围格式
每个部分都携带自己的 Content-Type 和 Content-Range 字段,而必须的 boundary 参数定义了用于分割每个消息体部分的边界字符串
(边界字符串…)
HTTP/1.1 206 Partial Content
Content-Type: multipart/byteranges; boundary=3d6b6a416f9b5
Content-Length: 282
--3d6b6a416f9b5
Content-Type: text/html
Content-Range: bytes 0-50/1270
<!DOCTYPE html>
<html lang="en-US">
<head>
<title>Example Do
--3d6b6a416f9b5
Content-Type: text/html
Content-Range: bytes 100-150/1270
eta http-equiv="Content-type" content="text/html; c
--3d6b6a416f9b5--
条件式范围请求
当重新开始请求资源的更多部分时,需要保证存储资源在收到上一个片段后未被修改
If-Range: Wed, 21 Oct 2015 07:28:00 GMT
If-Range HTTP 请求标头使范围请求具有条件性:
- 如果条件兑现,则会发起范围请求,服务器将以包含适当内容主体的 206 Partial Content 响应进行回复
- 如果条件不兑现,会被发送完整的资源回来,并带有 200 OK 状态
该标头可与 Last-Modified 验证器或 ETag 一起使用,但不能同时使用
范围请求的响应
范围请求相关的有三种状态
- 范围请求成功后,服务器会发出 206 Partial Content 状态
- 如果不支持范围请求,则返回 200 OK 状态,并传输完整的响应体
- 超出范围的范围请求将导致 416 Requested Range Not Satisfiable 状态,这意味着没有任何范围值与资源的范围重叠
例如,每个范围的第一个字节位置可能大于资源的长度
与分块 Transfer-Encoding 的对比
Transfer-Encoding 标头支持分块编码,这对于向客户端发送大量数据特别有用,尤其是在完全处理请求之前,无法知道响应总大小的情况。服务器直接向客户端发送数据,无需确定缓冲响应或确切长度,从而减少延迟提高响应速度
范围请求和分块传输是兼容的,可以独立使用或结合使用