Skip to main content
Version: 2.15

proxy-rewrite

描述#

proxy-rewrite 是处理上游代理信息重写的插件,支持对 schemeurihost 等信息进行重写。

属性#

名称类型必选项默认值有效值描述
schemestring"http"["http", "https"]不推荐使用。应该在 Upstream 的 scheme 字段设置上游的 scheme
uristring转发到上游的新 uri 地址。支持 NGINX variables 变量,例如:$arg_name
methodstring["GET", "POST", "PUT", "HEAD", "DELETE", "OPTIONS","MKCOL", "COPY", "MOVE", "PROPFIND", "PROPFIND","LOCK", "UNLOCK", "PATCH", "TRACE"]将路由的请求方法代理为该请求方法。
regex_uriarray[string]转发到上游的新 uri 地址。使用正则表达式匹配来自客户端的 uri,如果匹配成功,则使用模板替换转发到上游的 uri,如果没有匹配成功,则将客户端请求的 uri 转发至上游。当同时配置 uriregex_uri 属性时,优先使用 uri。例如:["^/iresty/(.)/(.)/(.*)","/$1-$2-$3"] 第一个元素代表匹配来自客户端请求的 uri 正则表达式,第二个元素代表匹配成功后转发到上游的 uri 模板。
hoststring转发到上游的新 host 地址,例如:iresty.com
headersobject转发到上游的新 headers,可以设置多个。如果 header 存在将进行重写,如果不存在则会添加到 header 中。如果你想要删除某个 header,请把对应的值设置为空字符串即可。支持使用 NGINX 的变量,例如 client_addr$remote_addr

启用插件#

你可以通过如下命令在指定路由上启用 proxy-rewrite 插件:

curl http://127.0.0.1:9080/apisix/admin/routes/1  \
-H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
"methods": ["GET"],
"uri": "/test/index.html",
"plugins": {
"proxy-rewrite": {
"uri": "/test/home.html",
"scheme": "http",
"host": "iresty.com",
"headers": {
"X-Api-Version": "v1",
"X-Api-Engine": "apisix",
"X-Api-useless": ""
}
}
},
"upstream": {
"type": "roundrobin",
"nodes": {
"127.0.0.1:80": 1
}
}
}'

测试插件#

通过上述命令启用插件后,可以使用如下命令测试插件是否启用成功:

curl -X GET http://127.0.0.1:9080/test/index.html

发送请求,查看上游服务的 access.log,如果输出信息与配置一致则表示 proxy-rewrite 插件已经生效。示例如下:

127.0.0.1 - [26/Sep/2019:10:52:20 +0800] iresty.com GET /test/home.html HTTP/1.1 200 38 - curl/7.29.0 - 0.000 199 107

禁用插件#

当你需要禁用 proxy-rewrite 插件时,可以通过以下命令删除相应的 JSON 配置,APISIX 将会自动重新加载相关配置,无需重启服务:

curl http://127.0.0.1:9080/apisix/admin/routes/1  -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
"methods": ["GET"],
"uri": "/test/index.html",
"plugins": {},
"upstream": {
"type": "roundrobin",
"nodes": {
"127.0.0.1:80": 1
}
}
}'