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,需要检查缓存键是否变化、请求方法是否支持缓存、上游响应是否包含禁止缓存的头信息。
按自己的节奏,确认真正理解。