Linux Nginx 怎么安装并配置 cache_purge 缓存清理模块-Nginx-PHP中文网

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 怎么安装并配置 cache_purge 缓存清理模块

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-sysadmin

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 对不上。