Nginx location转发规则详解

Nginx

location

nginx中,location用于配置接口映射的规则

语法

Syntax:    location [ = | ~ | ~* | ^~ ] uri { ... }
location @name { ... }
Default:    —
Context:    server, location

官方文档

  • Sets configuration depending on a request URI.

    • 为每个接收到的uri(注意这里是uri(Uniform Resource Identifier),不是url(Uniform Resoure Locator))的转发进行相关配置
    • 同一个uri,跟在不同前缀"=","~","~*","^~"后面,表达是不同的指令
    • 需要注意,查询字符串不在uri范围内,例如"/some.html?some_param=some_value",uri只包括"/some.html"这一部分
  • The matching is performed against a normalized URI, after decoding the text encoded in the “%XX” form, resolving references to relative path components “.” and “..”, and possible compression of two or more adjacent slashes into a single slash.
  • A location can either be defined by a prefix string, or by a regular expression.
    一个转发规则可以是一个普通文本字符串literalStr(其匹配以literalStr开头的uri),也可以是一个正则表达式patternStr(其匹配任何Pattern.compile(patternStr).matcher(uri).find()返回结果为true的字符串)
  • Regular expressions are specified with the preceding “~*” modifier (for case-insensitive matching), or the “~” modifier (for case-sensitive matching).
    如果是一个正则表达式匹配,正则表达式必须以"~*"标识符或者是"~"标识符开头,其中"~*"标识符表示大小写敏感匹配,"~"表示非大小写敏感匹配.
  • To find location matching a given request, nginx first checks locations defined using the prefix strings (prefix locations).
    进行模式匹配的时候,nginx首先会利用以普通文本为前缀格式的规则进行匹配
  • Among them, the location with the longest matching prefix is selected and remembered.
    在普通文本前缀规则与普通文本前缀规则之间,最长的前缀也就是说最精确的匹配会被选中,并记录下来(注意这里是记录下来,并不是直接使用)
  • Then regular expressions are checked, in the order of their appearance in the configuration file.
    进行完所有普通文本为前缀的规则的匹配之后,nginx会继续匹配正则表达式类型的规则,匹配顺序按照这些正则表达式规则被定义的顺序来.
  • The search of regular expressions terminates on the first match, and the corresponding configuration is used.
    当匹配到第一个定义的正则表达式规则之后,匹配就会终止,对应的转发规则就会被使用
  • If no match with a regular expression is found then the configuration of the prefix location remembered earlier is used.
    如果所有的正则表达式类型的规则中没有匹配的,那么之前记录下来的普通字符串前缀类型的规则将会被是使用
  • If the longest matching prefix location has the “^~” modifier then regular expressions are not checked.
    如果某个普通文本前缀规则以"^~"标识符开头,那么发现匹配后,正则表达式将不会被检测
  • Also, using the “=” modifier it is possible to define an exact match of URI and location. If an exact match is found, the search terminates.
    此外,利用"="标识符可以定义一个精确匹配,如果任意一个精确匹配规则被匹配,那么匹配流程将会终止,对应的规则将会被使用
  • Let’s illustrate the above by an example

      location = / {
          [ configuration A ]
      }
     
      location / {
          [ configuration B ]
      }
     
      location /documents/ {
          [ configuration C ]
      }
     
      location ^~ /images/ {
          [ configuration D ]
      }
     
      location ~* \.(gif|jpg|jpeg)$ {
          [ configuration E ]
      }

    The “/” request will match configuration A, the “/index.html” request will match configuration B, the “/documents/document.html” request will match configuration C, the “/images/1.gif” request will match configuration D, and the “/documents/1.jpg” request will match configuration E.
    一个小例子,请求uri为"/"的请求会匹配配置A,因为这是一个精确匹配;请求uri为"/index.html"的请求会匹配配置B,因为整个规则集合中没有相应的规则,所以默认的配置被使用了;请求uri为“/documents/document.html”的请求会匹配配置C,因为这是唯一一个匹配的普通字符串前缀匹配规则,而且后面没有匹配的正则匹配,正如前面提到的(If no match with a regular expression is found then the configuration of the prefix location remembered earlier is used.);请求Uri为“/images/1.gif”的请求将会匹配配置D,这是一个正则表达式类型的规则匹配,当然了,你可能会说,配置E正则表达式同样可以匹配这个uri,但是别忘了我们之前提到的(The search of regular expressions terminates on the first match),真则表达式会匹配一个match的规则;最后看一下"/documents/1.jpg"这个uri的匹配情况,可能整个流程就更加明了了."/documents/1.jpg"这个uri首先进行普通字符串前缀匹配的时候会匹配配置C,这是就如之前所说(the location with the longest matching prefix is selected and remembered),最长也就是最精确匹配会被匹配并记录,然后会继续进行正则表达式相关匹配,然后匹配到了配置E,然后配置E被使用.

  • 正则 location 匹配让步普通location 的严格精确匹配结果;但覆盖普通 location 的最大前缀匹配结果

nginx配置详解

#运行用户
user nobody;
#启动进程,通常设置成和cpu的数量相等
worker_processes  1;
 
#全局错误日志及PID文件
#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;
 
#pid        logs/nginx.pid;
 
#工作模式及连接数上限
events {
    #epoll是多路复用IO(I/O Multiplexing)中的一种方式,
    #仅用于linux2.6以上内核,可以大大提高nginx的性能
    use   epoll;
 
    #单个后台worker process进程的最大并发链接数    
    worker_connections  1024;
 
    # 并发总数是 worker_processes 和 worker_connections 的乘积
    # 即 max_clients = worker_processes * worker_connections
    # 在设置了反向代理的情况下,max_clients = worker_processes * worker_connections / 4  为什么
    # 为什么上面反向代理要除以4,应该说是一个经验值
    # 根据以上条件,正常情况下的Nginx Server可以应付的最大连接数为:4 * 8000 = 32000
    # worker_connections 值的设置跟物理内存大小有关
    # 因为并发受IO约束,max_clients的值须小于系统可以打开的最大文件数
    # 而系统可以打开的最大文件数和内存大小成正比,一般1GB内存的机器上可以打开的文件数大约是10万左右
    # 我们来看看360M内存的VPS可以打开的文件句柄数是多少:
    # $ cat /proc/sys/fs/file-max
    # 输出 34336
    # 32000 < 34336,即并发连接总数小于系统可以打开的文件句柄总数,这样就在操作系统可以承受的范围之内
    # 所以,worker_connections 的值需根据 worker_processes 进程数目和系统可以打开的最大文件总数进行适当地进行设置
    # 使得并发总数小于操作系统可以打开的最大文件数目
    # 其实质也就是根据主机的物理CPU和内存进行配置
    # 当然,理论上的并发总数可能会和实际有所偏差,因为主机还有其他的工作进程需要消耗系统资源。
    # ulimit -SHn 65535
 
}
 
 
http {
    #设定mime类型,类型由mime.type文件定义
    include    mime.types;
    default_type  application/octet-stream;
    #设定日志格式
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';
 
    access_log  logs/access.log  main;
 
    #sendfile 指令指定 nginx 是否调用 sendfile 函数(zero copy 方式)来输出文件,
    #对于普通应用,必须设为 on,
    #如果用来进行下载等应用磁盘IO重负载应用,可设置为 off,
    #以平衡磁盘与网络I/O处理速度,降低系统的uptime.
    sendfile     on;
    #tcp_nopush     on;
 
    #连接超时时间
    #keepalive_timeout  0;
    keepalive_timeout  65;
    tcp_nodelay     on;
 
    #开启gzip压缩
    gzip  on;
    gzip_disable "MSIE [1-6].";
 
    #设定请求缓冲
    client_header_buffer_size    128k;
    large_client_header_buffers  4 128k;
 
 
    #设定虚拟主机配置
    server {
        #侦听80端口
        listen    80;
        #定义使用 www.nginx.cn访问
        server_name  www.nginx.cn;
 
        #定义服务器的默认网站根目录位置
        root html;
 
        #设定本虚拟主机的访问日志
        access_log  logs/nginx.access.log  main;
 
        #默认请求
        location / {
 
            #定义首页索引文件的名称
            index index.php index.html index.htm;   
 
        }
 
        # 定义错误提示页面
        error_page   500 502 503 504 /50x.html;
        location = /50x.html {
        }
 
        #静态文件,nginx自己处理
        location ~ ^/(images|javascript|js|css|flash|media|static)/ {
 
            #过期30天,静态文件不怎么更新,过期可以设大一点,
            #如果频繁更新,则可以设置得小一点。
            expires 30d;
        }
 
        #PHP 脚本请求全部转发到 FastCGI处理. 使用FastCGI默认配置.
        location ~ .php$ {
            fastcgi_pass 127.0.0.1:9000;
            fastcgi_index index.php;
            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
            include fastcgi_params;
        }
 
        #禁止访问 .htxxx 文件
            location ~ /.ht {
            deny all;
        }
 
    }
}
1+

喜欢该文章的用户:

  • avatar

发表评论

电子邮件地址不会被公开。

您可以使用这些HTML标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>