proxy-rewrite

描述

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

属性

名称类型必选项默认值有效值描述
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 转发至上游。当同时配置 uriregex_uri 属性时,优先使用 uri。当前支持多组正则表达式进行模式匹配,插件将逐一尝试匹配直至成功或全部失败。例如:[“^/iresty/(.)/(.)/(.)”, “/$1-$2-$3”, ^/theothers/(.)/(.*)”, “/theothers/$1-$2”],奇数索引的元素代表匹配来自客户端请求的 uri 正则表达式,偶数索引的元素代表匹配成功后转发到上游的 uri 模板。请注意该值的长度必须为偶数值
hoststring转发到上游的新 host 地址,例如:iresty.com
headersobject
headers.addobject添加新的请求头,如果头已经存在,会追加到末尾。格式为 {“name”: “value”, …}。这个值能够以 $var 的格式包含 NGINX 变量,比如 $remote_addr $balancer_ip。也支持以变量的形式引用 regex_uri 的匹配结果,比如 $1-$2-$3
headers.setobject改写请求头,如果请求头不存在,则会添加这个请求头。格式为 {“name”: “value”, …}。这个值能够以 $var 的格式包含 NGINX 变量,比如 $remote_addr $balancer_ip。也支持以变量的形式引用 regex_uri 的匹配结果,比如 $1-$2-$3。请注意,若想设置 Host 请求头,应使用 host 属性。
headers.removearray移除请求头。格式为 [“name”, …]
use_real_request_uri_unsafebooleanfalse使用 real_request_uri(nginx 中的原始 $request_uri)绕过 URI 规范化。启用它被认为是不安全的,因为它会绕过所有 URI 规范化步骤。

Header 优先级

Header 头的相关配置,遵循如下优先级进行执行:

add > remove > set

启用插件

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

  1. curl http://127.0.0.1:9180/apisix/admin/routes/1 \
  2. -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  3. {
  4. "methods": ["GET"],
  5. "uri": "/test/index.html",
  6. "plugins": {
  7. "proxy-rewrite": {
  8. "uri": "/test/home.html",
  9. "host": "iresty.com",
  10. "headers": {
  11. "set": {
  12. "X-Api-Version": "v1",
  13. "X-Api-Engine": "apisix",
  14. "X-Api-useless": ""
  15. },
  16. "add": {
  17. "X-Request-ID": "112233"
  18. },
  19. "remove":[
  20. "X-test"
  21. ]
  22. }
  23. }
  24. },
  25. "upstream": {
  26. "type": "roundrobin",
  27. "nodes": {
  28. "127.0.0.1:80": 1
  29. }
  30. }
  31. }'

测试插件

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

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

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

  1. 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 将会自动重新加载相关配置,无需重启服务:

  1. curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  2. {
  3. "methods": ["GET"],
  4. "uri": "/test/index.html",
  5. "plugins": {},
  6. "upstream": {
  7. "type": "roundrobin",
  8. "nodes": {
  9. "127.0.0.1:80": 1
  10. }
  11. }
  12. }'