共计 4926 个字符，预计需要花费 13 分钟才能阅读完成。
概述
location 有 ” 定位 ” 的意思, 根据 Uri 来进行不同的定位.
在虚拟主机的配置中, 是必不可少的,location 可以把网站的不同部分, 定位到不同的处理方式上. 伪静态, 反向代理, 负载均衡等等都离不开 location.
语法
location [=|~|~*|^~] patt {}
中括号可以不写任何参数, 此时称为一般匹配, 也可以写参数. 因此, 大类型可以分为 3 种：
location = patt {} [精准匹配]
location patt{} [一般匹配]
location ~ patt{} [正则匹配]
匹配说明
精准匹配 =
完全匹配指定的 pattern，且这里的 pattern 被限制成简单的字符串，也就是说这里不能使用正则表达式.
server {
server_name website.com;
location = /abcd {[…]
}
}
http://website.com/abcd # 正好完全匹配
http://website.com/ABCD # 如果运行 Nginx server 的系统本身对大小写不敏感，比如 Windows，那么也匹配
http://website.com/abcd?param1 # 忽略查询串参数（query string arguments）, 也同样匹配
http://website.com/abcd/ # 不匹配，因为末尾存在反斜杠（trailing slash），Nginx 不认为这种情况是完全匹配
http://website.com/abcde # 不匹配，因为不是完全匹配
一般匹配 (None)
可以理解为 左前缀匹配(like pattern%), 这种情况下，匹配那些以指定的 patern 开头的 URI，注意这里的 URI 只能是普通字符串，不能使用正则表达式.
server {
server_name website.com;
location /abcd {[…]
}
}
http://website.com/abcd # 正好完全匹配
http://website.com/ABCD # 如果运行 Nginx server 的系统本身对大小写不敏感，比如 Windows，那么也匹配
http://website.com/abcd?param1 # 忽略查询串参数（query string arguments），这里就是 /abcd 后面的 ?param1
http://website.com/abcd/ # 末尾存在反斜杠（trailing slash）也属于匹配范围内
http://website.com/abcde # 仍然匹配，因为 URI 是以 pattern 开头的
正则匹配 ~
对大小写敏感 ( 在 window 上无效)，且 pattern 须是正则表达式
server {
server_name website.com;
location ~ ^/abcd$ {[…]
}
}
http://website.com/abcd # 完全匹配
http://website.com/ABCD # 不匹配，~ 对大小写是敏感的
http://website.com/abcd?param1 # 忽略查询串参数（query string arguments），这里就是 /abcd 后面的 ?param1
http://website.com/abcd/ # 不匹配，因为末尾存在反斜杠（trailing slash），并不匹配正则表达式 ^/abcd$
http://website.com/abcde # 不匹配正则表达式 ^/abcd$
正则匹配 ~*
不区分大小写，pattern 须是正则表达式
server {
server_name website.com;
location ~* ^/abcd$ {[…]
}
}
http://website.com/abcd # 完全匹配
http://website.com/ABCD # 匹配，这就是它不区分大小写的特性
http://website.com/abcd?param1 # 忽略查询串参数（query string arguments），这里就是 /abcd 后面的 ?param1
http://website.com/abcd/ # 不匹配，因为末尾存在反斜杠（trailing slash），并不匹配正则表达式 ^/abcd$
http://website.com/abcde # 不匹配正则表达式 ^/abcd$
正则匹配 ^~
匹配情况类似 一般匹配，以指定匹配模式开头的 URI 被匹配
!~ 和!~*
分别为区分大小写不匹配及不区分大小写不匹配的正则
通用匹配 /
任何请求都会匹配到.
特殊匹配 @
用于定义一个 Location 块，且该块不能被外部 Client 所访问，只能被 Nginx 内部配置指令所访问，比如 try_files or error_page
匹配优先级
http://www.test.com/ 从域名后面 (uri:http 请求行的第二列) 开始匹配, 也就是 /, 匹配原则一般都是左前缀匹配,location / {} 能够匹配所有 HTTP 请求，因为任何 HTTP 请求都必然是以 ’/’ 开始的, 但是，正则 location 和其他任何比 ’/’ 更长的普通 location (location / {} 是普通 location 里面最短的，因此其他任何普通 location 都会比它更长，当然 location = / {} 和 location ^~ / {} 是一样长的）会优先匹, 由此可见匹配的优先级可以总结为:
越详细就越优先
是不是有点像 css 的选择器?
Example1
# 首先看有没有精准匹配, 如果有, 则停止匹配过程.
location = patt {config A}
location / {
root /usr/local/nginx/html;
index index.html index.htm;
}如果访问 http://test.com/
定位流程是
1: 精准匹配中 ”/” , 得到 index 页为 index.htm
2: 再次访问 /index.htm , 此次内部转跳 uri 已经是 ”/index.htm”, 根目录为 /usr/local/nginx/html
3: 最终结果, 访问了 /usr/local/nginx/html/index.htm
Example2
location / {
root /usr/local/nginx/html;
index index.html index.htm;
}
location /foo {
root /var/www/html;
index index.html;
}我们访问 http://test.com/foo
对于 uri “/foo”, 两个 location 的 patt, 都能匹配他们
即 ‘/’ 能从左前缀匹配 ‘/foo’, ‘/foo’ 也能左前缀匹配 ’/foo’,
此时, 真正访问 /var/www/html/index.html
原因:‘/foo’ 匹配的更长, 因此使用之;
Example3
location ~ image {
root /var/www/image;
index index.html;
}如果我们访问 http://test.com/image/logo.png
此时, “/” 与 ”/image/logo.png” 匹配
同时,”image” 正则 与 ”image/logo.png” 也能匹配, 谁发挥作用?
正则表达式的成果将会使用. 因为此时的正则表达式更详细
图片真正会访问 /var/www/image/logo.png
再次总结优先级序如下：
1. =
2. (None) 前提是 pattern 完全匹配 URI 的情况（不是只匹配 URI 的头部, 这点很重要）3. ^~
4. ~ 或 ~*
5. (None) pattern 匹配 URI 的头部
貌似与 location 的书写顺序无关? 但实际上还是有关系的
# 配置一
server {
listen 9090;
server_name localhost;
location ~ \.html$ {allow all;}
location ~ ^/prefix/.*\.html$ {deny all;}
}
# 配置二
server {
listen 9090;
server_name localhost;
location ~ ^/prefix/.*\.html$ {deny all;}
location ~ \.html$ {allow all;}
}
| URI 请求 | 配置一 | 配置二 |
|---|---|---|
| curl http://localhost:9090/regextest.html | 404 Not Found | 404 Not Found |
| curl http://localhost:9090/prefix/regextest.html | 404 Not Found | 403 Forbidden |
Location ~ ^/prefix/.*.html$ {deny all;} 表示正则 location 对于以 /prefix/ 开头，.html 结尾的所有 URI 请求，都拒绝访问；location ~.html${allow all;} 表示正则 location 对于以 .html 结尾的 URI 请求，都允许访问. 实际上，prefix 的是 ~.html$ 的子集.
在 ” 配置一 “ 下，两个请求都匹配上 location ~.html$ {allow all;}，并且停止后面的搜索，于是都允许访问，404 Not Found；在 ” 配置二 “ 下，/regextest.html 无法匹配 prefix，于是继续搜索 ~.html$，允许访问，于是 404 Not Found；然而 /prefix/regextest.html 匹配到 prefix，于是 deny all，403 Forbidden .
优先级最终总结
1. =
2. (None) 前提是 pattern 完全匹配 URI 的情况（不是只匹配 URI 的头部, 这点很重要）3. ^~
4. ~ 或 ~*
5. (None) pattern 匹配 URI 的头部
越详细就越优先, 但是同优先级的情况下, 按书写顺序谁先出现就以谁为准(就近原则)
依然和 css 选择器的优先级很像 …
root&alias 文件路径配置
http://www.ttlsa.com/nginx/ng…
推荐必须的 location
# 直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理，官网如是说.
#这里是直接转发给后端应用服务器了，也可以是一个静态首页
# 第一个必选规则
location = / {proxy_pass http://127.0.0.1:88;}
# 第二个必选规则是处理静态文件请求，这是 nginx 作为 http 服务器的强项
# 有两种配置模式，目录匹配或后缀匹配, 任选其一或搭配使用
location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
{expires 30d;}
location ~ .*\.(js|css)?$
{expires 12h;}
location ~ /\.
{deny all; # 其他的任意后缀都不让其访问;}
#第三个规则就是通用规则，用来转发动态请求到后端应用服务器
location /
{try_files $uri @apache; #try_files 将尝试你列出的文件并设置内部文件指向}
location @apache
{
internal; # internal 指令指定某个 location 只能被“内部的”请求调用，外部的调用请求会返回”Not found”proxy_pass http://127.0.0.1:88;
proxy_connect_timeout 300s;
proxy_send_timeout 900;
proxy_read_timeout 900;
proxy_buffer_size 32k;
proxy_buffers 4 32k;
proxy_busy_buffers_size 64k;
proxy_redirect off;
proxy_hide_header Vary;
proxy_set_header Accept-Encoding '';
proxy_set_header Host $host;
proxy_set_header Referer $http_referer;
proxy_set_header Cookie $http_cookie;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}