Nginx开启fastcgi_cache缓存加速，支持html伪静态页面

张戈博客不久前分享过 Nginx 开启缓存为 WordPress 加速的教程，其中分享了 2 种缓存模式：代理模式和本地模式。我一直以为单个 ngx_cache_purge 缓存模块只支持 proxy 代理模式，结果热心的网友回复，其实这个模块也是支持本地缓存的，而且 WordPress 还有配套的插件！

看来还是我孤陋寡闻了！

我像发现了新大陆一般，立马进入折腾状态，幸不辱命，已经成功部署！最爽的是可以通过插件来自动清理文章的对应缓存，解决了前文清理缓存的历史遗留问题。

一、添加模块

本文分享的 Nginx 缓存需要额外编译 ngx_cache_purge 模块。至于下载模块、重新编译以及平滑升级前文已经分享过了，本文就不再赘述了。不会的朋友可以参考前文：

为网站开启 Nginx 缓存加速，支持 html 伪静态页面

Ps：需要重新编译 Nginx，在原有的编译参数上新增一个 ngx_cache_purge 模块，比如：

--add-module=../ngx_cache_purge-2.3

不清楚怎么重新编译和平滑升级的的请参考前文进行操作。

二、Nginx 配置

要用这个缓存功能，建议重新弄一个 server 模块（替换之前的），如下代码是张戈博客目前正在使用的规则（已删除了我自定义的伪静态规则，避免混淆视听）：

####################################################################################################
#     Nginx 开启 fastcgi_cache-purge 缓存加速，支持 html 伪静态页面 By 张戈博客
#     文章地址：https://zhang.ge/5042.html ‎
#     参 考 ①：http://jybb.me/nginx-wordpress-fastcgi_cache-purge
#     参 考 ②：https://rtcamp.com/wordpress-nginx/tutorials/single-site/fastcgi-cache-with-purging/
#     转载本文请务必保留以上申明，谢谢合作！
####################################################################################################

#下面各个参数的含义请自行百度，我就不赘述了
#下面 2 行的中的 wpcache 路径请自行提前创建，否则可能会路径不存在而无法启动 nginx，max_size 请根据分区大小自行设置
fastcgi_cache_path /tmp/wpcache levels=1:2 keys_zone=WORDPRESS:250m inactive=1d max_size=1G;
fastcgi_temp_path /tmp/wpcache/temp;
fastcgi_cache_key "$scheme$request_method$host$request_uri";
fastcgi_cache_use_stale error timeout invalid_header http_500;
#忽略一切 nocache 申明，避免不缓存伪静态等
fastcgi_ignore_headers Cache-Control Expires Set-Cookie;
#Ps：如果是多个站点，以上内容不要重复添加，否则会冲突，可以考虑将以上内容添加到 nginx.conf 里面，避免加了多次。
server
    {
        listen 80;
        #请修改为自己的域名
        server_name zhang.ge;
        index index.html index.htm index.php default.html default.htm default.php;
        #请修改为自己网站的存放路径
        root  /home/wwwroot/zhang.ge;
       
        set $skip_cache 0;
        #post 访问不缓存
        if ($request_method = POST) {
            set $skip_cache 1;
        }   
        #动态查询不缓存
        if ($query_string != "") {
            set $skip_cache 1;
        }   
        #后台等特定页面不缓存（其他需求请自行添加即可）
        if ($request_uri ~* "/wp-admin/|/xmlrpc.php|wp-.*.php|/feed/|index.php|sitemap(_index)?.xml") {
            set $skip_cache 1;
        }   
        #对登录用户、评论过的用户不展示缓存（这个规则张戈博客并没有使用，所有人看到的都是缓存）
        if ($http_cookie ~* "comment_author|wordpress_[a-f0-9]+|wp-postpass|wordpress_no_cache|wordpress_logged_in") {
            set $skip_cache 1;
        }
        #这里请参考你网站之前的配置，特别是 sock 的路径，弄错了就 502 了！
        location ~ [^/]\.php(/|$)
            {
                try_files $uri =404;
                fastcgi_pass  unix:/tmp/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";
                fastcgi_cache WORDPRESS;
                fastcgi_cache_valid 200 301 302 1d;
        }
        location / {
                #此处可以添加自定义的伪静态规则（之前你新增的伪静态规则可以添加到这，没有就不用了）
                try_files $uri $uri/ /index.php?$args;
                rewrite /wp-admin$ $scheme://$host$uri/ permanent;
         }
        #缓存清理配置（可选模块，请细看下文说明）
        location ~ /purge(/.*) {
            allow 127.0.0.1;
            allow "此处填写你服务器的真实外网 IP";
            deny all;
            fastcgi_cache_purge WORDPRESS "$scheme$request_method$host$1";
        }
    
        location ~* ^.+\.(ogg|ogv|svg|svgz|eot|otf|woff|mp4|ttf|rss|atom|jpg|jpeg|gif|png|ico|zip|tgz|gz|rar|bz2|doc|xls|exe|ppt|tar|mid|midi|wav|bmp|rtf)$ {
                access_log off; log_not_found off; expires max;
        }

        location = /robots.txt { access_log off; log_not_found off; }
        location ~ /\. { deny  all; access_log off; log_not_found off; }
        #请注意修改日志路径
        access_log /home/wwwlogs/zhang.ge.log access;
}

请仔细阅读代码中的所有注释，该修改的修改，该创建的创建，该补充的根据实际情况补充，否则使用之后又来找张戈吐槽各种问题了！

三、安装插件

上文已经提到了 fastcgi_cache 有一个量身定做的 WordPress 缓存清理插件：Nginx Helper

所以，接下来我们就去安装这个插件 。非常简单，直接进入 WordPress 后台插件安装界面搜索 Nginx Helper 关键词在线安装即可。

安装后，从后台【工具】==>【Nginx Helper】打开插件设置界面如下所示：

Ps：顺带说一下后面 2 项的含义：

记录插件日志：勾选这个选项后，插件设置下面会显示日志记录存放路径。这个功能主要用来测试插件的设置，比如去已缓存的文字发表一个新的评论，然后看下日志里面是否出现删除记录。

插入缓存信息：勾选这个选项后，前台页面的源代码底部将插入页面的缓存信息，类似如下：

<!--Cached using Nginx-Helper on 2015-05-30 12:34:22. It took 162 queries executed in 1.922 seconds.-->
<!--Visit http://wordpress.org/extend/plugins/nginx-helper/faq/ for more details-->

勾上第启用缓存清理后，将出现如下选项：

该怎么设置，应该看图就懂了吧？否则张戈苦逼的用中文标注了半天就白费功夫了！

清理模式选择

上图我也标注的比较清楚了，还是详细解释一下吧！

①、purge 模式

这个模式需要保留上文 Nginx 配置中的 purge 清理路径，清理的时候会产生一个请求。

出于安全考虑，一般 purge 都不会完全开放！只有特定的 IP 可以访问，所以，如果用了 CDN 的朋友，再使用模式一，则需要在服务器上的 /etc/hosts 中将网站域名解析为服务器真实 IP，以便插件直接请求 purge 路径，而不用走 CDN 节点，避免请求被拒绝。还是没搞懂的话就放弃这个模式吧！

②、文件模式

模式二是直接清理对应的缓存文件，不需要请求 purge 这个清理路径，所以使用模式二，不需要配置上文 Nginx 的 purge 规则（我个人推荐使用这个模式）。

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

解决办法：

很简单，在 WordPress 根目录下的 wp-config.php 中新增如下代码即可：

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

Ps：不知道添加到第几行的话，可以添加到 define('WPLANG', 'zh_CN'); 的后面即可。添加后建议重载一下 php，确保变量生效（主要针对开启了 PHP 缓存的网站）。

三、效果预览

①、缓存效果

替换新的配置，并且重载 Nginx 之后，访问前台页面，查看 header，会多出一个 X-Cache 标志。

X-Cache 一般会有 3 个状态：MISS、HIT、BYPASS。

• MISS 表示未命中

即这个页面还没被缓存，新发布或刚被删除的页面，首次访问将出现这个状态（图略）。

• HIT 表示缓存命中

打开一个会缓存的页面，比如文章内容 html 页面，F5 刷新几次即可在 F12 开发者模式当中的 Header 头部信息中看到如图缓存命中状态：

• BYPASS 表示缓存黑名单

即页面路径在 Nginx 规则中被设置成不缓存（set $skip_cache 1;），比如 WP 后台，查看 header：

如果你发现想要缓存的页面却是这个状态，就可以去检查排除规则中是不是包含了这个路径！反之，如果你发现后台登录不了，或者各种登陆态丢失问题，则应该到排除规则中加上该页面路径的关键字。

②、清理效果

这个插件和缓存的搭配非常好用，不管我们是发布文章，还是有人发表评论，插件都能根据我们的设置来清理对应的缓存！比如有人发表了一个自动审核通过的评论（或博主审核通过一条评论），插件将会自动删除评论相关的文章缓存，具体看下上图张戈贴出的标注即可。

如何查看插件是否正常工作呢？很简单，勾选开启插件日志，然后去点击更新一篇旧文章，最后打开插件日志即可看到是否删除记录。

用 Linux 的朋友，可以直接使用 tailf 命令查看该日志，然后去更新文章即可看到效果，如下图所示：

至于要证实是否真的删除了缓存，我们可以先打开浏览器的开发者模式，定位到 network 界面，然后访问刚刚更新的文章，即可看到如下状态：

很明显，缓存已被成功删除，首页看都不用看，肯定也是这个状态了。

好了，本文就分享到这，如果对网站缓存感兴趣的朋友，可以继续翻看张戈博客的相关文章：

• WordPress 结合阿里云 OCS 开启高速缓存，优化网站响应速度
• WordPress 评论 ajax 动态加载，解决静态缓存下评论不更新问题
• php 平滑重启 nginx，彻底清除 WordPress 的静态缓存
• WP Super Cache 静态缓存插件纯代码版（兼容多域名网站）
• 解决启用 wp super cache 缓存后，页面追加多个斜杠仍然可以访问的隐患

Ps：当然，东西肯定是越用越好，目前张戈博客也取消了以前的各种缓存，比如 php 代码缓存等。

最后感谢一下在我博客留言告知的【wordpress 优化】站长！总之一句话，如果发现新的 WordPress 折腾目标，你不会折腾的话，可以留言告诉张戈。