nginx.conf配置_nginx.conf loca-CSDN博客

本文链接：https://blog.csdn.net/song854601134/article/details/127920576

文章目录

nginx.conf location 的使用

Location语法规则

指令：location [ = | ~ | ~* | ^~ ] uri { ... } 或者  location @name { ... }  ； 可存在位置：	server， location

= 严格匹配。如果请求匹配这个location，那么将停止搜索并立即处理此请求（匹配不上还是会继续往下搜索）
~ 区分大小写匹配(可用正则表达式)
~* 不区分大小写匹配(可用正则表达式)
!~ 区分大小写不匹配
!~* 不区分大小写不匹配
^~ 如果把这个前缀用于一个常规字符串,那么告诉nginx 如果路径匹配那么不测试正则表达式

匹配优先级

首先精确匹配 =
其次前缀匹配 ^~
其次是按文件中顺序的正则匹配
然后匹配不带任何修饰的前缀匹配
最后是交给 / 通用匹配
当有匹配成功时候，停止匹配，按当前匹配规则处理请求

1.1 先普通 location ，再正则 location

location 指令大致两种类型配置参数： “最大前缀（路径）” 和 “正则匹配”

Nginx 其实是“先匹配普通 location ，再匹配正则 location ”，但是普通 location 的匹配结果又分两种：一种是“严格精确匹配(真的url 就是我们location 后面写的那么多 )”，官方英文说法是“ exact match ”；另一种是“最大前缀匹配( 路径前什么都不写 )”，官方英文说法是“ Literal strings match the beginning portion of the query – the most specific match will be used. ”。

严格精确匹配后不会再继续匹配正则

我们做个实验：

例题 1 ：假设 nginx 的配置如下

server {
       listen       80;
       server_name  localhost;
       location / {
           root   /usr/share/nginx/html;
           index  index.html index.htm;
           deny all;
       }

       location ~ \.html$ {
           root   /usr/share/nginx/html;
           index  index.html index.htm;
           allow all;
       }
}

注意这里是linux下的配置， window下 root 后不加 /

当前目录结构如下

[root@web01 conf.d]# tree /usr/share/nginx/html
/usr/share/nginx/html
├── 50x.html
└── index.html

测试结果1

http://localhost/	403 Forbidden

说明被匹配到location / {}了，原因很简单HTTP 请求 GET / 被“严格精确”匹配到了普通 location / {} ，则会停止搜索正则 location

测试结果2

 http://localhost/index.html	Welcome to nginx

说明没有被location /匹配，否则会 403 Forbidden ，但 /index.html 的确也是以“ / ”开头的，只不过此时的普通 location / 的匹配结果是“最大前缀”匹配，所以 Nginx 会继续搜索正则 location ， location ~ .html$ 表达了以 .html 结尾的都 allow all; 于是接着就访问到了实际存在的 index.html 页面

测试结果3

http://localhost/index_notfound.html	404 Not Found

同样的道理先匹配 location / {} ，但属于“普通 location 的最大前缀匹配”，于是后面被“正则 location ” location ~ .html$ {} 覆盖了，最终 allow all ；但的确目录下不存在index_notfound.html 页面，于是 404 Not Found

测试结果4

http://localhost/index_notfound.txt  403 Forbidden

说明先匹配上了 location / {…deny all;} 尽管属于“普通 location ”的最大前缀匹配结果，继续搜索正则 location ，但是 /index.txt 不是以 .html结尾的，正则 location 失败，最终采纳普通 location 的最大前缀匹配结果，于是 deny all 了

1.2 普通 location 的“显式”严格匹配前缀“`=`”，不继续匹配正则前缀“ `^~` ”

上面我们演示的普通 location 都是不加任何前缀的，其实普通 location 也可以加前缀：“ ^~ ”和“ = ”。其中“ ^~”的意思是“非正则，不需要继续正则匹配”，也就是通常我们的普通 location ，还会继续搜索正则 location （恰好严格精确匹配除外），但是 nginx 很人性化,允许配置人员通过使用 ^~ 告诉 nginx 某条普通 location ，无论最大前缀匹配，还是严格精确匹配都终止继续搜索正则 location 。
而“ = ”则表达的是普通 location 不允许“最大前缀”匹配结果，必须严格等于，严格精确匹配。所以即使严格匹配没有匹配上，也是不会继续搜索正则location的。

注意：如果我们配置了 location = /new ，恰好请求路径也是 /new,这里就是严格精确匹配的情况，nginx 会应用 “恰好严格精确匹配停止继续搜索正则”这条规则。也就是说配置了= 后，不一定会停止搜索正则，前提是需要匹配上这条 = 规则。

server {
       listen       80;
       server_name  localhost;
       location ^~ / {
           root   /usr/share/nginx/html;
           index  index.html index.htm;
           deny all;
       }

       location ~ \.html$ {
           root   /usr/share/nginx/html; 
           index  index.html index.htm;
           allow all;
       }
}

注意这里是linux下的配置， window下 root 后不加 /

测试结果1

http://localhost/index_notfound.html  403 Forbidden

先匹配 location ^~ / {} ，因为其是非正则，不需要继续正则匹配，所以直接停止继续匹配，进入 location ^~ / {}

1.3 普通 location 与编辑顺序无关

对于普通 location 指令，匹配规则是：最大前缀匹配（与顺序无关），如果恰好是严格精确匹配结果或者加有前缀“ ^~ ”或“ = ”（符号“ = ”只能严格匹配，不能前缀匹配），则停止搜索正则 location ；

配置 1.3.1

server {
       listen       80;
       server_name  localhost;
       location  /prefix/ {
               deny all;  
       }  
       location  /prefix/mid/ {
               allow all; 
       }  
}

配置 1.3.2

server {

       listen       80;
       server_name  localhost;
       location  /prefix/mid/ {
               allow all; 
       }  
       location  /prefix/ {
               deny all;  
       }  
}

测试结果：

前提是html文件下要有这个t.html 文件

请求	配置 3.1 结果	配置 3.2结果
http://localhost:80/prefix/t.html	403 Forbidden	403 Forbidden
http://localhost:80/prefix/mid/t.html	可以拿到	可以拿到

结果表明：普通 location 的匹配规则是“最大前缀”匹配，而且与编辑顺序无关。

配置 3.1

server {
       listen       80;
       server_name  localhost;
       location ~ \.html$ {
           allow all; 
       }  

       location ~ ^/prefix/.*\.html$ {
           deny all;  
       }  
}

配置 3.2

server {

       listen       80;
       server_name  localhost;
       location ~ ^/prefix/.*\.html$ {
           deny all;  
       }  

       location ~ \.html$ {
           allow all; 
       } 
}

测试结果：

前提是html文件下要有这个regextest.html 文件

请求	配置 3.1 结果	配置 3.2结果
http://localhost:9090/regextest.html	可以拿到	可以拿到
http://localhost:9090/prefix/regextest.html	404 Not Found	403 Forbidden

1.4 前缀@的使用“ `^~` ”

配置如下：

server {

       listen       80;
       server_name  localhost;
        location  / {
           root   html;
           index  index.html index.htm;
           allow all；
       }
       #error_page 404 http://www.baidu.com # 直接这样是不允许的
       error_page 404 = @fallback;
       location @fallback {
           proxy_pass http://www.baidu.com;

       }
}

上述配置文件的意思是：如果请求的 URI 存在，则本 nginx 返回对应的页面；如果不存在，则把请求代理到baidu.com 上去做个弥补（注： nginx 当发现 URI 对应的页面不存在， HTTP_StatusCode 会是 404 ，此时error_page 404 指令能捕获它）。

二、 root和alias的区别

指令：root path ；可存在位置：http、server、location、if
默认值：root html

指令：alias path；可存在位置：location

alias是一个目录别名的定义，root则是最上层目录的定义。使用root时，会到root + location 寻找资源；使用alias时，会到alias后定义的目录中找资源；

alias后面必须要用“/”结束，否则会找不到文件的。而root则可有可无

location /images {
     root /data/w3;
}

访问：http://localhost:9090/images/是访问/data/w3/images/index.html文件

location /images/ {
   alias /data/w3/images/;
}

访问：http://localhost:9090/images/是访问/data/w3/index.html文件

记录nginx不同访问路径和代理的配置，注意有加斜杠和不加的区别

以下展示不同情况下的配置：location路径、root路径、alias路径、proxy_pass代理路径。
通过这几个配置路径地址对比，建议location后面都带上斜杠。

# 进程数量
worker_processes 1;

events {
  # 最大连接数量
  worker_connections 1024;
}

http {
  include mime.types;
  default_type application/octet-stream;
  sendfile on;
  keepalive_timeout 65;

  # 演示如何强制http跳转https
  server {
    listen 80;
    server_name test.com;

    # http强制跳转到https
    rewrite ^(.*)$ https://$server_name$1 permanent;
  }

  # 演示如何配置微信支付的校验文件
  server {
    listen 80;
    server_name localhost;

    # 默认根路径
    location / {
      root index.html;
    }
    # 微信支付校验文件，可以直接配置访问名称
    location ^~/MP_verify_2g3uEjrB5B2LIbNl.txt {
      alias /home/MP_verify_2g3uEjrB5B2LIbNl.txt;
    }
    # 微信支付校验文件，也可以通过正则配置
    location ~^/MP_verify_[a-zA-Z0-9]*\.(txt)$ {
      root /home/;
      rewrite ^/home/(.txt)$ /home/$1 last;
    }
  }

  # 演示root和alias两种配置静态资源的区别
  server {
    listen 80;
    server_name localhost;

    # 用root方式，location中的路径会拼加到root的地址后面
    # 请求路径为：http://localhost:8080/files/index.jpg    实际访问为：/home/files/index.jpg
    location ~^/files/ {
      root /home/;
      index index.html index.htm;
    }
    # 用alias方式，location中的路径不会拼加到alias的地址后面
    # 这请求路径为：http://localhost:8080/files/index.jpg    实际访问为：/home/index.jpg
    location ~^/files/ {
      alias /home/;
      index index.html index.htm;
    }
  }

  # 演示请求后台接口代理配置
  server {
    listen 8080;
    server_name localhost;

    #################### 第一种场景（代理地址不加斜杠） ####################
    # 请求路径为：http://127.0.0.1:8080/api/getUser   实际代理为：http://127.0.0.1:8000/api/getUser
    location ^~/api/ {
      proxy_pass http://127.0.0.1:8000;
      proxy_set_header Host $http_host; #后台可以获取到完整的ip+端口号
      proxy_set_header X-Real-IP $remote_addr; #后台可以获取到用户访问的真实ip地址
    }
    # 请求路径为：http://127.0.0.1:8080/api/getUser   实际指向为：http://127.0.0.1:8000/api/getUser
    location ^~/api {
      proxy_pass http://127.0.0.1:8000;
      proxy_set_header Host $http_host; #后台可以获取到完整的ip+端口号
      proxy_set_header X-Real-IP $remote_addr; #后台可以获取到用户访问的真实ip地址
    }

    #################### 第二种场景（代理地址+斜杠） ####################
    # 请求路径为：http://127.0.0.1:8080/api/getUser   实际代理为：http://127.0.0.1:8000/getUser
    location ^~/api/ {
      proxy_pass http://127.0.0.1:8000/;
      proxy_set_header Host $http_host; #后台可以获取到完整的ip+端口号
      proxy_set_header X-Real-IP $remote_addr; #后台可以获取到用户访问的真实ip地址
    }
    # 请求路径为：http://127.0.0.1:8080/api/getUser   实际代理为：http://127.0.0.1:8000//getUser
    location ^~/api {
      proxy_pass http://127.0.0.1:8000/;
      proxy_set_header Host $http_host; #后台可以获取到完整的ip+端口号
      proxy_set_header X-Real-IP $remote_addr; #后台可以获取到用户访问的真实ip地址
    }

    #################### 第三种场景（代理地址+后缀） ####################
    # 请求路径为：http://127.0.0.1:8080/api/getUser   实际代理为：http://127.0.0.1:8000/user/getUser
    location ^~/api {
      proxy_pass http://127.0.0.1:8000/user;
      proxy_set_header Host $http_host; #后台可以获取到完整的ip+端口号
      proxy_set_header X-Real-IP $remote_addr; #后台可以获取到用户访问的真实ip地址
    }
    # 请求路径为：http://127.0.0.1:8080/api/getUser   实际代理为：http://127.0.0.1:8000/usergetUser
    location ^~/api/ {
      proxy_pass http://127.0.0.1:8000/user;
      proxy_set_header Host $http_host; #后台可以获取到完整的ip+端口号
      proxy_set_header X-Real-IP $remote_addr; #后台可以获取到用户访问的真实ip地址
    }

    #################### 第四种场景（代理地址+后缀+斜杠） ####################
    # 请求路径为：http://127.0.0.1:8080/api/getUser   实际代理为：http://127.0.0.1:8000/user/getUser
    location ^~/api/ {
      proxy_pass http://127.0.0.1:8000/user/;
      proxy_set_header Host $http_host; #后台可以获取到完整的ip+端口号
      proxy_set_header X-Real-IP $remote_addr; #后台可以获取到用户访问的真实ip地址
    }
    # 请求路径为：http://127.0.0.1:8080/api/getUser   实际代理为：http://127.0.0.1:8000/user//getUser
    location ^~/api {
      proxy_pass http://127.0.0.1:8000/user/;
      proxy_set_header Host $http_host; #后台可以获取到完整的ip+端口号
      proxy_set_header X-Real-IP $remote_addr; #后台可以获取到用户访问的真实ip地址
    }
  }

  # 演示前端项目如何部署nginx
  server {
    listen 8090;
    server_name localhost;

	# 默认访问
    # 部署路径：/home/web/my_demo
    # 访问路径为：http://localhost:8090/
    location / {
      try_files $uri $uri/ /index.html;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header Host $http_host;
      root /home/web/my_demo/;
      index index.html index.htm;
    }

	# 带前缀的访问
    # 部署路径：/home/web/my_demo
    # 访问路径为：http://localhost:8090/my_demo/
    # 如果location路径最后没有配置斜杠，则浏览器输入访问地址后，路径最后会自动拼一个斜杠
    location ^~/my_demo/ {
      try_files $uri $uri/ /my_demo/index.html;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header Host $http_host;
      root /home/web/;
      index index.html index.htm;
    }
  }
}