# ngx\_http\_slice\_module

* [示例配置](/nginx-docs/he-xin-gong-neng/http/ngx_http_slice_module.md#example_configuration)
* [指令](/nginx-docs/he-xin-gong-neng/http/ngx_http_slice_module.md#directives)
  * [slice](/nginx-docs/he-xin-gong-neng/http/ngx_http_slice_module.md#slice)
* [内嵌变量](/nginx-docs/he-xin-gong-neng/http/ngx_http_slice_module.md#embedded_variables)

`ngx_http_slice_module` 模块（1.9.8）是一个过滤器，它将请求拆分为子请求，每个子请求都返回一定范围的响应。该过滤器针对大响应缓存更加有效。

默认情况下不构建此模块，可在构建 nginx 时使用 `--with-http_slice_module` 配置参数启用。

## 示例配置 <a href="#example_configuration" id="example_configuration"></a>

```
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;
}
```

在此示例中，响应被拆分为 1M 大小的可缓存切片。

## 指令 <a href="#directives" id="directives"></a>

### slice

| -       | 说明                   |
| ------- | -------------------- |
| **语法**  | **slice** `size`;    |
| **默认**  | slice 0;             |
| **上下文** | http、server、location |

设置切片的 `size`（大小）。零值禁止将响应拆分为切片。请注意，值太低可能会导致内存使用过多并打开大量文件。

为了使子请求返回所需的范围，`$slice_range` 变量应作为 Range 请求头字段[传递](/nginx-docs/he-xin-gong-neng/http/ngx_http_proxy_module.md#proxy_set_header)给代理服务器。如果启用了缓存，则应将 `$slice_range` 添加到[缓存键](/nginx-docs/he-xin-gong-neng/http/ngx_http_proxy_module.md#proxy_cache_key)，并启用 206 状态代码的响应缓存。

## 内嵌变量 <a href="#embedded_variables" id="embedded_variables"></a>

`ngx_http_slice_module` 模块支持以下内嵌变量：

* `$slice_range`

  [HTTP 字节范围](https://tools.ietf.org/html/rfc7233#section-2.1)格式的当前切片范围，例如：`bytes=0-1048575`。

## 原文档

<http://nginx.org/en/docs/http/ngx_http_slice_module.html>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docshome.gitbook.io/nginx-docs/he-xin-gong-neng/http/ngx_http_slice_module.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.