讲师中心 微信公众号
AI工具推荐 视频效率加速

如何通过 location 块 的 try_files 实现本地缓存优先于后端转发

夜静同学_9674

夜静同学_9674

发布时间:2026-05-25 19:03:21

|

369人浏览过

|

来源于php中文网

原创

可通过try_files指令实现缓存优先:先检查本地缓存文件(如/var/cache/nginx$uri),命中则返回,未命中再proxy_pass回源;需手动约定缓存路径格式、确保文件含完整HTTP响应结构,并配置命名location兜底。

如何通过 location 块 的 try_files 实现本地缓存优先于后端转发

可以通过 location 块中的 try_files 指令,让 Nginx 先尝试读取本地缓存文件,命中则直接返回,未命中再转发给后端服务。关键在于把缓存路径作为第一个选项,且确保缓存文件可被 Nginx 读取、命名与请求 URI 可映射。

缓存路径需与请求 URI 映射一致

Nginx 不会自动将请求生成缓存文件名,需配合 proxy_cache_path 的 levels 和 keys_zone,并用 proxy_cache_key 控制缓存键;但 try_files 本身只做文件系统路径检查,所以必须手动约定缓存落盘路径格式(例如按 URI 的 hash 或 base64 编码存储),或使用固定结构(如 /var/cache/nginx/$uri)。

  • 推荐方式:用 map 指令预处理 $uri 为安全的文件系统路径(过滤 ..、/ 等)
  • 示例:将 /api/user/123 转为 /var/cache/nginx/api_user_123,避免目录穿越
  • 缓存文件需包含完整响应体 + 合适的响应头(如 Content-Type),可用 Lua 或外部程序生成,Nginx 原生不写缓存到任意路径

try_files 顺序决定优先级

try_files 按从左到右顺序检查文件是否存在,只要某个选项存在就停止并返回,后续不执行。因此要把本地缓存路径放第一位,后端代理放最后(用 @fallback 或 =404 触发)。

  • 正确写法:try_files /var/cache/nginx$uri $uri @proxy;
  • 注意:$uri 是解码后的路径,若缓存按原始 URI 存储,需用 $request_uri(但含 query string,一般不用于文件名)
  • 若缓存是带扩展名的(如 .cache),要补全:try_files /var/cache/nginx$uri.cache /var/cache/nginx$uri @proxy;

缓存文件需具备合法 HTTP 响应结构

try_files 返回的是静态文件,Nginx 不解析其内容,所以缓存文件必须是“已组装好”的完整 HTTP 响应(含状态行、头、空行、正文),否则浏览器无法识别。通常不建议手动生成这种格式。

  • 更实用的做法:用 proxy_cache 配合 proxy_cache_bypass 和 proxy_no_cache 实现「缓存优先」逻辑,而非依赖 try_files
  • 若坚持用 try_files,建议仅用于简单静态资源(如 JSON、HTML 片段),用脚本预生成,并设置好 add_header 补充必要头(如 Content-Type: application/json)
  • 注意权限:Nginx worker 进程用户(如 www-data)需对缓存目录有读取权限

配合 proxy_pass 实现回源兜底

当 try_files 所有选项都未命中时,用命名 location(如 @proxy)承接,内部调用 proxy_pass 转发,并在成功响应后可触发异步缓存写入(需外部工具或 OpenResty)。

  • 示例:location @proxy { proxy_pass http://backend; }
  • 注意:不能在同一个 location 中混用 try_files 和 proxy_pass(除非用 @named 分离)
  • 若需回源后自动落盘,标准 Nginx 不支持,需借助 nginx-upload-module、Lua ngx.location.capture 或外部 cache updater

热门AI工具

更多
火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2383

2023.08.11

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6210

2024.03.19

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

5566

2024.03.19

C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

3029

2023.06.20

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2268

2023.07.25

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

1200

2023.08.02

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1158

2023.08.09

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

1336

2023.09.05

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

20

2026.10.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
LLVM官方文档
LLVM官方文档

共0课时 | 0人学习

Memcheck使用手册
Memcheck使用手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn