跳到主要内容

参数​

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

  • uri

    string

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

  • method

    string

    vaild vaule:

    GET, POST, PUT, HEAD, DELETE, OPTIONS, MKCOL, COPY, MOVE, PROPFIND, LOCK, UNLOCK, PATCH, or 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

    default: 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 匹配结果。

    • set

      object

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

      不应用于设置 Host。

    • remove

      array[string]

      从请求中删除的请求头。

  • use_real_request_uri_unsafe

    boolean

    default: false

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