Linux怎么配置Nginx缓存清理模块 Nginx cache_purge编译详解-LINUX-PHP中文网

不能，nginx -v 默认不显示 ngx_cache_purge，除非编译时显式添加 --add-module；该模块不支持动态加载，必须源码编译集成，且依赖 --with-http_proxy_module 等配置及版本兼容性。

linux怎么配置nginx缓存清理模块 nginx cache_purge编译详解

nginx -V 能看到 ngx_cache_purge 吗？先确认是否已内置

大多数发行版（如 Ubuntu apt 安装、CentOS yum 安装）的 Nginx 默认不带 ngx_cache_purge 模块，直接运行 nginx -V 查看输出，如果没出现 --add-module=...ngx_cache_purge，说明没编译进去。强行在配置里写 proxy_cache_purge 会导致 unknown directive "proxy_cache_purge" 错误，Nginx 启动失败。

这个模块不支持动态加载（即没有 .so 文件），必须源码编译时显式加入。别浪费时间找“启用模块”的开关或配置项——它不存在。

编译前必须处理的三个依赖点

缺一不可，否则 configure 阶段就报错或运行时崩溃：

ngx_cache_purge 必须和 Nginx 主版本兼容：2026 年主流用的是 1.24.x 或 1.25.x，但该模块官方最后更新停留在 1.21.x；实测 1.24.0 可用，1.25.3 已有部分函数签名不匹配，建议锁定 nginx-1.24.0 源码
系统需安装 build-essential（Ubuntu/Debian）或 gcc gcc-c++ make pcre-devel openssl-devel zlib-devel（RHEL/CentOS），否则 configure 失败
下载地址必须用官方源：Nginx 源码从 https://nginx.org/download/ 获取，ngx_cache_purge 必须用原作者 FRiCKLE 的仓库：https://github.com/FRiCKLE/ngx_cache_purge —— 别用 GitHub 上其他 fork，很多已停止维护甚至删了 config 文件

configure 参数里最容易漏掉的关键项

只加 --add-module=./ngx_cache_purge 不够，Nginx 编译默认不启用 proxy_cache 功能，必须显式打开相关模块：

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

正确命令示例（路径请按实际调整）：

./configure \
  --prefix=/usr/local/nginx \
  --with-http_proxy_module \
  --with-http_ssl_module \
  --with-http_realip_module \
  --add-module=./ngx_cache_purge \
  --http-cache-path=/var/cache/nginx \
  --user=www-data \
  --group=www-data

注意这几点：

--with-http_proxy_module 是硬性依赖，没它 proxy_cache 根本不工作，更别说 purge
--http-cache-path 不是必须，但它会自动在 nginx.conf 示例中生成对应路径提示；不加也行，但你得自己确保 proxy_cache_path 配置里的目录存在且权限正确
编译后检查模块是否真被识别：obj/Makefile 里应出现 ngx_cache_purge 相关编译目标；安装完运行 /usr/local/nginx/sbin/nginx -V 2>&1 | grep purge 应有输出

make install 后最常卡住的两个验证动作

编译成功 ≠ 能用。以下两步不做，配置再对也清不了缓存：

确保缓存目录存在且 Nginx worker 进程可写：sudo mkdir -p /var/cache/nginx && sudo chown www-data:www-data /var/cache/nginx（用户组名按你的 --user 和 --group 值调整）
配置中 proxy_cache_purge 指令的参数必须和 proxy_cache_key 严格一致：比如 proxy_cache_key "$scheme$host$request_uri"，那 purge location 就得写 proxy_cache_purge my_cache $scheme$host$1（注意 $1 是正则捕获，不是 $uri）；键不匹配会导致“看似执行成功，实则没删任何文件”