Nginx服务proxy代理请求及注意事项

近期某项目测试环境进行迁移，迁移后的接口域名多了一个端口，出现了跨域问题，所以利用Nginx代理来解决这些问题。

1.proxy_pass的斜杠问题

Nginx的官网将proxy_pass分为两种类型：

• 1.一种是只包含IP和端口号的（连端口之后的/也没有，这里要特别注意），比如proxy_pass http://localhost:8080，这种方式称为不带URI方式；

• 2.另一种是在端口号之后有其他路径的，包含了只有单个/的，如proxy_pass http://localhost:8080/，以及其他路径，比如proxy_pass http://localhost:8080/abc。

2.1 对于不带URI方式

对于不带URI方式，Nginx将会保留location中路径部分，比如：

location /api1/ {
  proxy_pass http://localhost:8080;
}

在访问http://localhost/api1/xxx时，会代理到http://localhost:8080/api1/xxx

2.2 对于带URI方式

对于带URI方式，nginx将使用诸如alias的替换方式对URL进行替换，并且这种替换只是字面上的替换，比如：

location /api2/ {
  proxy_pass http://localhost:8080/;
}

当访问http://localhost/api2/xxx时，http://localhost/api2/（注意最后的/）被替换成了http://localhost:8080/，然后再加上剩下的xxx，于是变成了http://localhost:8080/xxx。

2.3 总结

location目录后加"/",只能匹配目录，不加“/”不仅可以匹配目录还对目录进行模糊匹配。而proxy_pass无论加不加“/”,代理跳转地址都直接拼接。为了加深印象可以用下面的配置实验测试下：

server {
  listen       80;
  server_name  localhost;

  location /api1/ {
    proxy_pass http://localhost:8080;
  }
  # http://localhost/api1/xxx -> http://localhost:8080/api1/xxx


  location /api2/ {
    proxy_pass http://localhost:8080/;
  }
  # http://localhost/api2/xxx -> http://localhost:8080/xxx


  location /api3 {
    proxy_pass http://localhost:8080;
  }
  # http://localhost/api3/xxx -> http://localhost:8080/api3/xxx


  location /api4 {
    proxy_pass http://localhost:8080/;
  }
  # http://localhost/api4/xxx -> http://localhost:8080//xxx，请注意这里的双斜线，好好分析一下。


  location /api5/ {
    proxy_pass http://localhost:8080/haha;
  }
  # http://localhost/api5/xxx -> http://localhost:8080/hahaxxx，请注意这里的haha和xxx之间没有斜杠，分析一下原因。

  location /api6/ {
    proxy_pass http://localhost:8080/haha/;
  }
  # http://localhost/api6/xxx -> http://localhost:8080/haha/xxx

  location /api7 {
    proxy_pass http://localhost:8080/haha;
  }
  # http://localhost/api7/xxx -> http://localhost:8080/haha/xxx

  location /api8 {
    proxy_pass http://localhost:8080/haha/;
  }
  # http://localhost/api8/xxx -> http://localhost:8080/haha//xxx，请注意这里的双斜杠。
}

2.域名nginx配置信息

由于nginx.conf配置信息较多，本篇只关注跟axios和静态资源请求设置，顺便也将常见的一些配置项备注一下。具体设置如下：

# 设定http服务器，利用它的反向代理功能提供负载均衡支持
http {
  #连接超时时间
  keepalive_timeout  120;
  
  #gzip压缩开关及相关配置
  gzip on;
  gzip_min_length  1k;
  gzip_buffers     4 32k;
  gzip_http_version 1.1;
  gzip_comp_level 2;
  gzip_types       text/plain application/x-javascript text/css application/xml;
  gzip_vary on;
  gzip_disable "MSIE [1-6].";

  #设定实际的服务器列表 
  upstream zp_server{
    server 127.0.0.1:8089;
  }
  
  #HTTP服务器 
  server {
    #监听80端口
    listen    80
    
    #定义服务名称
    server_name  localhost;
    
    #首页
    index index.html
    
    #指向项目根目录
    root /opt/app/nginx/html/;
    
    #编码格式
    charset utf-8;
    
    #代理的路径（和upstream绑定），location 后面设置映射的路径
    location / {
      #代理配置参数
      proxy_connect_timeout 180;
      proxy_send_timeout 180;
      proxy_read_timeout 180;
      proxy_set_header Host $host;
      proxy_set_header X-Forwarder-For $remote_addr;
      proxy_pass http://zp_server/;
      
      #跨域相关设置
      add_header 'Access-Control-Allow-Origin' '*' always;
      add_header 'Access-Control-Allow-Credentials' 'true';
      add_header 'Access-Control-Allow-Headers' 'Origin, X-Requested-With, Content-Type, Accept' always;
     }
     
     #配置静态资源  解决js css文件无法加载无法访问的问题，注意末尾不能有 /
     location ~ .*\.(js|css|jpg|png)$ {
       proxy_pass http://zp_server;
     } 
  }
}