Nginx 中怎么配置 proxy_cache 结合 CDN 边缘节点实现多级缓存-Nginx-PHP中文网

Nginx proxy_cache与CDN协同构建两级缓存体系：CDN负责外层静态资源快速分发，Nginx作为回源前缓冲，处理未命中、灰度、带Cookie等精细化场景；需通过proxy_ignore_headers忽略后端干扰头，用proxy_cache_valid统一定义缓存策略，并借助Surrogate-Control等头实现协同控制。

nginx 中怎么配置 proxy_cache 结合 cdn 边缘节点实现多级缓存

在 Nginx 中配置 proxy_cache 与 CDN 边缘节点协同工作，本质是构建“Nginx 反向代理层缓存 + CDN 边缘节点缓存”的两级缓存体系。关键不在于让两者重复缓存同一份内容，而在于明确分工：CDN 负责最外层、高并发、静态/半静态资源的快速分发；Nginx proxy_cache 则作为回源前的最后一道缓冲，缓解源站压力，并处理 CDN 未命中或需精细化控制的场景（如带 Cookie 的登录态页面、灰度流量、私有头信息等）。

明确缓存层级职责，避免冲突

CDN 和 Nginx proxy_cache 都依赖 HTTP 缓存头（Cache-Control、Expires、Surrogate-Control 等）决策是否缓存及缓存时长。若配置不当，容易出现：

CDN 缓存了本不该缓存的敏感响应（如含用户信息的 HTML）
Nginx 误缓存了 CDN 已设为不缓存的内容，导致 stale 回源
两者缓存时间不一致，造成边缘节点过期但 Nginx 仍返回旧内容

建议做法：

CDN 层统一由 Cache-Control 控制，例如对 /static/ 设为 public, max-age=31536000（强缓存一年），对 /api/ 设为 no-cache 或 private
Nginx proxy_cache 不主动覆盖响应头，而是用 proxy_ignore_headers Cache-Control Expires Set-Cookie; 忽略后端返回的干扰头，再通过 proxy_cache_valid 主动定义自己的缓存策略
对需两级缓存的内容（如图片、JS/CSS），确保后端响应中 Cache-Control: public, max-age=86400，CDN 和 Nginx 均可识别并缓存

配置 Nginx proxy_cache 区域与基础参数

在 http 块中定义共享内存缓存区（注意路径权限和磁盘空间）：

proxy_cache_path /var/cache/nginx/proxy_cache levels=1:2 keys_zone=cdn_cache:256m inactive=3d max_size=20g use_temp_path=off;

说明：

keys_zone=cdn_cache:256m：256MB 共享内存用于存储缓存 key 和元数据，支持约千万级 key
inactive=3d：3 天内未被访问的缓存条目自动清理（不影响 max_age）
use_temp_path=off：避免写临时文件，提升 I/O 效率

在 location 或 server 块中启用缓存：

aperture: the L402 aware reverse proxy

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

下载

location / {
    proxy_pass https://origin.example.com;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
<pre class="brush:php;toolbar:false;"># 启用缓存
proxy_cache cdn_cache;
proxy_cache_valid 200 301 302 1h;        # 成功响应默认缓存 1 小时
proxy_cache_valid 404 1m;                 # 404 缓存 1 分钟，防刷
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
proxy_cache_lock on;                      # 防止缓存失效时的并发回源（仅首请求回源）
proxy_cache_lock_timeout 5s;

# 关键：不继承后端的 Cache-Control，按自己规则走
proxy_ignore_headers Cache-Control Expires Set-Cookie Vary;
add_header X-Cache-Status $upstream_cache_status;  # 方便调试

}

与 CDN 协同的关键 Header 控制技巧

CDN 通常支持 Surrogate-Control 或自定义缓存指令（如 Cloudflare 的 CF-Cache-Status、阿里云 CDN 的 X-Cdn-Status）。Nginx 可配合这些头做差异化处理：

若 CDN 已命中，它可能添加 X-Cache: HIT from cdn，Nginx 可忽略自身缓存逻辑（但一般不建议跳过 proxy_cache，因 Nginx 缓存更靠近源站，延迟更低）
对需绕过 CDN 直达 Nginx 缓存的请求（如内部监控、灰度请求），可通过特定 header（如 X-Bypass-CDN: 1）+ map 指令动态开关缓存：

map $http_x_bypass_cdn $cache_key {
    default "$scheme$request_method$host$request_uri";
    "1"     "$scheme$request_method$host$request_uri$arg_version";  # 加版本区分
}
proxy_cache_key $cache_key;

验证与运维要点

上线前务必验证两级缓存行为是否符合预期：

用 curl -I 查看响应头：X-Cache-Status（Nginx）、X-Cache 或 CF-Cache-Status（CDN），确认 HIT/MISS 层级
修改资源后，先刷新 CDN 缓存（如 purge URL），再检查 Nginx 缓存是否同步失效（可手动 rm -rf /var/cache/nginx/proxy_cache/* 清空，或用 proxy_cache_purge 模块）
监控 proxy_cache_miss、proxy_cache_hit、proxy_cache_expired 等变量，结合日志分析缓存效率
对 POST/PUT/DELETE 请求默认不缓存，如需缓存（如幂等接口），显式配置 proxy_cache_methods POST; 并谨慎评估一致性风险

不复杂但容易忽略