跳到主要内容

参数​

请参阅通用配置了解所有插件可用的配置选项。

  • status_code

    integer

    vaild vaule:

    介于 200 到 599 之间（含边界值）

    响应中的新 HTTP 状态码。

  • body

    string

    新的响应体。Content-Length 头也将被重置。不应与 filters 一起配置。

  • body_base64

    boolean

    default: false

    如果为 true，则在发送给客户端之前解码 body 中配置的响应体，这对于图像和 protobuf 解码很有用。请注意，此配置不能用于解码上游响应。

  • headers

    object

    按 add、remove 和 set 的顺序执行的动作。

    • add

      array[string]

      追加到请求的响应头。如果请求中已存在该响应头，则将追加该响应头值。响应头值可以设置为常量，或一个或多个内置变量。

    • set

      object

      设置到请求的响应头。如果请求中已存在该响应头，则将覆盖该响应头值。响应头值可以设置为常量，或一个或多个内置变量。

    • remove

      array[string]

      从请求中删除的响应头。

  • vars

    array[array]

    一个或多个 APISIX 表达式 形式的匹配条件数组，用于按条件执行插件。

  • filters

    array[object]

    通过将一个指定字符串替换为另一个字符串来修改响应体的过滤器列表。不应与 body 一起配置。

    • regex

      string

      required

      在响应体上匹配的正则表达式模式。

    • scope

      string

      default: once

      vaild vaule:

      once or global

      替换范围。once 替换第一个匹配的实例，global 进行全局替换。

    • replace

      string

      required

      用于替换的内容。

    • options

      string

      default: jo

      用于控制匹配操作执行方式的正则表达式选项。请参阅 Lua NGINX 模块以了解可用选项。