Nginx 中反向代理怎么配置缓存模块 ProxyCache 加速静态资源代理

落强姑娘_6645

落强姑娘_6645

2026-08-21

557人浏览

原创

nginx的proxy_cache模块不直接加速静态资源,而是缓存后端响应以减轻上游压力;真正静态加速靠root/alias+expires,proxy_cache适用于代理动态内容或带cache-control的静态资源缓存。

nginx 中反向代理怎么配置缓存模块 proxycache 加速静态资源代理

Nginx 的 proxy_cache 模块本身不直接“加速静态资源”,而是通过缓存后端服务器(如 Tomcat、PHP-FPM 或其他应用服务)返回的响应内容,减少重复请求对上游的压力,间接提升静态资源的响应速度。真正服务于静态资源加速的,通常是 location 配合 root/alias 和 expires 等指令;而 proxy_cache 更适用于代理动态内容或 API 响应的缓存。

但如果你确实需要通过反向代理方式(比如前端 Nginx 代理后端 Node.js 或 Java 应用),并希望它缓存那些被标记为可缓存的静态资源(如 /static/xxx.css、/api/v1/assets/*),那就得正确启用和配置 proxy_cache。以下是关键配置要点:

proxy_cache 缓存区域定义

必须在 http 块中预先定义缓存区,不能写在 server 或 location 内:

proxy_cache_path /var/cache/nginx/proxy_cache  
                 levels=1:2  
                 keys_zone=static_cache:10m  
                 max_size=1g  
                 inactive=60m  
                 use_temp_path=off;
  • /var/cache/nginx/proxy_cache:缓存文件物理路径,需确保 Nginx 进程有读写权限
  • levels=1:2:两级目录哈希结构,避免单目录文件过多
  • keys_zone=static_cache:10m:共享内存区名称和大小,用于存储缓存键与元数据
  • max_size=1g:磁盘缓存总上限,超出时按 inactive 时间清理最久未访问项
  • inactive=60m:缓存项若 60 分钟内无再访问,则自动失效(即使响应头声明了更长 Cache-Control)
  • use_temp_path=off:推荐关闭,避免临时文件写入影响性能

在 location 中启用缓存

例如代理所有 /static/ 请求到后端,并缓存成功响应:

aperture: the L402 aware reverse proxy
aperture: the L402 aware reverse proxy

安装并运行 Aperture(Lightning Labs 的 L402 闪电反向代理),用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载
location /static/ {
    proxy_pass http://backend_app;
    proxy_cache static_cache;
    proxy_cache_valid 200 302 10m;
    proxy_cache_valid 404 1m;
    proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
    proxy_cache_lock on;
    proxy_cache_lock_timeout 5s;
    add_header X-Cache-Status $upstream_cache_status;
}
  • proxy_cache_valid:按响应状态码设置缓存时间,比后端 Cache-Control 优先级低(Nginx 默认以 Cache-Control/Expires 为准,除非加 proxy_ignore_headers)
  • proxy_cache_use_stale:允许在后端异常时返回过期缓存,提升可用性
  • proxy_cache_lock:防止缓存未命中时多个并发请求同时穿透到后端(只让第一个建缓存,其余等待)
  • X-Cache-Status:方便调试,返回 HIT/MISS/BYPASS/EXPIRED 等状态

注意缓存键(cache key)默认行为

Nginx 默认使用 $scheme$proxy_host$request_uri 作为缓存键。如果后端依赖 Cookie、User-Agent 或特定 Header 区分内容,需显式定义:

proxy_cache_key "$scheme$host$request_uri $cookie_user";

否则不同用户可能拿到彼此的缓存结果(比如登录态页面被缓存)。

静态资源建议搭配 proxy_buffering 和 gzip

proxy_buffering on;
proxy_buffers 8 16k;
proxy_busy_buffers_size 32k;
gzip on;
gzip_types text/css application/javascript image/svg+xml;

这些不改变缓存逻辑,但能降低传输延迟,尤其对压缩后的文本类静态资源效果明显。

不复杂但容易忽略

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx nginx proxy_cache proxy

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

457

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

940

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

3032

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

996

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

909

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

454

3

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

2756

4

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

2023.10.20

5152

4

宽带如何接入服务器
宽带如何接入服务器

宽带接入服务器的方法有ADSL宽带接入服务器、光纤接入服务器、无线接入服务器和以太网接入服务器等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.20

807

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习