千家信息网

如何理解nginx rewrite和nginx-ingress rewrite

发表于:2025-02-02 作者:千家信息网编辑
千家信息网最后更新 2025年02月02日,这篇文章将为大家详细讲解有关如何理解nginx rewrite和nginx-ingress rewrite,文章内容质量较高,因此小编分享给大家做个参考,希望大家阅读完这篇文章后对相关知识有一定的了解
千家信息网最后更新 2025年02月02日如何理解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指令按照下面的顺序执行:

  1. server块按照顺序执行

  2. 执行匹配到的location块内的该模块指令

  3. 循环重定向最多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就分享到这里了,希望以上内容可以对大家有一定的帮助,可以学到更多知识。如果觉得文章不错,可以把它分享出去让更多的人看到。

0