Linux上安装配置ngx_cache_purge需重新编译Nginx并严格对齐缓存key：先用nginx -V检查模块支持，再下载源码与模块、configure时--add-module指定路径、make install；配置中proxy_cache_key与proxy_cache_purge的key表达式必须完全一致，最后通过PURGE请求及X-Cache-Status响应头三步验证清理效果。
Linux 上给 Nginx 安装并配置 ngx_cache_purge 模块，核心是「重新编译 Nginx + 正确配置 purge 路由 + 严格对齐缓存 key」。它不是插件式启用，不能通过 reload 配置生效，必须确保模块已集成进 Nginx 二进制文件中。
确认当前 Nginx 是否支持 cache_purge
执行以下命令检查：
nginx -V 2>&1 | grep -o 'cache_purge'
有输出（如 cache_purge）说明已支持；无输出则需重新编译。别跳过这步——很多问题源于误以为模块已存在。
编译安装含 ngx_cache_purge 的 Nginx
需从源码构建，步骤如下：
- 下载 Nginx 源码（如 nginx-1.24.0）和 ngx_cache_purge 模块（推荐用最新 release 或 --depth 1 克隆）
- 进入 Nginx 源码目录，运行 configure，关键参数包含：
--add-module=/path/to/ngx_cache_purge（路径必须准确）
同时建议保留常用模块，例如：--with-http_ssl_module --with-http_realip_module --with-http_stub_status_module - 执行
make && sudo make install（默认安装到/usr/local/nginx；若替换系统包，请备份原nginx并调整 PATH） - 验证：重启后再次运行
nginx -V | grep cache_purge，确认出现
配置 purge 接口并确保 key 严格一致
在 http 块中定义缓存区，在 server 块中配置 purge 路由：
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
示例配置片段：
proxy_cache_path /var/cache/nginx/mycache levels=1:2 keys_zone=mycache:10m max_size=1g inactive=60m use_temp_path=off;
server { location / { proxy_pass http://backend; proxy_cache mycache; proxy_cache_key "$scheme$request_method$host$request_uri"; # 关键：显式定义 proxy_cache_valid 200 302 10m; } location ~ ^/purge(/.*)$ { allow 127.0.0.1; allow 10.10.5.0/24; # 生产只放运维/CI IP 段 deny all; proxy_cache_purge mycache "$scheme$request_method$host$1"; # 必须与上面 proxy_cache_key 完全一致，$1 替换 $request_uri 中的路径部分 }}
⚠️ 注意：
– 若原始缓存 key 含 $args（即查询参数），purge 的 key 也必须含 $is_args$args，否则带 ? 的 URL 清不掉
– 不要用 $uri 代替 $request_uri，前者丢参数，极易失配
– proxy_cache_purge 指令后第一个参数是 keys_zone 名（如 mycache），第二个是 purge key 表达式，缺一不可
测试清理是否真正生效
分三步验证，不能只看状态码：
- 先访问目标 URL 一次，确认响应头含
X-Cache-Status: HIT（表示已缓存） - 执行清理：
curl -X PURGE http://yourdomain.com/purge/path/to/page，应返回200 OK或204 No Content - 再次访问原 URL，响应头应变为
X-Cache-Status: MISS或BYPASS，且内容为最新（非旧缓存）
如果返回 404，常见原因是 location 未匹配或 key 不一致；返回 405 是 method 未放开；返回 200 却仍 HIT，大概率是 key 对不上。
