讲师中心 微信公众号
AI工具推荐 视频效率加速

如何通过 proxy_cache_purge 模块实现后端更新后的代理缓存主动清理

雨敏吖_5677

雨敏吖_5677

发布时间:2026-05-24 21:25:00

|

221人浏览过

|

来源于php中文网

原创

需启用proxy_cache_purge模块并严格匹配cache_key:先定义proxy_cache_path和proxy_cache,再配置/purge location限制IP,确保proxy_cache_key与purge请求的key完全一致,最后用curl触发清理。

如何通过 proxy_cache_purge 模块实现后端更新后的代理缓存主动清理

要实现后端内容更新后主动清理 Nginx 代理缓存,需启用并正确配置 proxy_cache_purge 模块(Nginx 官方版本不内置,需编译时添加或使用 OpenResty/Tengine 等集成版本)。

确认模块已启用并配置缓存区域

该模块依赖于已定义的缓存区(proxy_cache_path),且 purge 操作必须与缓存 key 的生成逻辑严格一致。确保 Nginx 编译时包含 --with-http_proxy_cache_purge_module,或使用已集成该模块的发行版。

在 http 块中定义缓存路径,并启用缓存:

proxy_cache_path /var/cache/nginx/proxy_cache levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;

在 server 或 location 块中启用缓存及 purge 支持:

location / {
    proxy_pass http://backend;
    proxy_cache my_cache;
    proxy_cache_valid 200 302 10m;
    proxy_cache_valid 404      1m;
    proxy_cache_key "$scheme$request_method$host$request_uri";  # 关键:purge 时需匹配此规则
}

配置 purge 接口并限制访问权限

通过独立 location 暴露 purge 功能,仅允许可信来源(如本地运维脚本、CI/CD 部署服务)调用,避免被恶意利用清空全部缓存。

aperture: the L402 aware reverse proxy
aperture: the L402 aware reverse proxy

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

下载

示例配置(放在同一 server 块内):

location ~ /purge(/.*) {
    allow 127.0.0.1;        # 仅允许本机触发
    allow 10.0.1.50;         # 或指定部署服务器 IP
    deny all;
    proxy_cache_purge my_cache "$scheme$request_method$host$1";
}

注意:$1 对应正则捕获的路径部分,例如请求 GET /purge/api/v1/users 会尝试清除 key 为 httpsGETexample.com/api/v1/users 的缓存项(需与 cache_key 完全一致)。

触发缓存清理的常用方式

后端发布新内容后,可通过 HTTP 请求调用 purge 接口。推荐使用 curl 或自动化工具发送 POST 或 GET 请求(模块默认支持 GET,部分版本也支持 PURGE 方法)。

  • 清除单个 URL 缓存:curl -X GET "http://example.com/purge/api/article/123"
  • 清除带参数的 URL(需确保 cache_key 包含 query):proxy_cache_key "$scheme$request_method$host$request_uri";,然后请求 /purge/api/search?q=test
  • 若需通配清除(如某目录下全部内容),需配合自定义 Lua 脚本(OpenResty)或外部缓存管理服务,原生 proxy_cache_purge 不支持正则或前缀批量删除

验证 purge 是否生效

清理后可通过响应头判断是否命中缓存:

  • 返回 X-Proxy-Cache: MISS 或无该头 → 缓存已清,下次请求将回源
  • 返回 X-Proxy-Cache: HIT → 缓存仍存在,检查 proxy_cache_key 与 purge 请求中的 key 是否完全一致(包括大小写、斜杠结尾、协议、方法)
  • 查看缓存目录文件是否存在:find /var/cache/nginx/proxy_cache -name "*$(echo -n 'httpsGETexample.com/path' | md5sum | cut -d' ' -f1)*"

常见失败原因:key 不匹配、IP 被拒绝、location 未继承 cache zone、purge 路径未加 / 导致正则不匹配。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2743

2023.08.11

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6890

2024.03.19

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

6366

2024.03.19

C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

3529

2023.06.20

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2408

2023.07.25

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

1340

2023.08.02

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1298

2023.08.09

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

1416

2023.09.05

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

60

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
LLVM官方文档
LLVM官方文档

共0课时 | 0人学习

Memcheck使用手册
Memcheck使用手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn