如何配置与清理Nginx proxy_cache缓存以提升网站性能？

Nginx作为高性能的Web服务器和反向代理软件，在处理高并发请求时表现优异。当后端服务接口响应较慢或数据库查询开销较大时，每次请求都直接转发给后端处理无疑会造成资源浪费。此时，启用Nginx的proxy_cache模块将后端响应数据缓存起来，可以极大提升吞吐量并降低响应延迟。合理配置缓存策略并掌握高效的缓存清理方法，是保障数据实时性与系统高性能的关键。

Nginx proxy_cache的基础配置与核心指令

要启用代理缓存，首先需要在Nginx配置文件的http块中定义一个共享内存区域和缓存文件存储路径。这一步通过proxy_cache_path指令完成。该指令不仅指定了磁盘路径，还设置了缓存内存区的大小、缓存文件的最大存活时间以及目录层级结构。如果不设置目录层级，大量缓存文件会堆积在一个目录下，导致文件系统检索效率急剧下降。

在定义好缓存路径后，接下来需要在具体的server或location块中激活缓存。通过proxy_cache指令引用之前定义的缓存区域名称，Nginx便开始对匹配的请求进行缓存处理。同时，通常还需要配合proxy_pass指令将请求代理到后端服务器。为了控制哪些请求可以被缓存，可以使用proxy_no_cache和proxy_cache_bypass指令，例如对包含特定Cookie的请求不进行缓存。

http {
    # 定义缓存路径、目录层级、内存区大小和最大不活动时间
    proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;

    server {
        listen 80;
        server_name ipipp.com;

        location /api/ {
            proxy_pass http://backend_server;
            # 引用定义的缓存区
            proxy_cache my_cache;
            # 设置缓存的有效期
            proxy_cache_valid 200 304 10m;
            proxy_cache_valid 404 1m;
            # 添加响应头标识是否命中缓存
            add_header X-Cache-Status $upstream_cache_status;
        }
    }
}

上述配置中，levels=1:2表示使用两级目录结构来存储缓存文件，这能有效避免单目录下文件过多。keys_zone参数定义了名为my_cache的共享内存区，大小为10MB，用于存储缓存键和元数据。max_size限制了硬盘上缓存文件的最大空间，当超过此大小时，Nginx的缓存管理器进程会自动删除最近最少使用的缓存文件。inactive参数则指定了如果缓存数据在60分钟内没有被访问，就会被自动清理。

缓存键的精细化设计与响应头控制

Nginx决定是否命中缓存的核心依据是缓存键。默认情况下，缓存键由请求的HTTP方法、主机名和请求URI组成。但在实际业务场景中，这往往不够用。例如，同一个API接口如果根据不同的请求头返回不同的数据，或者接口依赖于查询参数的顺序，默认的缓存键就会导致数据错乱。此时需要使用proxy_cache_key指令重新定义缓存键的生成规则。

通过自定义proxy_cache_key，可以将请求的特定部分纳入键值计算中。比如将请求的Host头、URI以及一些自定义的请求头拼接起来。需要注意的是，缓存键越长，占用的内存越多，因此应当只包含影响响应内容的关键字段。此外，还可以利用proxy_ignore_headers指令忽略后端返回的某些响应头，比如后端可能强制设置了Cache-Control: no-cache，如果不忽略该头部，Nginx将不会缓存此响应。

location /api/ {
    proxy_pass http://backend_server;
    proxy_cache my_cache;
    
    # 自定义缓存键，包含主机名、请求URI和自定义Token头
    proxy_cache_key "$scheme$request_method$host$request_uri$http_x_custom_token";
    
    # 忽略后端的Cache-Control和Set-Cookie头部，强制缓存
    proxy_ignore_headers Cache-Control Set-Cookie;
    
    # 隐藏后端返回的某些头部，不将其传递给客户端
    proxy_hide_header X-Powered-By;
    
    # 对POST请求也进行缓存（需谨慎，仅在特定场景下使用）
    proxy_cache_methods GET HEAD POST;
    proxy_cache_valid 200 302 10m;
    proxy_cache_valid 404 1m;
}

在处理动态接口时，有时后端服务会在响应头中加入Set-Cookie，这会导致Nginx默认不缓存该响应。如果确认某些接口的响应与用户身份无关，可以通过proxy_ignore_headers忽略掉这些头部，强制Nginx将结果缓存下来。同时，使用proxy_hide_header可以隐藏后端服务器的指纹信息，如X-Powered-By，提升安全性。对于proxy_cache_methods指令，虽然Nginx允许缓存POST请求，但必须确保POST请求体相同且业务逻辑允许，否则极易造成数据污染。

Nginx缓存的自动化清理与手动清除方案

缓存虽然能极大提升性能，但当源站数据发生更新时，如果不及时清理旧缓存，用户就会获取到过期数据。最简单粗暴的清理方式是直接删除缓存目录下的所有文件。通过Linux的rm命令可以快速清空整个缓存目录。但这种方式存在明显缺陷：在删除过程中，如果有大量并发请求到达，Nginx会瞬间将所有请求穿透到后端，可能引发缓存雪崩，压垮后端服务器。

为了实现更平滑、更精准的缓存清理，推荐使用第三方模块ngx_cache_purge。该模块允许通过发送特定URL请求的方式，精确清除指定URI的缓存。要使用此模块，需要在编译Nginx时通过--add-module参数将其静态编译进去。配置时，需要定义一个特殊的location块来处理清理请求，并验证请求方的权限，防止恶意用户随意清空缓存。

location ~ /purge(/.*) {
    # 允许的客户端IP地址
    allow 127.0.0.1;
    allow 192.168.1.0/24;
    deny all;
    
    # 配置缓存清理，指定缓存区域和需要清理的URI
    proxy_cache_purge my_cache $1$is_args$args;
    
    # 清理完成后返回的状态码
    proxy_cache_purge_status 204;
}

location /api/ {
    proxy_pass http://backend_server;
    proxy_cache my_cache;
    proxy_cache_key "$scheme$request_method$host$request_uri";
    proxy_cache_valid 200 10m;
}

当后端数据更新后，后台系统可以通过向Nginx发送类似http://ipipp.com/purge/api/data?id=1的请求，来清除对应/api/data?id=1的缓存。由于ngx_cache_purge模块是根据proxy_cache_key来匹配缓存文件的，所以清理请求的参数必须与原始请求的缓存键完全一致。如果Nginx未安装此模块，也可以编写自动化脚本，通过分析缓存文件的元数据，精准定位并删除特定的缓存文件，从而避免全量清理带来的性能波动。

除了上述方法，还可以通过在业务代码中控制响应头的方式实现缓存的主动过期。例如，在数据发生变更时，后端服务在接下来的几个请求中返回带有Cache-Control: no-cache或特定X-Accel-Expires头部的响应，Nginx接收到这些头部后会自动更新本地缓存。综合运用这些配置与清理策略，能够确保Nginx代理缓存在提升系统吞吐量的同时，保持数据的准确性与实时性。

Nginx proxy_cache缓存配置缓存清理修改时间：2026-08-30 05:13:09