跳到主要内容

参数​

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

  • uri

    string

    新的上游 URI 路径。值可以是内置变量。

  • method

    string

    有效值：

    GET、POST、PUT、HEAD、DELETE、OPTIONS、MKCOL、COPY、MOVE、PROPFIND、LOCK、UNLOCK、PATCH 或 TRACE

    重写请求使用的 HTTP 方法。

  • regex_uri

    array[string]

    用于匹配客户端请求 URI 路径并组成新上游 URI 路径的正则表达式。当同时配置 uri 和 regex_uri 时，uri 具有更高的优先级。数组应包含一个或多个 键值对，键为用于匹配 URI 的正则表达式，值为新的上游 URI 路径。

    例如，使用 ["^/iresty/(.*)/(.*)", "/$1-$2", "^/theothers/*", "/theothers"]，如果最初请求发送到 /iresty/hello/world，插件将把上游 URI 路径重写为 /iresty/hello-world；如果最初请求发送到 /theothers/hello/world，插件将把上游 URI 路径重写为 /theothers。

  • set_ngx_uri

    boolean

    默认值：false

    该参数目前仅在 API7 企业版中可用，并将很快更新到 APISIX。

    如果为 false，ngx.var.uri 的值将保持不变，保留原始路由 uri。如果为 true，ngx.var.uri 将更新为 proxy-rewrite 中指定的 uri 值。

  • host

    string

    设置 Host 请求头。

  • headers

    object

    要执行的请求头动作。可以设置为动作动词 add、remove 和/或 set 的对象；或由要 set 的请求头组成的对象。

    当配置多个动作动词时，动作按 add、remove 和 set 的顺序执行。

    • add

      object

      追加到请求的请求头。如果请求中已存在该请求头，则将追加该请求头值。请求头值可以设置为常量、一个或多个内置变量，或使用 $1-$2-$3 等变量的 regex_uri 匹配结果。

      请求头值也可以是一个数组，此时会为每个值生成一条独立的请求头，而不是用逗号拼接成一条。自 API7 企业版 3.9.x 系列的 3.9.17 版本起可用，3.10.x 系列自 3.10.4 版本起可用。

    • set

      object

      设置到请求的请求头。如果请求中已存在该请求头，则将覆盖该请求头值。请求头值可以设置为常量、一个或多个内置变量，或使用 $1-$2-$3 等变量的 regex_uri 匹配结果。

      请求头值也可以是一个数组，此时会为每个值发送一条独立的请求头，而不是用逗号拼接成一条。自 API7 企业版 3.9.x 系列的 3.9.17 版本起可用，3.10.x 系列自 3.10.4 版本起可用。

      不应用于设置 Host。

    • remove

      array[string]

      从请求中删除的请求头。

  • use_real_request_uri_unsafe

    boolean

    默认值：false

    如果为 true，则绕过 URI 规范化并允许完整的原始请求 URI。启用此选项被认为是不安全的。