Nginx 中怎么配置 proxy_cache 结合 Lua 脚本实现主动清理缓存-Nginx-PHP中文网

Nginx需借助第三方purge模块（如OpenResty内置支持）配合Lua实现缓存主动清理，支持按URL、参数、前缀等规则清除，并须严格限制访问权限与频率以保障生产安全。

nginx 中怎么配置 proxy_cache 结合 lua 脚本实现主动清理缓存

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 请求，实现动态路径生成与条件清理：

Umbrel Proxy Manager

高效管理与交互 Umbrel 代理服务，支持 Docker 容器。自动发现运行服务，将内部 Docker IP 映射为可访问的外部地址。

下载

在 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（适合中小规模）