WordPress开启Nginx fastcgi_cache缓存加速方法-Nginx配置实例

首发：2018年12月13日
有问题请联系Qi 更新于： 2026年11月5日 12:17
by Qi
87

使用WordPress建站的过程中，对于优化Wordpress性能、加快网站访问速度这一环节走了不少的“弯路”。当网站出现访问缓慢、CPU内存耗尽的情形时，最开始想到的是升级服务器配置，后来发现有些无良的VPS商家背后限制资源严重，加钱升级真的很伤人。

最大的体会就是同样的配置，在不同的VPS商家那里跑同一个网站，在同样的流量情况下，居然一个顺畅而另一个卡顿，这个给我最大的感受就是在购买VPS之前一定要看看别人的评测，尤其是VPS主机性能评测这一块，一定要仔细对比，否则容易花不少冤枉钱。

后来给Wordpress做优化时，关注在页面缓存上，之前用过的缓存插件包括但不限于WordPress Super Cache、WP Fastest Cache、W3 Total Cache、cos-html-cache、Cachify……总得来说，安装了缓存插件后提速还是有效果的，但是也带来了不少的问题。

例如配置复杂、生成规则、插件冲突以及无法应对突发流量，也就是说使用缓存插件还是无法达到应对大流量冲击的情况。最后，在朋友的推荐下启用了Nginx fastcgi_cache缓存，直接使用Nginx为页面生成缓存，效率比使用PHP缓存插件要高得多，特别适合小配置的VPS上使用。

更多的关于Wordpress和服务器优化的经验文章，这里还有：

PS：2026年11月5日更新，修正了 FastCGI 缓存绕过和写入条件，保留上游禁缓存头，并补上登录态、REST 与购物车的核验方法。

PS：2018年12月19日更新，WordPress自带的站内搜索不仅搜索慢而且还无法搜索更多的关键字，我们可以自建一个或者使用第三方的搜索嵌入WP：改进网站站内搜索-百度,Google自定义搜索和Elasticsearch自建搜索。 PS：2019年9月29日更新，由于Google主导开发的服务器优化神器ngx_pagespeed，集成了图片延迟加载、自适应webp、JS和CSS优化、图片优化等一整套优化工具：PageSpeed服务器优化神器-Nginx部署ngx_pagespeed模块和加速效果体验。

一、安装Nginx ngx_cache_purge模块

普通页面缓存是 Nginx 自带的 FastCGI 功能；只有需要按 URL 清理缓存时，才检查当前版本的清理接口或模块。下面的 2.3 模块、编译命令及配图是当时的 LNMP、OneinStack 环境记录。已有网站先用 nginx -V 查构建参数，别直接覆盖正在运行的二进制。

网站：

http://labs.frickle.com/files/

1.1 LNMP

如果你用的是LNMP一键安装包，编辑lnmp安装包目录下的 lnmp.conf 文件，在Nginx_Modules_Options=” 的单引号中加上 –add-module=/root/ngx_cache_purge-2.3 保存，升级一下nginx就安装上了，其他模块也参考这个就行。

旧文使用的是 ngx_cache_purge 2.3，下载地址留作历史记录。当前 Nginx 是否支持清理缓存，要看安装版本及实际加载的模块。

1.2 Oneinstack

如果你用的是OneinStack面板，可以通过以下命令来编译ngx_cache_purge模块。

# nginx -V 2>&1 | grep -o ngx_cache_purge 查看ngx_cache_purge是否安装,没有数据表示未安装
cd /root/oneinstack/src
wget http://labs.frickle.com/files/ngx_cache_purge-2.3.tar.gz
tar xzf ngx_cache_purge-2.3.tar.gz

#以下几个安装包都是Oneinstack自带的，不同的版本可能会不同，请根据情况调整
tar xzf nginx-1.14.0.tar.gz
tar xzf pcre-8.42.tar.gz
tar xzf openssl-1.0.2o.tar.gz
cd /root/oneinstack/src/nginx-1.14.0

nginx -V #查看nginx编译参数，最后加上--add-module=../ngx_cache_purge-2.3
./configure --prefix=/usr/local/nginx --user=www --group=www --with-http_stub_status_module --with-http_v2_module --with-http_ssl_module --with-http_gzip_static_module --with-http_realip_module --with-http_flv_module --with-http_mp4_module --with-openssl=../openssl-1.0.2o --with-pcre=../pcre-8.42 --with-pcre-jit --with-ld-opt=-ljemalloc --add-module=../ngx_cache_purge-2.3

make  #编译
mv /usr/local/nginx/sbin/nginx{,_`date +%F`}  #备份nginx
cp objs/nginx /usr/local/nginx/sbin
nginx -V 2>&1 | grep -o ngx_cache_purge
# 显示ngx_cache_purge表示已经安装成功

使用Nginx -V查看编译参数添加add-module时，一定要根据你自己的Nginx的编译参数来操作，也就是说保留原来的Nginx参数再加上add-module。例如我的：

安装Nginx ngx_cache_purge模块成功。

1.3 其它面板

如果你用的是其它的面板（专题：服务器控制面板榜单），例如WDCP、BT宝塔面板等，请查阅官网的文档。

二、Nginx开启fastcgi_cache缓存-配置实例

2.1 配置实例

下面我直接贴出wzfou.com的Nginx开启fastcgi_cache缓存配置实例，详细的说明如下：

#路径需要提前创建好
fastcgi_cache_path /tmp/nginx-cache levels=1:2 keys_zone=WORDPRESS:250m inactive=1d max_size=500m;
fastcgi_temp_path /tmp/nginx-cache/temp;
fastcgi_cache_key "$scheme$request_method$host$request_uri";
fastcgi_cache_use_stale error timeout invalid_header http_500;
# 保留 PHP 响应的 Cache-Control、Expires 和 Set-Cookie 处理
# 不要用 fastcgi_ignore_headers 强制缓存这些响应

server {
   listen 80;
   listen 443 ssl http2;
  …………………此部省略……………………
  
   set $skip_cache 0;
   # 只缓存 GET 或 HEAD
   if ($request_method !~ ^(GET|HEAD)$) {
            set $skip_cache 1;
        }   
   #动态查询不缓存
   if ($query_string != "") {
            set $skip_cache 1;
        }   
   #后台等特定页面不缓存（其他需求请自行添加即可）
   if ($request_uri ~* "^/(wp-admin(?:/|$)|wp-json(?:/|$)|wp-login\.php|xmlrpc\.php|feed/|zhuye/|question/|bbs/|dongtai/|haoyou/|qun/|cart(?:/|$)|checkout(?:/|$)|my-account(?:/|$)|sitemap(?:_index)?\.xml)") {
            set $skip_cache 1;
        } 
   #对登录用户、评论过的用户不展示缓存
   if ($http_cookie ~* "comment_author|wordpress_[a-f0-9]+|wp-postpass|wordpress_no_cache|wordpress_logged_in|woocommerce_items_in_cart|woocommerce_cart_hash|wp_woocommerce_session_") {
            set $skip_cache 1;
        }
   if ($http_authorization != "") { set $skip_cache 1; }
   # PHP socket 路径以实际部署为准
   location ~ [^/]\.php(/|$) {
    #fastcgi_pass remote_php_ip:9000;
    fastcgi_pass unix:/dev/shm/php-cgi.sock;
    fastcgi_index index.php;
    include fastcgi.conf;
    #新增的缓存规则
    fastcgi_cache_bypass $skip_cache;
    fastcgi_no_cache $skip_cache;
    add_header X-Cache "$upstream_cache_status From $host";
    add_header Nginx-Cache "$upstream_cache_status";
    add_header X-Frame-Options SAMEORIGIN; # 只允许本站用 frame 来嵌套
    add_header X-Content-Type-Options nosniff; # 禁止嗅探文件类型
    etag  on;
    fastcgi_cache WORDPRESS;
     fastcgi_cache_valid 200 10m;
  }
  
  #缓存清理配置（可选）
  location ~ ^/purge(/.*)$ {
    allow 127.0.0.1;
    #此处填写你的服务器IP
    # 如需另一台管理机访问，在这里填该机器的可信地址
    deny all;
    #请注意此处的WORDPRESS要与上面的keys_zone保持一致
    fastcgi_cache_purge WORDPRESS "$scheme$request_method$host$1";
    }
  …………………此部分省略……………………	

}

2.2 有关说明

本地or内存？在fastcgi_cache_path和fastcgi_temp_path中，有人会建议将它设置为内存路径，例如：/dev/shm/nginx-cache levels=1:2 keys_zone=WORDPRESS:100m inactive=60m;，如果你的磁盘IO很慢的话建议采用此方式，毕竟内存的读写速度非常快。

fastcgi_cache_bypass 控制是否读取已有缓存，fastcgi_no_cache 控制是否写入，两项都要检查。后台、REST、登录态和带会话的页面应绕过缓存；如果商城自定义了购物车或结账 URL，还要补上实际路径。另开无痕窗口验证同一个公开 URL 先 MISS 后 HIT，再用登录会话、带查询参数的请求和购物车复核没有命中。Nginx 文档：https://nginx.org/en/docs/http/ngx_http_fastcgi_module.html 。

三、安装Nginx Helper插件-自动刷新缓存

通过上面的方法我们已经配置好了fastcgi_cache缓存，接下来我们就要解决当Wordpress有新评论、新文章时自动刷新Nginx缓存页面了。直接搜索Nginx Helper插件下载，然后是设置，首先是开启，清除方式选择本地文件。

插件还提供了其它的一些设置，例如发表新文章、新评论时是否更新Nginx缓存。

由于插件作者定义的缓存路径是 /var/run/nginx-cache ，而我们可能会根据服务器实际情况来自定义缓存路径，这样一来缓存路径的不同就会导致插件无法找到缓存文件并删除！

解决办法是在 WordPress 根目录下的 wp-config.php 中新增如下代码即可：

//根据实际情况定义缓存的存放路径
define( 'RT_WP_NGINX_HELPER_CACHE_PATH','/tmp/wpcache');

如果你发现上述定义路径的代码不生效，你可以采用“自然”博主的建议：

一是修改插件，将插件中路径改成你自己的，二是使用软连接，/var/run/nginxcache 和/tmp/wpcache

三、Nginx fastcgi_cache效果预览

启用了Nginx fastcgi_cache后，我们就可以在浏览器Header 头部信息中看到已经命中了。

对于已经设置了不缓存的页面，Nginx fastcgi_cache会直接显示BYPASS。

另外，对于已经登录的用户还有发表过评论的用户，Nginx fastcgi_cache也会直接BYPASS。

同时，我们服务器的缓存路径中也能看到Nginx fastcgi_cache生成的缓存文件。

如果你发现你的评论过的用户依然用的是缓存，那应该是WP没有记住cookie，把以下代码加入到functions.php 中即可。

add_action('set_comment_cookies','coffin_set_cookies',10,3);
function coffin_set_cookies( $comment, $user, $cookies_consent){
   $cookies_consent = true;
   wp_set_comment_cookies($comment, $user, $cookies_consent);
}

四、总结

Nginx开启fastcgi_cache缓存对于加快网页响应速度以及节省服务器资源有着非常重要的意义，下图是alibabacloud.com的测试结果，可以看出来启用缓存后服务器的承载能力有了非常大的提升。

wzfou.com挖站否在启用fastcgi_cache缓存时，发现在Nginx配置文件中添加了Cache-Control信息，但是总是不生效。HTTP头部信息会总会包含以下信息：

Cache-Control: no-store,no-cache,must-revalidate,post-check=0,pre-check=0 和 Pragma: no-cache，

上面是旧版 PHP 会话配置的排查记录。遇到这些头先确认是哪段代码开启了会话，保留私有响应的禁缓存标记。仅对确认公开且不含用户状态的页面做缓存，再核对响应头。

文章出自：挖站否 https://wzfou.com/nginx-fastcgi-cache/，内容参考来自 linuxeye.cn（https://blog.linuxeye.cn/439.html）、zhangge.net（https://zhangge.net/5042.html）和 alibabacloud.com（https://www.alibabacloud.com/blog/WordPress-Caching-Solutions-Part-2—Configuring-NGINX-FastCGI-Static-Page-Caching-and-Final-Load-Testing_328726）版权所有。本站文章除注明出处外，皆为作者原创文章，可自由引用，但请注明来源。

收藏 6 点赞 2