模块 ngx_http_slice_module

示例配置
指令
     slice
嵌入变量

ngx_http_slice_module 模块 (1.9.8) 是一个过滤器,它将请求拆分为子请求,每个子请求返回响应的特定范围。该过滤器提供了对大响应的更有效的缓存。

此模块默认情况下未构建,应使用 --with-http_slice_module 配置参数启用它。

示例配置

location / {
    slice             1m;
    proxy_cache       cache;
    proxy_cache_key   $uri$is_args$args$slice_range;
    proxy_set_header  Range $slice_range;
    proxy_cache_valid 200 206 1h;
    proxy_pass        http://localhost:8000;
}

在此示例中,响应被拆分为 1 兆字节的可缓存切片。

指令

语法 slice size;
默认值
slice 0;
上下文 httpserverlocation

设置切片的 size。值为零会禁用将响应拆分为切片。请注意,值过低可能会导致过度使用内存并打开大量文件。

为了让子请求返回所需的范围,$slice_range 变量应 传递 给代理服务器作为 Range 请求头字段。如果 缓存 已启用,则应将 $slice_range 添加到 缓存键 中,并且应 启用 对状态代码为 206 的响应的缓存。

嵌入变量

ngx_http_slice_module 模块支持以下嵌入变量

$slice_range
当前切片范围,采用 HTTP 字节范围 格式,例如 bytes=0-1048575