Nginx开启fastcgi_cache缓存加速，支持html伪静态页面
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 张戈博客
# 文章地址：http://zhangge.net/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 zhangge.net;
index index.html index.htm index.php default.html default.htm default.php;
#请修改为自己网站的存放路径
root /home/wwwroot/zhangge.net;
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/zhangge.net.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 折腾目标，你不会折腾的话，可以留言告诉张戈。