本文共 1303 字，大约阅读时间需要 4 分钟。

   
	
    
location
	
    
语法: location [=|~|~*|^~] /uri/ { … }
	
    
默认: 否
	
    
上下文: server
	
    
这个指令根据URL的不同接受不同的结构。你可以配置使用常规字符串和正则表达式。如果使用正则表达式，你必须使用 ~* 前缀选择不区分大小写的匹配或者 ~ 选择区分大小写的匹配。
	
    
确定哪个location指令匹配特定请求时，常规字符串将先测试。常规字符串匹配请求的开始部分且区分大小写，最明确的匹配将被优先使用。然后按配置文件顺序测试正则表达式。如果找到匹配的正则表达式，测试停止并使用该结果。否则，继续使用常规字符串结果。
	
    
有两种方法修改这个行为。第一种是使用 “=” 前缀，表示严格匹配。如果匹配，则停止搜索并处理请求。例如，使用 “location = /” 可以加速处理 root 请求。第二种方法是使用 ^~ 前缀，表示如果路径匹配则停止搜索，任何正则表达式将不会被测试。
	
    
需要注意的是，NGINX 不会对URL进行编码。因此，如果URL中包含空格（如’/images/%20/test’），你的location匹配应基于实际URL而非URL解码后的结果。
	
    
配置优先级顺序如下：
	
    
		
     
具有 “=” 前缀的指令，严格匹配查询。如果匹配，则停止搜索并处理请求。
		
     
常规字符串，按文件中的顺序排列，且长度较长的先测试。如果常规字符串使用 ^~ 前缀，则测试停止。
		
     
按文件中顺序排列的正则表达式测试。如果匹配，则处理请求。
		
     
如果没有匹配，则使用上一步结果。如果没有正则表达式匹配，则使用常规字符串结果。
	
    
	
    
示例：
	
    
		
     
location = / {# 只匹配 / 查询}
	
    
	
    
		
     
location / {# 匹配所有请求，但正则表达式和长字符串规则将优先处理}
	
    
	
    
		
     
location ^~ /images/ {# 匹配所有以 /images/ 开头的请求，停止搜索}
	
    
	
    
		
     
location ~* \.(gif|jpg|jpeg)$ {# 匹配所有 gif、jpg 或 jpeg 结尾的请求}
	
    
	
    
请求示例：
	
    
		
     
/ -> 匹配 location = /
		
     
/documents/document.html -> 匹配 location /
		
     
/images/1.gif -> 匹配 location ^~ /images/
		
     
/documents/1.jpg -> 匹配 location ~* \.(gif|jpg|jpeg)$
	
    
	
    
需要注意的是，不同的location配置可以任意顺序定义，但最终的匹配结果不会改变。因此，无需担心配置顺序对匹配结果的影响。