Nginx 缓存策略怎样配置：把 proxy_cache 关键参数一次讲清

Dylan

发布时间：2026-08-24 | 70人浏览过

原创

前言

很多人第一次配 Nginx 缓存，容易被 proxy_cache_path、proxy_cache_key、proxy_cache_valid 这一串指令劝退。其实它并不复杂，核心就是先定义缓存放哪、怎么命名、哪些请求能缓存、命中后缓存多久，再决定什么时候绕过缓存或重新验证。下面先放一份完整示例，再按实际使用时最关心的几个问题拆开说明。看完之后，你可以更快判断一套缓存配置到底是在提升命中率，还是在制造磁盘、权限和过期策略上的隐患。

很多人第一次配 Nginx 缓存，容易被 proxy_cache_path、proxy_cache_key、proxy_cache_valid 这一串指令劝退。其实它并不复杂，核心就是先定义缓存放哪、怎么命名、哪些请求能缓存、命中后缓存多久，再决定什么时候绕过缓存或重新验证。

下面先放一份完整示例，再按实际使用时最关心的几个问题拆开说明。看完之后，你可以更快判断一套缓存配置到底是在提升命中率，还是在制造磁盘、权限和过期策略上的隐患。

先看一份可用的 Nginx 缓存配置

http {
    # 缓存路径
    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;

    server {
        listen 80;
        server_name example.com;

        location / {
            # 启用缓存
            proxy_cache my_cache;
            proxy_pass http://backend_server;

            # 缓存控制头
            add_header X-Proxy-Cache $upstream_cache_status;

            # 缓存有效期
            expires 30d;

            # 缓存方法
            proxy_cache_methods GET HEAD;

            # 缓存键
            proxy_cache_key "$scheme$proxy_host$request_uri";

            # 缓存条件
            proxy_cache_valid 200 302 10m;
            proxy_cache_valid 404 1m;

            # 缓存刷新
            proxy_cache_bypass $http_pragma;
            proxy_cache_revalidate on;
        }
    }
}

这份配置分成两层：http 块负责定义缓存区本身，location 块负责决定请求怎样使用这块缓存。理解这两个层级，后面的参数就好拆了。

缓存目录和缓存区参数怎么理解

proxy_cache_path 是整套配置的基础

proxy_cache_path 用来定义缓存的物理存储位置，以及缓存区的几个核心约束条件：

展示 proxy_cache_path 各参数作用的白底信息图 — **proxy_cache_path 参数关系图**把缓存目录、层级、内存区、磁盘上限和清理条件放在一张图里，更容易看出它们分别约束了什么。

proxy_cache_path /var/cache/nginx：指定缓存文件保存路径。
levels=1:2：定义缓存目录层级，例如 /var/cache/nginx/c/29/...，这样可以避免单个目录下堆太多文件。
keys_zone=my_cache:10m：定义缓存区域名称和元数据内存大小。这里的 my_cache 是后面 proxy_cache 要引用的名字，10m 通常足够存几万个键。
max_size=1g：限制缓存最大磁盘占用，超过 1g 后 Nginx 会自动清理旧缓存。
inactive=60m：缓存项如果在 60m 内没有被访问，会被视为不活跃并清理。
use_temp_path=off：通常建议关闭，直接写入缓存目录，减少额外 I/O 开销。