Web 服务器与网关 / 系统课时

建立代理缓存

建立代理缓存

本课解决 Nginx 反向代理响应重复请求时的性能问题,通过配置缓存目录、共享内存区和缓存位置,让静态或稳定接口可以直接返回缓存内容,并能观察 MISS、HIT 与 EXPIRED 状态。

学习目标

  • 理解 Nginx 代理缓存的组成部分和工作流程。
  • 掌握 proxy_cache_path 与 proxy_cache 的基础配置。
  • 学会通过响应头验证缓存命中状态。

认识代理缓存结构

Nginx 代理缓存由缓存文件、缓存元数据和共享内存区组成。缓存目录负责保存实际响应内容,共享内存区保存缓存键索引等快速查询信息。请求到达代理层后,Nginx 会先查找缓存,命中后直接返回已有响应。

当第一次请求资源时通常产生 MISS,Nginx 从上游获取内容并写入缓存。后续相同请求会产生 HIT,直接读取缓存。缓存超过有效时间后可能进入 EXPIRED,需要重新向上游刷新。

配置缓存目录与位置

下面示例为站点启用基础代理缓存。keys_zone 定义共享内存区名称和大小,proxy_cache 引用该缓存区域。

nginx
http {
    proxy_cache_path /var/cache/nginx/api levels=1:2 keys_zone=api_cache:10m inactive=30m max_size=1g;

    server {
        listen <PORT>;

        location /api/ {
            proxy_pass http://backend;
            proxy_cache api_cache;
            proxy_cache_valid 200 10m;
            add_header X-Cache-Status $upstream_cache_status;
        }
    }
}

预期结果

text
首次请求响应头包含:
X-Cache-Status: MISS

再次请求相同资源:
X-Cache-Status: HIT

理解缓存文件生命周期

缓存文件不会永久存在。Nginx 根据有效期、inactive 时间和缓存空间限制管理文件。当资源长期没有访问时,inactive 机制允许清理对应缓存;当缓存空间达到 max_size 时,旧缓存会被淘汰。

生产环境中需要结合业务数据变化频率设置有效期。接口数据更新频繁时,过长缓存可能导致用户看到旧数据;纯静态资源则可以设置更长时间。

验证缓存状态

可以使用响应头快速判断缓存是否生效,也可以查看缓存目录确认文件生成情况。

bash
curl -I http://example.com/api/users

预期输出

text
HTTP/1.1 200 OK
X-Cache-Status: HIT

如果始终返回 MISS,需要检查缓存键是否变化、请求方法是否支持缓存、上游响应是否包含禁止缓存的头信息。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

建立代理缓存

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通