如何理解nginx rewrite和nginx-ingress rewrite
这篇文章将为大家详细讲解有关如何理解nginx rewrite和nginx-ingress rewrite,文章内容质量较高,因此小编分享给大家做个参考,希望大家阅读完这篇文章后对相关知识有一定的了解。
在nginx的配置里面有个 proxy_pass 指令
location /name/ { proxy_pass http://127.0.0.1/remote/; }
像这样的配置,proxy_pass 后面加了uri /remote, 会将正常请求uri中与location匹配的部分用/remote替换掉,我有个类似的场景是:访问 aa.xxx.net/gateway/a/b 代理到后端的是类似于访问 svc-gateway:8080/a/b ,要怎么配置?截掉其中的gateway。首先想到的是用ingress里面的rewrite注解来解决问题。
nginx的rewrite
参考官方文档 链接
ngx_http_rewrite_module模块使用PCRE正则表达式更改请求URI,返回重定向或者有条件地选择配置。
break, if, return, rewrite, and set指令按照下面的顺序执行:
server块按照顺序执行
执行匹配到的location块内的该模块指令
循环重定向最多10次
break 指令
停止处理当前的ngx_http_rewrite_module指令集。如果在location内的if指令内包含break,则在location内的其他指令继续执行。
rewrite指令
Syntax: rewrite regex replacement [flag]; Default: — Context: server, location, if
如果指定的正则匹配请求的uri,uri将被replacement替换。rewrite按照在配置文件里面出现的顺序执行。如下示例:
location / { rewrite ^/a /b; #return 200 okokok; rewrite ^/b /c last; rewrite ^/d /b; } location = /b { return 401; } location = /c { return 402; }
像上面这种配置,访问localhost:port/d 会返回401
rewrite 不指定flag,则会继续往下执行
可以用flags选项终止处理后面的指令。如果replacement以http://、https:// 或$scheme开头,则请求不会往后执行,redirect将直接返回给客户端
flag选项
1、last 停止处理当前 ngx_http_rewrite_module 指令集,且用替换过的uri重新匹配新的location 2、break 选项和break指令的效果一样,不再匹配新的location 3、redirect,replacement不以 'http://' 等开头的时候,返回临时重定向302 4、permanent,返回永久重定向301
完整的重定向url按照请求的scheme和server_name_in_redirect和port_in_redirect 指令格式生成的
nginx-ingress里面的rewrite注解
官方链接
示例:
... nginx.ingress.kubernetes.io/rewrite-target: /$1 ... spec: rules: - host: aa.xxx.net http: paths: - backend: serviceName: svc-gateway servicePort: 8080 path: /gateway/(.*) - backend: serviceName: svc-ui servicePort: 80 path: /(.*) tls: - hosts: - aa.xxx.net secretName: xxx.net
在版本0.22.0或更高版本中,需要传递到重写路径的请求URI中的任何子字符串都必须在捕获组中显式定义。第一个组用$1
表示,可以作为rewrite-target的参数。
使用了rewrite-target注解后,所有path
被强制使用忽略大小写的正则,类似于nginx配置里面的:
location ~* "^/foo/.*" { ... }
spec.rules.host 字段不像nginx一样支持范匹配和正则,必须写完整的域名
为了实现更精确的路径匹配,ingress-nginx在将路径作为location块写入nginx模板之前,首先按长度对路径降序排序,长度里面包含正则字符。和nginx一样,正则模式下先匹配到的location会直接执行,不往下继续匹配。
扩展阅读:ingress-path-matching
Understanding Nginx Server and Location Block Selection Algorithms
第二种方式:
... kubernetes.io/ingress.class: nginx nginx.ingress.kubernetes.io/server-snippet: | if ($uri ~* "/gateway/.*") { rewrite ^/gateway/(.*) /$1 break; } nginx.ingress.kubernetes.io/use-regex: "true" ... spec: rules: - host: aa.xxx.net http: paths: - backend: serviceName: svc-gateway servicePort: 8080 path: /gateway(/|$)(.*) - backend: serviceName: svc-gateway servicePort: 8080 path: /(admin|bg|auth|monitor) - backend: serviceName: svc-ui servicePort: 80 path: / tls: - hosts: - aa.xxx.net secretName: xxx.net
nginx.ingress.kubernetes.io/server-snippet 注解用于在server块自定义配置,可以写nginx的配置实现更多需求。每个server块只能用一次。用此方式实现了类似proxy_pass的需求
关于如何理解nginx rewrite和nginx-ingress rewrite就分享到这里了,希望以上内容可以对大家有一定的帮助,可以学到更多知识。如果觉得文章不错,可以把它分享出去让更多的人看到。