Nginx中proxy_pass/proxy_redirect/proxy_set_header配置说明

ngx_http_proxy_module

实现将请求转发到其他服务器。

proxy_pass

语法: proxy_pass URL

默认: -

上下文:locaiton,location中的if,limit_except

location映射的服务器设置协议、地址、URI。

  • 协议可以是http或者https

  • 地址可以是域名或者IP,可以同时指定端口;

  • 地址也可以是以unix为前缀,包含在:中间的UNIX域名套接字路径;

    proxy_pass http://unix:/tmp/backend.socket:/uri/;
    
  • 如果proxy_pass指令中带有URI,当请求被转发到服务器时,客户端原请求中标准的URI将会被指令中URI替换;

    location /name/ {
        proxy_pass http://127.0.0.1/remote/;
    }
    
  • 如果proxy_pass指令中没有URI,当请求被转发到服务器时,将会使用客户端原请求中的URI;

  • 不可替换URI的情况

    • location通过正字表达式定义;

    • location内部通过rewrite指令修改过URI;

      location /name/ {
          rewrite    /name/([^/]+) /users?name=$1 break;
          proxy_pass http://127.0.0.1;
      }
      
    • proxy_pass指令中使用变量;

      location /name/ {
          proxy_pass http://127.0.0.1$request_uri;
      }
      

proxy_redirect

语法:proxy_redirect default;

​ proxy_redirect off;

​ proxy_redirect redirect replacement;

默认:proxy_redirect default;

上下文:http, server, location

设置对代理服务器响应头中的LocationRefresh字段的重写。

  • 该指令实现将代理服务器响应头中的字段“Location: http://localhost:8000/two/some/uri/”重写为“Location: http://frontend/one/some/uri/”;

    proxy_redirect http://localhost:8000/two/ http://frontend/one/;
    
  • 如果省略repacement字符串,如果默认服务器不是80端口,那么将会插入默认服务器的名称和端口;

    proxy_redirect http://localhost:8000/two/ /;
    
  • 指定default参数的情况下,使用locationproxy_pass的参数。如下两个指令是等价的

    location /one/ {
        proxy_pass     http://upstream:port/two/;
        proxy_redirect default;
    
    location /one/ {
        proxy_pass     http://upstream:port/two/;
        proxy_redirect http://upstream:port/two/ /one/;
    
  • proxy_pass指令中有变量的情况下,proxy_redirect指令不能指定default参数;

  • replacement中可以使用变量,redirect从1.1.11版本开始也可以使用变量;

    proxy_redirect http://localhost:8000/ http://$host:$server_port/;
    
    proxy_redirect http://$proxy_host:8000/ /;
    
  • 从1.1.11版本开始proxy_redirect指令中允许使用正则表达式

    • ~起始表示匹配时大小写敏感;

      • ~*起始表示匹配时大小写不敏感;

      • redirect中可以包含命名和positional captures,然后在replacement中引用;

        proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2;
        proxy_redirect ~*/user/([^/]+)/(.+)$      http://$1.example.com/$2;
        
  • 可以同时指定多个proxy_redirect,如果指定了off参数,表示当前级别下的所有proxy_redirect指令将失效;

    proxy_redirect off;
    proxy_redirect default;
    proxy_redirect http://localhost:8000/  /;
    proxy_redirect http://www.example.com/ /;
    
  • 下面指令实现给相对路径上增加主机名;

    proxy_redirect / /;
    

proxy_set_header

语法: proxy_set_header field value;

默认: proxy_set_header Host $proxy_host;

​ proxy_set_header Connection close;

上下文: http, server, location

转发请求到代理服务器时该指令允许重新定义或者追加消息头中的字段。

  • value的内容可以使文本、变量或者二者的组合;

  • 如果当前指令中没有定义proxy_set_header指令,则可以继承上一级别中的定义;

  • 默认情况只重新定义两个字段;

    proxy_set_header Host       $proxy_host;
    proxy_set_header Connection close;
    
  • 其中缓存的情况,原始请求中的“If-Modified-Since”, “If-Unmodified-Since”, “If-None-Match”, “If-Match”, “Range”, 和“If-Range”不会转发到代理服务器;

  • 不改变请求头中的"Host"字段的设置

    proxy_set_header Host       $http_host;
    

    如果客户端请求头中没有http_host字段,则不会转发到服务器,这种情况下使用$host变量相对更好,$host变量相当于请求头中Host字段中服务器名称,或者请求头中没有Host字段时等价于主服务器的名称;

    proxy_set_header Host       $host;
    
  • 设置将服务器器名称和端口一起转发到代理服务器;

    proxy_set_header Host       $host:$proxy_port;
    
  • 如果请求头中的字段value为空字符串,则不会转发到服务器;

    proxy_set_header Accept-Encoding "";
    

ngx_http_proxy_module自带参数

自带参数可以通过proxy_set_header指令使用。

$proxy_host

proxy_pass指令中定义的代理服务器的名称和端口

$proxy_port

proxy_pass指令中定义的代理服务器的端口,或者是指定协议的默认端口

$proxy_add_x_forwarded_for

表示客户端请求头中的X-Forwarded-For字段,该字段中包含$removte_addr变量,通过逗号,分隔。如果客户端请求头中没有出现X-Forwarded-For字段,proxy_add_x_forwarded_for`变量等价于`remote_addr`。

ngx_http_proxy_module中的其他参数请参考官方网站

其他文章列表

spring web service系列1
spring web service系列2
spring web service系列3
maven配置文件settings.xml详解
Nginx转发请求过程解析
Nginx中的负载均衡算法
Nginx upstream指令配置说明
Nginx中虚拟服务器server指令配置说明
Nginx中ngx_http_core_module相关指令配置说明
Java自带JVM监控工具jstat使用详细说明
Java自带JVM监控工具jps使用详细说明
Java自带故障分析工具jmap工具使用说明
Java自带故障分析工具jhat工具使用说明

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,456评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,370评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,337评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,583评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,596评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,572评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,936评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,595评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,850评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,371评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,951评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2 342

推荐阅读更多精彩内容