語法規則
location [=|~|~*|^~] /uri/ { … }
前綴匹配時,Nginx 不對 url 做編碼,因此請求為 /static/20%/aa ,可以被規則 ^~ /static/ /aa 匹配到(注意是空格)
匹配成功后,url的 域名+port 替換為root指定的目錄,
以請求https://www.cnblogs.com:8080/benwu/articles/2283622.html為例,
1: location配置如下
location /benwu { root /home/files/; }
匹配到/benwu,url中的域名+port替換為root指定的目錄,即將請求地址中的https://www.cnblogs.com:8080被替換為了/home/files/,
所以在服務器端實際訪問的路徑是:/home/files/benwu/articles/2283622.html
2: location配置如下
location /benwu/articles { root /home/files/; }
匹配到 /benwu/articles,url的域名+port替換為root指定的目錄,即url中的https://www.cnblogs.com:8080被替換為了/home/files,
所以實際訪問的路徑仍然是:/home/files/benwu/articles/2283622.html。
root在替換時不會替換匹配到的路徑。
多個 location 配置的情況下匹配順序為
首先精確匹配 = ,如果匹配成功,則停止其他匹配
其次前綴匹配 ^~
其次是按文件中順序的正則匹配
然后匹配不帶任何修飾的前綴匹配。
最后是交給 / 通用匹配
當有匹配成功時候,停止匹配,按當前匹配規則處理請
location匹配順序
"="前綴指令匹配,如果匹配成功,則停止其他匹配
普通字符串指令匹配,順序是從長到短,匹配成功的location如果使用^~,則停止其他匹配(正則匹配)
正則表達式指令匹配,按照配置文件里的順序,成功就停止其他匹配
如果第三步中有匹配成功,則使用該結果,否則使用第二步結果
最后是交給 / 通用匹配
注意點
匹配的順序是先匹配普通字符串,然后再匹配正則表達式。另外普通字符串匹配順序是根據配置中字符長度從長到短,也就是說使用普通字符串配置的location順序是無關緊要的,反正最后nginx會根據配置的長短來進行匹配,但是需要注意的是正則表達式按照配置文件里的順序測試。找到第一個比配的正則表達式將停止搜索。
一般情況下,匹配成功了普通字符串location后還會進行正則表達式location匹配。有兩種方法改變這種行為,其一就是使用“=”前綴,這時執行的是嚴格匹配,並且匹配成功后立即停止其他匹配,同時處理這個請求;另外一種就是使用“^~”前綴,如果把這個前綴用於一個常規字符串那么告訴nginx 如果路徑匹配那么不測試正則表達式。
匹配模式及順序
= #用於標准uri前,需要請求字串與uri完全匹配,如果匹配成功就停止向下匹配並立即處理請求。
~ #區分大小寫
~* #不區分大寫
!~ #區分大小寫不匹配
!~* #不區分大小寫不匹配
^ #匹配正則開頭
$ #匹配正則結尾
\ #轉義字符。可以轉. * ?等
* #代表任意長度的任意字符
location = /uri #開頭表示精確匹配,只有完全匹配上才能生效。
location ^~ /uri #開頭對URL路徑進行前綴匹配,並且在正則之前。
location ~ pattern #開頭表示區分大小寫的正則匹配。
location ~* pattern #開頭表示不區分大小寫的正則匹配。
location /uri #不帶任何修飾符,也表示前綴匹配,但是在正則匹配之后。
location / #通用匹配,任何未匹配到其它location的請求都會匹配到,相當於switch中的default。
#不區分大小寫匹配任何以gif、jpg、jpeg結尾的請求
location ~* .(gif|jpg|jpeg)$ {
}
#區分大小寫匹配以.txt結尾的請求,並設置此location的路徑是/usr/local/nginx/html/。也就是以.txt結尾的請求將訪問/usr/local/nginx/html/ 路徑下的txt文件
location ~ ^.+\.txt$ {
root /usr/local/nginx/html/;
}
# ^~ 以 /admin/ 開頭的請求,都會匹配上
location ^~ /admin/ {
root /xvdb/mobai/
}
此時 /xvdb/mobai/目錄中必須要有 admin 文件夾
#匹配成功: http://www.cnblogs.com/admin/index.jsp
#匹配成功: http://www.cnblogs.com/admin/login.jsp
#忽略大小寫,包含/Images/
location ~* /Images/ {
}
#匹配成功: http://www.cnblogs.com/test/Images/
#匹配成功: http://www.cnblogs.com/images/
#不加任何規則則時,默認是大小寫敏感,前綴匹配,相當於加了“^”與“~”
location /index/ {
}
#匹配成功: http://www.cnblogs.com/index
#匹配成功: http://www.cnblogs.com/index/index.html
#匹配失敗: http://www.cnblogs.com/test/index
#匹配失敗: http://www.cnblogs.com/Index
#精確匹配, 只匹配http://www.cnblogs.com
location = / {
}
#匹配成功: http://www.cnblogs.com
#匹配失敗: http://www.cnblogs.com/index
# 匹配到所有url
location / {
}
例子,有如下匹配規則:
location = / { echo "規則A"; } location = /login { echo "規則B"; } location^~ /static/ { echo "規則C"; } location^~ /static/files { echo "規則X"; } location ~ \.(gif|jpg|png|js|css)$ { echo "規則D"; } location ~* \.png$ { echo "規則E"; } location /img { echo "規則Y"; } location / { echo "規則F"; }
那么產生的效果如下:
訪問根目錄 / ,比如 http://localhost/ 將匹配 規則A
訪問 http://localhost/login 將匹配 規則B , http://localhost/register 則匹配 規則F
訪問 http://localhost/static/a.html 將匹配 規則C
訪問 http://localhost/static/files/a.exe 將匹配 規則X ,雖然 規則C 也能匹配到,但因為最大匹配原則,最終選中了 規則X 。你可以測試下,去掉規則 X ,則當前 URL 會匹配上 規則C 。
訪問 http://localhost/a.gif , http://localhost/b.jpg 將匹配 規則D 和 規則 E ,但是 規則 D 順序優先, 規則 E 不起作用,而 http://localhost/static/c.png 則優先匹配到 規則 C
訪問 http://localhost/a.PNG 則匹配 規則 E ,而不會匹配 規則 D ,因為 規則 E 不區分大小寫。
訪問 http://localhost/img/a.gif 會匹配上 規則D ,雖然 規則Y 也可以匹配上,但是因為正則匹配優先,而忽略了 規則Y 。
訪問 http://localhost/img/a.tiff 會匹配上 規則Y 。
訪問 http://localhost/category/id/1111 則最終匹配到規則 F ,因為以上規則都不匹配,這個時候應該是 Nginx 轉發請求給后端應用服務器,比如 FastCGI(php),tomcat(jsp),Nginx 作為反向代理服務器存在。
詳解nginx的root與alias
以請求https://www.cnblogs.com:8080/benwu/articles/2283622.html為例,
測試1: location配置如下
location /benwu { root /home/files/; }
匹配到/benwu,將url中的 前綴(ip/域名)+port+匹配到的路徑 替換為alias指定的目錄,
即url中的https://www.cnblogs.com:8080/benwu 被替換為了/home/files/,所以實際訪問的路徑為/home/files/articles/2283622.html
測試2: location配置如下
location /benwu/articles { root /home/files/; }
匹配到/home/files,將url中的 前綴(ip/域名)+port+匹配到的路徑 替換為alias指定的目錄,
即url中的https://www.cnblogs.com:8080/benwu 被替換為了/home/files/,所以實際訪問的路徑為/home/files/2283622.html
alias在替換時會替換匹配到的路徑。
alias其余特性,最左匹配、index、location解析url工作流程、末尾’/'與root一致。
所以實際使用中,筆者覺得至少有三個匹配規則定義,如下:
# 直接匹配網站根,通過域名訪問網站首頁比較頻繁,使用這個會加速處理,官網如是說。
# 這里是直接轉發給后端應用服務器了,也可以是一個靜態首頁
# 第一個必選規則
location = / { proxy_pass http://tomcat:8080/index
}
# 第二個必選規則是處理靜態文件請求,這是 nginx 作為 http 服務器的強項
# 有兩種配置模式,目錄匹配或后綴匹配,任選其一或搭配使用
location ^~ /static/ { root /webroot/static/;
} location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ { root /webroot/res/;
}
# 第三個規則就是通用規則,用來轉發動態請求到后端應用服務器
# 非靜態文件請求就默認是動態請求,自己根據實際把握
# 畢竟目前的一些框架的流行,帶.php、.jsp后綴的情況很少了
location / { proxy_pass http://tomcat:8080/
}
rewrite 語法
last – 基本上都用這個 Flag
break – 中止 Rewirte,不再繼續匹配
redirect – 返回臨時重定向的 HTTP 狀態 302
permanent – 返回永久重定向的 HTTP 狀態 301
1、下面是可以用來判斷的表達式:
-f 和 !-f 用來判斷是否存在文件
-d 和 !-d 用來判斷是否存在目錄
-e 和 !-e 用來判斷是否存在文件或目錄
-x 和 !-x 用來判斷文件是否可執行
2、下面是可以用作判斷的全局變量
例:
http://localhost:88/test1/test2/test.php?k=v
$host:localhost $server_port:88 $request_uri:/test1/test2/test.php?k=v
$document_uri:/test1/test2/test.php
$document_root:D:\nginx/html
$request_filename:D:\nginx/html/test1/test2/test.php
redirect 語法
server { listen 80; server_name start.igrow.cn; index index.html index.php; root html; if ($http_host !~ "^star\.igrow\.cn$") { rewrite ^(.*) http://star.igrow.cn$1 redirect;
} }
防盜鏈
location ~* \.(gif|jpg|swf)$ { valid_referers none blocked start.igrow.cn sta.igrow.cn; if ($invalid_referer) { rewrite ^/ http://$host/logo.png;
} }
根據文件類型設置過期時間
location ~* \.(js|css|jpg|jpeg|gif|png|swf)$ { if (-f $request_filename) { expires 1h; break; } }
參考文檔:http://www.zzvips.com/article/33760.html