在nginx中配置proxy_pass代理轉(zhuǎn)發(fā)時(shí),如果在proxy_pass后面的url加/,表示絕對(duì)根路徑粱侣;如果沒(méi)有/,表示相對(duì)路徑蓖宦,把匹配的路徑部分也給代理走齐婴。
假設(shè)下面四種情況分別用 http://192.168.1.1/proxy/test.html 進(jìn)行訪問(wèn)。
第一種:
location /proxy/ {
proxy_pass http://127.0.0.1/;
}
代理到URL:http://127.0.0.1/test.html
第二種(相對(duì)于第一種稠茂,最后少一個(gè) / )
location /proxy/ {
proxy_pass http://127.0.0.1;
}
代理到URL:http://127.0.0.1/proxy/test.html
第三種:
location /proxy/ {
proxy_pass http://127.0.0.1/aaa/;
}
代理到URL:http://127.0.0.1/aaa/test.html
第四種(相對(duì)于第三種柠偶,最后少一個(gè) / )
location /proxy/ {
proxy_pass http://127.0.0.1/aaa;
}
代理到URL:http://127.0.0.1/aaatest.html
nginx中有兩個(gè)模塊都有proxy_pass
指令。
-
ngx_http_proxy_module
的proxy_pass
:
語(yǔ)法: proxy_pass URL;場(chǎng)景: location, if in location, limit_except說(shuō)明: 設(shè)置后端代理服務(wù)器的協(xié)議(protocol)和地址(address),以及l(fā)ocation中可以匹配的一個(gè)可選的URI睬关。協(xié)議可以是"http"或"https"诱担。地址可以是一個(gè)域名或ip地址和端口,或者一個(gè) unix-domain socket 路徑电爹。 詳見(jiàn)官方文檔: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_passURI的匹配蔫仙,本文第四部分重點(diǎn)討論。
-
ngx_stream_proxy_module
的proxy_pass
:
語(yǔ)法: proxy_pass address;場(chǎng)景: server說(shuō)明: 設(shè)置后端代理服務(wù)器的地址丐箩。這個(gè)地址(address)可以是一個(gè)域名或ip地址和端口摇邦,或者一個(gè) unix-domain socket路徑。 詳見(jiàn)官方文檔: http://nginx.org/en/docs/stream/ngx_stream_proxy_module.html#proxy_pass
二屎勘、兩個(gè)proxy_pass
的關(guān)系和區(qū)別
在兩個(gè)模塊中施籍,兩個(gè)proxy_pass
都是用來(lái)做后端代理的指令。
ngx_stream_proxy_module
模塊的proxy_pass
指令只能在server段使用使用, 只需要提供域名或ip地址和端口概漱》ㄌ荩可以理解為端口轉(zhuǎn)發(fā),可以是tcp端口犀概,也可以是udp端口立哑。
ngx_http_proxy_module
模塊的proxy_pass
指令需要在location段,location中的if段姻灶,limit_except段中使用铛绰,處理需要提供域名或ip地址和端口外,還需要提供協(xié)議产喉,如"http"或"https"捂掰,還有一個(gè)可選的uri可以配置敢会。
三、proxy_pass的具體用法
ngx_stream_proxy_module
模塊的proxy_pass
指令
server {
listen 127.0.0.1:12345;
proxy_pass 127.0.0.1:8080;
}
server {
listen 12345;
proxy_connect_timeout 1s;
proxy_timeout 1m;
proxy_pass example.com:12345;
}
server {
listen 53 udp;
proxy_responses 1;
proxy_timeout 20s;
proxy_pass dns.example.com:53;
}
server {
listen [::1]:12345;
proxy_pass unix:/tmp/stream.socket;
}
ngx_http_proxy_module
模塊的proxy_pass
指令
server {
listen 80;
server_name www.test.com;
# 正常代理这嚣,不修改后端url的
location /some/path/ {
proxy_pass http://127.0.0.1;
}
# 修改后端url地址的代理(本例后端地址中鸥昏,最后帶了一個(gè)斜線)
location /testb {
proxy_pass http://www.other.com:8801/;
}
# 使用 if in location
location /google {
if ( $geoip_country_code ~ (RU|CN) ) {
proxy_pass http://www.google.hk;
}
}
location /yongfu/ {
# 沒(méi)有匹配 limit_except 的,代理到 unix:/tmp/backend.socket:/uri/
proxy_pass http://unix:/tmp/backend.socket:/uri/;;
# 匹配到請(qǐng)求方法為: PUT or DELETE, 代理到9080
limit_except PUT DELETE {
proxy_pass http://127.0.0.1:9080;
}
}
}
四姐帚、proxy_pass
后吏垮,后端服務(wù)器的url
(request_uri
)情況分析
server {
listen 80;
server_name www.test.com;
# 情形A
# 訪問(wèn) http://www.test.com/testa/aaaa
# 后端的request_uri為: /testa/aaaa
location ^~ /testa/ {
proxy_pass http://127.0.0.1:8801;
}
# 情形B
# 訪問(wèn) http://www.test.com/testb/bbbb
# 后端的request_uri為: /bbbb
location ^~ /testb/ {
proxy_pass http://127.0.0.1:8801/;
}
# 情形C
# 下面這段location是正確的
location ~ /testc {
proxy_pass http://127.0.0.1:8801;
}
# 情形D
# 下面這段location是錯(cuò)誤的
#
# nginx -t 時(shí),會(huì)報(bào)如下錯(cuò)誤:
#
# nginx: [emerg] "proxy_pass" cannot have URI part in location given by regular
# expression, or inside named location, or inside "if" statement, or inside
# "limit_except" block in /opt/app/nginx/conf/vhost/test.conf:17
#
# 當(dāng)location為正則表達(dá)式時(shí)罐旗,proxy_pass 不能包含URI部分膳汪。本例中包含了"/"
location ~ /testd {
proxy_pass http://127.0.0.1:8801/; # 記住,location為正則表達(dá)式時(shí)九秀,不能這樣寫R潘浴!鼓蜒!
}
# 情形E
# 訪問(wèn) http://www.test.com/ccc/bbbb
# 后端的request_uri為: /aaa/ccc/bbbb
location /ccc/ {
proxy_pass http://127.0.0.1:8801/aaa$request_uri;
}
# 情形F
# 訪問(wèn) http://www.test.com/namea/ddd
# 后端的request_uri為: /yongfu?namea=ddd
location /namea/ {
rewrite /namea/([^/]+) /yongfu?namea=$1 break;
proxy_pass http://127.0.0.1:8801;
}
# 情形G
# 訪問(wèn) http://www.test.com/nameb/eee
# 后端的request_uri為: /yongfu?nameb=eee
location /nameb/ {
rewrite /nameb/([^/]+) /yongfu?nameb=$1 break;
proxy_pass http://127.0.0.1:8801/;
}
access_log /data/logs/www/www.test.com.log;
}
server {
listen 8801;
server_name www.test.com;
root /data/www/test;
index index.php index.html;
rewrite ^(.*)$ /test.php?u=$1 last;
location ~ \.php$ {
try_files $uri =404;
fastcgi_pass unix:/tmp/php-cgi.sock;
fastcgi_index index.php;
include fastcgi.conf;
}
access_log /data/logs/www/www.test.com.8801.log;
}
文件: /data/www/test/test.php
<?php
echo '$_SERVER[REQUEST_URI]:' . $_SERVER['REQUEST_URI'];
通過(guò)查看 $_SERVER['REQUEST_URI'] 的值痹换,我們可以看到每次請(qǐng)求的后端的request_uri的值,進(jìn)行驗(yàn)證都弹。
小結(jié)
情形A和情形B進(jìn)行對(duì)比娇豫,可以知道proxy_pass
后帶一個(gè)URI,可以是斜杠(/)也可以是其他uri,對(duì)后端request_uri
變量的影響缔杉。
情形D說(shuō)明,當(dāng)location為正則表達(dá)式時(shí)搁料,proxy_pass
不能包含URI部分或详。
情形E通過(guò)變量($request_uri, 也可以是其他變量),對(duì)后端的request_uri
進(jìn)行改寫郭计。
情形F和情形G通過(guò)rewrite配合break標(biāo)志,對(duì)url進(jìn)行改寫霸琴,并改寫后端的request_uri
。需要注意昭伸,proxy_pass
地址的URI部分在情形G中無(wú)效梧乘,不管如何設(shè)置,都會(huì)被忽略庐杨。