Nginx官方文档(三十二)【ngx_http_slice_module|ngx_http_spdy_module】

以你之姓@ 2021-07-04 16:46 535阅读 0赞

# ngx\_http\_slice\_module #

*  示例配置
 *  指令
    
     *  slice
 *  内嵌变量

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

默认情况下不构建此模块，可在构建 nginx 时使用 `--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;
    }

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

## 指令 ##

### slice ###

<table> 
 <thead> 
  <tr> 
   <th align="left">-</th> 
   <th align="left">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><strong>语法</strong></td> 
   <td align="left"><strong>slice</strong> <code>size</code>;</td> 
  </tr> 
  <tr> 
   <td align="left"><strong>默认</strong></td> 
   <td align="left">slice 0;</td> 
  </tr> 
  <tr> 
   <td align="left"><strong>上下文</strong></td> 
   <td align="left">http、server、location</td> 
  </tr> 
 </tbody> 
</table>

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

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

## 内嵌变量 ##

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

*  `$slice_range`
    
    [HTTP 字节范围][HTTP]格式的当前切片范围，例如：`bytes=0-1048575`。

## 原文档 ##

[http://nginx.org/en/docs/http/ngx\_http\_slice\_module.html][http_nginx.org_en_docs_http_ngx_http_slice_module.html]

--------------------

# ngx\_http\_spdy\_module #

*  已知问题
 *  示例配置
 *  指令
    
     *  spdy\_chunk\_size
     *  spdy\_headers\_comp
 *  内嵌变量

**该模块已被 `1.9.5` 中的 [ngx\_http\_v2\_module][ngx_http_v2_module] 模块所取代。**

`ngx_http_spdy_module` 模块为 [SPDY][] 提供实验性支持。目前，SPDY 协议[草案 3.1][3.1]已实施。

> 在 1.5.10 版之前，已实施 SPDY 协议[草案 2][2]。

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

## 已知问题 ##

该模块处于实验阶段，请注意风险。

当前的 SPDY 协议实现不支持**服务器推送**。

在 1.5.9 之前的版本中，SPDY 连接中的响应无法做到速率限制。

无论 proxy\_request\_buffering、fastcgi\_request\_buffering、uwsgi\_request\_buffering 和 scgi\_request\_buffering 指令为何值，都无法禁用客户端请求体缓冲。

## 示例配置 ##

server {
        listen 443 ssl spdy;
    
        ssl_certificate server.crt;
        ssl_certificate_key server.key;
        ...
    }

> 请注意，为了在同一端口上同时接受 HTTPS 和 SPDY 连接，使用的 [OpenSSL][] 库应支持 **Next Protocol Negotiation** TLS 扩展，该扩展自 OpenSSL 1.0.1 版开始可用。

## 指令 ##

### spdy\_chunk\_size ###

<table> 
 <thead> 
  <tr> 
   <th align="left">-</th> 
   <th align="left">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><strong>语法</strong></td> 
   <td align="left"><strong>spdy_chunk_size</strong> <code>size</code>;</td> 
  </tr> 
  <tr> 
   <td align="left"><strong>默认</strong></td> 
   <td align="left">spdy_chunk_size 8k;</td> 
  </tr> 
  <tr> 
   <td align="left"><strong>上下文</strong></td> 
   <td align="left">http、server、location</td> 
  </tr> 
  <tr> 
   <td align="left"><strong>提示</strong></td> 
   <td align="left">该指令在 1.5.9 版本中出现</td> 
  </tr> 
 </tbody> 
</table>

设置响应体[分块][Link 1]的最大大小。值太低会导致更高的开销。由于 [HOL 阻塞][HOL]，太高的值会破坏优先级。

### spdy\_headers\_comp ###

<table> 
 <thead> 
  <tr> 
   <th align="left">-</th> 
   <th align="left">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><strong>语法</strong></td> 
   <td align="left"><strong>spdy_headers_comp</strong> <code>level</code>;</td> 
  </tr> 
  <tr> 
   <td align="left"><strong>默认</strong></td> 
   <td align="left">spdy_headers_comp 0;</td> 
  </tr> 
  <tr> 
   <td align="left"><strong>上下文</strong></td> 
   <td align="left">http、server</td> 
  </tr> 
 </tbody> 
</table>

设置响应头压缩级别（`level`），范围从 `1`（最快，压缩程度较低）到 `9`（最慢，压缩程度最佳）。特殊值 `0` 将关闭头压缩。

## 内嵌变量 ##

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

*  `$spdy`
    
    SPDY 连接的 SPDY 协议版本，无则为空字符串
 *  `$spdy_request_priority`
    
    请求 SPDY 连接的优先级，无则为空字符串

## 原文档 ##

[http://nginx.org/en/docs/http/ngx\_http\_spdy\_module.html][http_nginx.org_en_docs_http_ngx_http_spdy_module.html]

[HTTP]: https://tools.ietf.org/html/rfc7233#section-2.1
[http_nginx.org_en_docs_http_ngx_http_slice_module.html]: http://nginx.org/en/docs/http/ngx_http_slice_module.html
[ngx_http_v2_module]: http://nginx.org/en/docs/http/ngx_http_v2_module.html
[SPDY]: http://www.chromium.org/spdy/spdy-protocol
[3.1]: http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft3-1
[2]: http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft2
[OpenSSL]: http://www.openssl.org/
[Link 1]: http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft2#TOC-Data-frames
[HOL]: http://en.wikipedia.org/wiki/Head-of-line_blocking
[http_nginx.org_en_docs_http_ngx_http_spdy_module.html]: http://nginx.org/en/docs/http/ngx_http_spdy_module.html