如何配置proxy_cache_purge扩展实现秒级全网缓存清理-Nginx-PHP中文网

秒级全网缓存清理的关键在于构建可触发、可收敛、可同步的分布式链路，而非依赖proxy_cache_purge单点能力；该模块仅执行本地精准清除，需通过服务发现或消息队列自动分发、全局一致的cache key与zone配置、低rtt网络控制等架构手段实现。

如何配置proxy_cache_purge扩展实现秒级全网缓存清理

要实现秒级全网缓存清理，关键不是靠 proxy_cache_purge 模块“单点加速”，而是构建一套可触发、可收敛、可同步的分布式缓存清理链路。proxy_cache_purge 本身只负责本地 Nginx 实例的缓存条目失效，它不跨节点、不广播、不排队，所谓“秒级全网”必须靠架构设计补足。

必须明确：proxy_cache_purge 不是分布式缓存清理工具，它是本地精准清除指令执行器。

一、单机 purge 必须先做到毫秒级可靠

确保每个边缘 Nginx 节点上的 purge 操作本身无延迟、无失败：

使用 proxy_cache_purge 配合显式、轻量的 proxy_cache_key
例如：

proxy_cache_key "$host$request_uri";  # 去掉 $args 和 $scheme 可减少 key 变异（若业务允许）

purge location 禁用所有非必要处理（不走 rewrite、不调 upstream、不加 header）

location ~ ^/purge(/.*)$ {
    allow 10.10.0.0/16;
    deny all;
    proxy_cache_purge my_cache "$host$1";
}

避免在 purge location 中启用 proxy_set_header 或 proxy_pass，否则会引入代理开销甚至死循环。

二、全网 ≠ 手动逐台 curl，需自动分发机制

“全网”指所有接入层或边缘缓存节点（如 CDN 回源集群、多可用区 LB 后 Nginx）。不能靠人工遍历 IP 发请求。

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

推荐两种轻量可靠方式：

基于服务发现的批量触发脚本
从 Consul/Etcd/K8s API 获取当前全部活跃 Nginx 边缘节点 IP 列表，用并发 curl（如 GNU parallel 或 Python aiohttp）统一发送 PURGE 请求：
```
cat edge_nodes.txt | parallel -j 20 'curl -X PURGE http://{}/purge{} -s -o /dev/null -w "%{http_code}\n"'
```
通过消息队列或 webhook 中心化下发
运维平台或发布系统触发一次“清理事件”，由内部服务将 purge 指令推送到各节点本地 agent（如 systemd socket 激活的轻量 HTTP server），再转为本地 curl -X PURGE http://127.0.0.1/purge/...。避免网络抖动影响主链路。

三、保证“秒级”的三个隐藏前提

缓存 key 全局一致
所有节点使用完全相同的 proxy_cache_key 规则（包括 $host 是否标准化、是否忽略大小写、query 参数是否排序等）。一个节点用 $request_uri，另一个用 $uri$is_args$args，就会导致 purge 失效。
缓存 zone 名称与路径配置一致
proxy_cache_purge my_cache ... 中的 my_cache 必须和 proxy_cache_path ... keys_zone=my_cache:... 完全匹配，且所有节点 zone 名不能因环境差异而不同（如 dev_cache / prod_cache）。
网络 RTT 控制在 10ms 内 + 节点数 ≤ 50 台
单次 purge 是纯内存操作，耗时 -m 1）时标记失败并告警，不阻塞整体流程。