通过配置 nginx 的 `proxy_cache` 模块并启用 `valid_referers` 或自定义 header,结合 cdn 厂商提供的 api 实现缓存刷新联动。具体做法是在 nginx 中设置缓存路径和过期时间,当源站内容更新时,触发一个脚本调用 cdn 的刷新接口,确保用户获取最新资源。

Nginx 缓存配置与失效机制
Nginx 使用 `proxy_cache_path` 定义缓存存储位置,并通过 `proxy_cache_valid` 设置不同状态码的缓存有效期。例如,设置 200 OK 响应缓存 10 分钟,而 404 错误不缓存。这种配置决定了本地缓存的生命周期,是联动的基础。

server {
listen 80;
server_name example.com;
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
location / {
proxy_pass http://backend_server;
proxy_cache my_cache;
proxy_cache_valid 200 10m;
proxy_cache_valid 404 1m;
add_header X-Cache-Status $upstream_cache_status;
}
}
上述配置中,`my_cache` 区域用于存储缓存键,`inactive=60m` 表示如果资源在 60 分钟内未被访问,即使未过期也会被清除。`X-Cache-Status` 头信息帮助调试,显示 HIT、MISS 或 EXPIRED 状态。
CDN 缓存刷新 API 集成
主流 CDN 厂商如阿里云、腾讯云或 Cloudflare 均提供 HTTP API 用于主动刷新缓存。通常需要一个 Access Key 和 Secret Key 进行签名认证。刷新请求可以是单个 URL 或目录批量刷新。关键在于将 Nginx 的缓存管理与 CDN 的边缘节点缓存同步。

# 伪代码:调用 CDN 刷新 API
def refresh_cdn(url, access_key, secret_key):
timestamp = get_current_timestamp()
signature = sign(url + timestamp, secret_key)
payload = {
"url": url,
"timestamp": timestamp,
"signature": signature
}
response = post("https://cdn.api.com/refresh", json=payload)
return response.status_code == 200
在实际应用中,这个函数通常嵌入到发布流程中。当检测到源站文件变更(如 Git push 或 CMS 发布),自动执行此函数。注意处理 API 限流和重试逻辑,确保刷新请求成功送达 CDN 边缘节点。
基于源站文件变更触发的联动策略
当源站文件发生物理变更时,如何高效触发联动是关键。一种常见做法是利用 Webhook 或文件系统监控工具(如 inotify)检测文件修改。一旦检测到变化,立即调用 CDN 刷新接口,同时可选地清除 Nginx 本地缓存以加速后续请求从 CDN 回源获取最新数据。
例如,在 CI/CD 流水线中,构建完成后上传新文件至源站,紧接着执行刷新脚本。这样可确保 CDN 边缘节点尽快失效旧缓存,转而拉取新内容。对于静态资源,建议配合版本号或哈希值命名文件,从根本上避免缓存冲突,减少刷新频率。











