# Proxy Mirror 配置选项

Proxy Mirror 插件将全部传入请求或按比例采样的请求复制到次级上游，以便进行检查、测试或分析。<!-- --> <!-- -->配置涵盖静态设置和插件参数。

## 静态配置[​](#静态配置 "静态配�置的直接链接")

默认情况下，插件的超时值已在[默认配置](https://github.com/apache/apisix/blob/master/apisix/cli/config.lua)中预先设置。

需要更新的文件取决于网关的部署方式：

* 主机或 Docker
* Kubernetes（Helm）

对于主机或 Docker 部署，请配置以下设置：

config.yaml

```
plugin_attr:

  proxy-mirror:

    timeout:

      connect: 60s

      read: 60s

      send: 60s
```

然后重新加载网关以使更改生效。

对于 Helm 部署，请更新用于渲染 `plugin_attr.proxy-mirror` 的 Chart values，并保持 values 文件的其余内容不变。

对于 APISIX Helm Chart，请设置以下值：

values.yaml

```
apisix:

  pluginAttrs:

    proxy-mirror:

      timeout:

        connect: 60s

        read: 60s

        send: 60s
```

对于 API7 Gateway Helm Chart，请设置以下值：

values.yaml

```
pluginAttrs:

  proxy-mirror:

    timeout:

      connect: 60s

      read: 60s

      send: 60s
```

然后使用该网关版本对应的 Chart 应用 values 文件：

```
helm upgrade <release-name> <chart-name> -n <namespace> -f values.yaml
```

## 参数[​](#参数 "参数的直接链接")

有关所有插件通用的配置选项，请参阅插件[通用配置](https://docs.apiseven.com/apisix/reference/plugin-common-configurations.md)。

* host

  string

  必填

  ***

  接收镜像流量的主机地址。该地址应包含协议但不包含路径，例如 `http://127.0.0.1:8081`。

* path

  string

  ***

  镜像 HTTP 流量使用的请求路径。未指定时，使用当前路由的 URI 路径。对于原生 gRPC 和 grpc-web 流量，网关会忽略此字段，并保留访问阶段重写后的实际 gRPC 方法路径。

* path\_concat\_mode

  string

  默认值：`replace`

  有效值：

  `replace` 或 `prefix`

  ***

  指定 `path` 时使用的拼接模式。设置为 `replace` 时，配置的路径会替换请求路径；设置为 `prefix` 时，请求路径会追加到配置的路径之后。对于原生 gRPC 和 grpc-web 流量，网关会忽略此字段，并保留实际的 gRPC 方法路径。

* sample\_ratio

  number

  默认值：`1`

  有效值：

  大于或等于 0.00001 且小于或等于 1

  ***

  要镜像的请求比例。默认镜像所有请求。
