nginx proxy_pass

功能 Nginx 的ngx_stream_proxy_module和ngx_http_proxy_module两个模块中,都有 proxy_pass 指令。其主要功能是为后端做代理,协议转发,请求转发等。

二、 用法和区别

  1. 官网介绍

ngx_stream_proxy_module 的 proxy_pass

语法:proxy_pass address; 默认值:— 场景:server 段 说明:设置代理服务器的地址。代理地址可以是域名或者IP加端口,也可以是一个UNIX的socket路径 ngx_http_proxy_module 的 proxy_pass

语法:proxy_pass URL; 默认值:— 场景:location 段,location中的if段,limit_except段 说明:设置后端代理服务器的地址和协议,还可以附加可选的URI映射。协议可以是 http 或者 https。地址可以是域名或者IP,可以附加指定端口,也可以是UNIX的socket路径,路径要放在unix: 和 : 之间

  1. 区别

从上面的各自说明可以看出两个 proxy_pass 指令都是做后端的代理配置。

除了应用场景的段不同之外,ngx_stream_proxy_module 的 proxy_pass 只能转发域名或IP加端口的请求,即端口转发。

ngx_http_proxy_module 的 proxy_pass 除了包含前者的功能外,还可以实现协议转发,如 http 和 https 与 UNIX socket 三者的相互转发,另外还有很实用的URI转发

  1. 用法示例 3.1 ngx_stream_proxy_module 的 proxy_pass server { listen 8000; proxy_pass 127.0.0.1:8080; # IP+端口转发 }

server { listen 8000; proxy_pass test.com:8080; # 域名+端口转发 }

server { listen [::1]:8000; proxy_pass unix:/tmp/stream.socket; # UNIX socket转发 } 3.2 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地址的代理(本例后端地址中,最后带了一个斜线)
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 /limit/ {
    # 没有匹配 limit_except 的,代理到 unix:/tmp/backend.socket:/uri/
    proxy_pass http://unix:/tmp/backend.socket:/uri/;;

    # 匹配到请求方法为: PUT or DELETE, 代理到9080
    limit_except PUT DELETE {
        proxy_pass http://127.0.0.1:9080;
    }
}

} 4. ngx_http_proxy_module.proxy_pass 的 URI 转发映射分析1 准备文件 /data/www/test/test.php 如下: