快捷導(dǎo)航

Nginx try_files 指令常見用法示例

更新時(shí)間：2026年05月11日 09:35:36 作者：學(xué)亮編程手記

try_files是Nginx用于按順序檢查文件是否存在并返回第一個(gè)找到的文件,本文給大家介紹Nginx try_files 指令常見用法示例,感興趣的朋友跟隨小編一起看看吧

try_files 是 Nginx 中一個(gè)非常實(shí)用的指令，用于按順序檢查文件是否存在，并返回第一個(gè)找到的文件。如果所有文件都不存在，則執(zhí)行最后一個(gè)參數(shù)指定的回退操作（通常是返回錯(cuò)誤碼或轉(zhuǎn)發(fā)請(qǐng)求）。

基本語法

try_files file1 file2 ... =code|uri|@named_location;

常見用法示例

1.SPA（單頁應(yīng)用）常用配置

location / {
    try_files $uri $uri/ /index.html;
}

先嘗試訪問請(qǐng)求的 URI 對(duì)應(yīng)的文件
再嘗試訪問 URI 對(duì)應(yīng)的目錄
都不存在則返回 /index.html

2.帶回退代理

location / {
    try_files $uri $uri/ @backend;
}
location @backend {
    proxy_pass http://backend_server;
}

靜態(tài)文件不存在時(shí)轉(zhuǎn)發(fā)到后端應(yīng)用

3.檢查多個(gè)路徑

location /images/ {
    try_files /cache$uri $uri =404;
}

先檢查緩存目錄
再檢查原始路徑
都不存在返回 404

參數(shù)詳解

$uri

當(dāng)前請(qǐng)求的 URI（不包含查詢參數(shù)）

$uri/

表示目錄，會(huì)嘗試尋找目錄下的索引文件（需配合 index 指令）

回退類型

靜態(tài)文件/路徑

try_files $uri /default.html;

命名 location（@ 開頭）

try_files $uri @fallback;
location @fallback {
    # 處理邏輯
}

錯(cuò)誤碼

try_files $uri =404;
try_files $uri =403;

代理轉(zhuǎn)發(fā)

try_files $uri @proxy;
location @proxy {
    proxy_pass http://backend;
}

實(shí)際應(yīng)用場景

場景1：PHP 應(yīng)用

location ~ \.php$ {
    try_files $uri =404;
    fastcgi_pass unix:/var/run/php-fpm.sock;
}

防止直接訪問不存在的 PHP 文件

場景2：多級(jí)緩存

location /assets/ {
    try_files /cdn-cache/$uri 
              /local-cache/$uri 
              $uri 
              @generate_asset;
}

場景3：維護(hù)模式

location / {
    try_files /maintenance.html $uri $uri/ @app;
}

優(yōu)先顯示維護(hù)頁面

注意事項(xiàng)

順序重要：Nginx 按順序檢查，找到即停
性能影響：每個(gè)文件檢查都會(huì)產(chǎn)生磁盤 I/O
相對(duì)路徑：相對(duì)于 root 或 alias 指令
最后參數(shù)：必須指定回退操作
內(nèi)部重定向：try_files 會(huì)內(nèi)部重定向，可能改變 $uri 值

與if的對(duì)比

? 不推薦（低效）：

if (-f $request_filename) {
    # 處理靜態(tài)文件
}

? 推薦（高效）：

try_files $uri @dynamic;

調(diào)試技巧

添加調(diào)試日志：

location / {
    try_files $uri $uri/ @backend;
    error_log /var/log/nginx/try_files.log debug;
}

try_files 的核心思想是 “按優(yōu)先級(jí)嘗試，優(yōu)雅降級(jí)”，合理使用可以大大簡化配置邏輯并提高性能。

到此這篇關(guān)于Nginx try_files 指令常見用法示例的文章就介紹到這了,更多相關(guān)Nginx try_files 指令內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线