Nginx系列-4 proxy_pass使用和路径拼接问题

1.proxy_pass使用

proxy_pass指令用于请求的转发,请客户端请求转发至第三方服务器;如下所示:

复制代码
location /query {
	proxy_pass http://www.baidu.com;
}

上述案例将以/query开头的url请求转发至http://www.baidu.com.

proxy_pass用法较为简单,但使用时路径拼接问题需要重点关注,也是本章节的重点,以下通过案例的方案进行介绍和验证。
基准用例准备:

说明:路径拼接问题出现在前缀匹配上,完全匹配和正则表达式匹配不存在该问题。因此,可以借助完全匹配作为基准测试用例。

在8888端口上监听四个完全匹配路径:

shell 复制代码
server {
    server_name localhost;
    listen 8888;

     location = /test.html {
        return 200 "enter /test.html  ";
     }

    location = /proxy/test.html {
        return 200 "enter /proxy/test.html  ";
     }

     location = /ewen/test.html {
        return 200 "enter /ewen/test.html  ";
     }

     location = /ewentest.html {
        return 200 "enter /ewentest.html  ";
     }
}

测试结果如下所示:

shell 复制代码
[root@124 conf]# curl http://localhost:8888/test.html
enter /test.html  

[root@124 conf]# curl http://localhost:8888/proxy/test.html
enter /proxy/test.html 

[root@124 conf]# curl http://localhost:8888/ewen/test.html
enter /ewen/test.html  

[root@124 conf]# curl http://localhost:8888/ewentest.html
enter /ewentest.html  

问题来源:

shell 复制代码
location /代理url部分 {
	proxy_pass http://目标url部分
}

代理url部分是否以/结尾,以及目标url是否携带子路径和是否已/结尾等因素,可以将location /proxy {proxy_pass http://localhost:8888;}`组合形成8种场景:

shell 复制代码
#case1: 代理url部分不以/结尾,目标url没有子路径且不以/结尾
location /proxy {
	proxy_pass http://localhost:8888;
}
#case2: 代理url部分不以/结尾,目标没有子路径且url以/结尾
location /proxy {
	proxy_pass http://localhost:8888/;
}

#case3: 代理url部分以/结尾,目标url没有子路径且不以/结尾
location /proxy/ {
	proxy_pass http://localhost:8888;
}
#case4: 代理url部分以/结尾,目标url没有子路径,以/结尾
location /proxy/ {
	proxy_pass http://localhost:8888/;
}


#case5: 代理url不以/结尾,目标url存在子路径且不以/结尾
location /proxy {
	proxy_pass http://localhost:8888/ewen;
}
#case6: 代理url不以/结尾,目标url存在子路径且以/结尾
location /proxy {
	proxy_pass http://localhost:8888/ewen/;
}

#case7: 代理url以/结尾,目标url存在子路径且不以/结尾
location /proxy/ {
	proxy_pass http://localhost:8888/ewen;
}
#case8: 代理url以/结尾,目标url存在子路径且以/结尾
location /proxy/ {
	proxy_pass http://localhost:8888/ewen/;
}

当执行http://localhost:8001/proxy/test.html请求后,上述8种情况的访问路径为:

http://localhost:8888 http://localhost:8888/ http://localhost:8888/ewen http://localhost:8888/ewen/
/proxy/ http://localhost:8888/proxy/test.html http://localhost:8888/test.html http://localhost:8888/ewentest.html http://localhost:8888/ewen/test.html
/proxy http://localhost:8888/proxy/test.html http://localhost:8888/test.html http://localhost:8888/ewen/test.html http://localhost:8888/ewen//test.html

结论:

1\] 如果目标url仅包括ip和端口(没有斜线和子路径),如http://localhost:8888形式,则仅替换协议、域名和端口部分,其他路径保持不变: 如上述案例中: ```shell location /proxy/ { proxy_pass http://localhost:8888; } 和 location /proxy { proxy_pass http://localhost:8888; } 场景下,访问http://localhost:8001/proxy/test.html 都会转发到http://localhost:8888/proxy/test.html ``` \[2\] 其他场景,客户端的请求的url路径删除协议-域名-端口后,进行代理url的剪切,将剪切后的部分直接拼接到目标url尾部,以下以案例进行过程说明。 访问http://localhost:8001/proxy/test.html时: 如果location定义为: ```shell location /proxy { proxy_pass http://localhost:8888/ewen; } ``` http://localhost:8001/proxy/test.html删除协议-域名-端口部分后,得到/proxy/test.html; /proxy/test.html 删除代理url后,得到/test.html; /test.html拼接至目标url即http://localhost:8888/ewen后,得到http://localhost:8888/ewen/test.html. 如果location定义为: ```shell location /proxy/ { proxy_pass http://localhost:8888/ewen; } ``` http://localhost:8001/proxy/test.html删除协议-域名-端口部分后,得到/proxy/test.html; /proxy/test.html 删除代理url后,得到test.html; test.html拼接至目标url即http://localhost:8888/ewen后,得到http://localhost:8888/ewentest.html.

相关推荐
Tipriest_2 小时前
Ubuntu常用的软件格式deb, rpm, dmg, AppImage等打包及使用方法
linux·运维·ubuntu
真智AI2 小时前
利用 Claude Opus 4 自动化 GitHub 工作流:从安装到实战详解
运维·自动化·github
胡斌附体3 小时前
linux测试端口是否可被外部访问
linux·运维·服务器·python·测试·端口测试·临时服务器
愚润求学3 小时前
【Linux】自旋锁和读写锁
linux·运维
大锦终3 小时前
【Linux】常用基本指令
linux·运维·服务器·centos
知北游天4 小时前
Linux:多线程---深入互斥&&浅谈同步
linux·运维·服务器
Gappsong8744 小时前
【Linux学习】Linux安装并配置Redis
java·linux·运维·网络安全
try2find4 小时前
移动conda虚拟环境的安装目录
linux·运维·conda
码农101号5 小时前
Linux中容器文件操作和数据卷使用以及目录挂载
linux·运维·服务器
PanZonghui5 小时前
Centos项目部署之Nginx 的安装与卸载
linux·nginx