Nginx需借助第三方purge模块（如OpenResty内置支持）配合Lua实现缓存主动清理，支持按URL、参数、前缀等规则清除，并须严格限制访问权限与频率以保障生产安全。
Nginx 本身不支持直接通过 Lua 脚本触发 proxy_cache_purge，但可以借助 ngx_http_proxy_cache_purge_module（第三方 purge 模块）配合 Lua 实现“主动清理缓存”的逻辑控制，比如按 URL、参数、前缀或自定义规则批量清除。
1. 编译安装支持 purge 的 Nginx
官方 Nginx 不带缓存清理功能，需使用支持 proxy_cache_purge 的模块（如 ngx_cache_purge 或更现代的 openresty 内置 purge 支持）。推荐使用 OpenResty（已集成）：
- 下载安装 OpenResty（≥1.21.4.1），它默认启用
proxy_cache_purge指令 - 确认配置中启用缓存区：
proxy_cache_path /path/to/cache levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off; - 在 server 或 location 块中添加
proxy_cache_purge，例如：
location ~ /purge(/.*) {<br> allow 127.0.0.1;<br> deny all;<br> proxy_cache_purge my_cache "$scheme$request_method$host$1";<br>}
2. 用 Lua 构造 purge 请求并触发清理
利用 resty.http（需安装 lua-resty-http）从 Lua 中发起本地 purge 请求，实现动态路径生成与条件清理：
- 在
http块中加载库：lua_package_path "/path/to/lua-resty-http/lib/?.lua;;"; - 定义一个内部 location 处理清理逻辑（仅限本地调用）：
location @do_purge {<br> internal;<br> set $purge_key "";<br> content_by_lua_block {<br> local http = require "resty.http"<br> local httpc = http.new()<br> local uri = ngx.var.purge_uri or "/"<br> local res, err = httpc:request_uri("http://127.0.0.1/purge" .. uri, { method = "PURGE" })<br> if not res then ngx.log(ngx.ERR, "purge failed: ", err) return end<br> ngx.say("purged: ", uri)<br> }<br>} - 在业务逻辑中根据条件跳转：
access_by_lua_block {<br> if ngx.var.arg_action == "clear" then<br> ngx.var.purge_uri = ngx.var.uri<br> return ngx.exec("@do_purge")<br> end<br>}
3. 支持按前缀/通配符批量清理（需额外设计）
原生 proxy_cache_purge 只支持精确匹配 key。如需模糊清理（如清除 /api/v1/user/*），可采用以下方式：
-
方案 A：结合文件系统扫描 + Lua —— 在 Lua 中调用
os.execute执行 shell 命令，按 key 哈希目录结构删除对应缓存文件（注意：需严格同步 cache_path 的levels和keys_zone名称） -
方案 B：统一 key 命名 + 多 key 清理 —— 在
proxy_cache_key中嵌入可识别标签（如$host$request_uri$is_args$args$arg_v），再由后端或定时任务预生成待清理的 URI 列表，逐条调用 purge 接口 - 方案 C：使用 Redis 记录缓存 key（高级） —— Lua 在缓存回源时将 key 写入 Redis；清理时从 Redis 获取匹配 key，再循环调用 purge（适合中小规模）
4. 安全与生产注意事项
主动清理涉及服务稳定性，必须限制权限和范围：
- 所有 purge 接口只允许
127.0.0.1或内网 IP 访问，禁止公网暴露 - 在 Lua 中校验请求来源（如检查
ngx.var.remote_addr）、签名或 token，避免未授权调用 - 避免高频 purge：加锁（如用
resty.lock）或限速（limit_req）防止雪崩 - 清理后建议返回缓存状态（如响应头
X-Cache-Status: PURGED），便于前端或监控识别
