跳到主要内容

Request Decompress 配置选项

request-decompress 插件解压使用 gzip 或 deflate 编码的请求体,使路由上的插件以及(可选的)上游服务收到解压后的请求体。 配置涵盖插件参数。

参数​

有关所有插件均可使用的配置项,请参阅插件通用配置。

  • max_req_body_size

    integer

    默认值:1048576

    有效值:

    >= 1

    编码后的请求体及解压结果的最大字节数。任一大小超过该值时,网关会拒绝请求并返回 413。

    读取和解压请求体时会执行此限制,因此超大的解压结果不会被完整缓存。此插件不会读取或检查不带 Content-Encoding 请求头的请求。可在网关的 config.yaml 中通过 nginx_config.http.client_max_body_size 设置全局限制,或使用 client-control 插件为路由或服务设置限制。

  • forward_compressed

    boolean

    默认值:false


    设为 true 时,在 request-decompress 之后、请求转发前运行的插件会收到解压后的请求体,而上游会收到压缩数据。如果请求体未被修改,该插件会恢复原始字节。如果其他插件修改了请求体,该插件会重新压缩。

    在 log 阶段运行的插件读取与发往上游相同的压缩请求体。