宝塔面板中页面缓存需通过“网站→设置→反向代理”启用并手动配置proxy_cache规则,而非静态文件缓存或CDN回源开关;关键在正确设置proxy_cache_key、忽略Set-Cookie与Cache-Control,并排除动态路由。

宝塔面板里哪个开关管页面缓存
页面缓存不是靠“网站设置”里那个“静态文件缓存”开关——它只管 .js、.css、.png 这类资源,不缓存 HTML 本身。真要缓存动态生成的页面(比如 WordPress 首页、Typecho 文章页),得用 Nginx 的 proxy_cache 或 Apache 的 mod_cache,而宝塔默认只暴露了前者配置入口。
实操路径是:网站 → 设置 → 反向代理 → 开启反向代理 → 在配置框里手写缓存规则。别点“缓存”选项卡里的“开启缓存”,那个是给 CDN 回源用的,对本地页面无效。
- 必须先启用反向代理(哪怕没真实后端,指向本机
127.0.0.1:8080也行) - 缓存目录默认在
/www/server/nginx/proxy_cache_dir,确保磁盘有空间且 Nginx 有写权限 - 宝塔 8.x 后版本才支持在反代配置里直接加
proxy_cache块,老版本需手动改nginx.conf
缓存 HTML 页面必须写的 Nginx 配置片段
光开开关没用,关键在配置里是否命中响应头和 URL 规则。常见错误是缓存了带 Cookie 的页面,导致用户 A 看到用户 B 的后台页。
以下是最简可用的 location 块(贴进反向代理配置框):
proxy_cache cache_one; proxy_cache_valid 200 301 302 10m; proxy_cache_valid any 1m; proxy_cache_key $scheme$host$request_uri$is_args$args; proxy_ignore_headers Cache-Control Expires Set-Cookie; proxy_hide_header X-Powered-By;
-
proxy_ignore_headers Cache-Control:强制忽略 PHP 输出的Cache-Control: no-cache,否则缓存永远不生效 - 删掉
Set-Cookie是必须的——否则登录态、购物车会串,尤其 WordPress 必须加这行 -
$request_uri$is_args$args比$uri更准,能区分/post/123和/post/123?utm_source=weibo
为什么刷新页面没变 / 缓存不更新
不是缓存没起作用,而是你触发了 Nginx 的“缓存穿透”保护:当后端返回 502/504 时,Nginx 默认会把旧缓存继续吐给用户,造成“页面卡在旧状态”。另外,proxy_cache_valid 时间一过,Nginx 不会主动删缓存,而是等下次请求时发现过期再回源校验(叫 stale),所以你看到的“没更新”其实是 stale 响应。
- 临时清缓存:运行
rm -rf /www/server/nginx/proxy_cache_dir/*,然后nginx -s reload - 想让更新立刻生效,加
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504; - 开发调试时,在浏览器地址栏加
?t=xxx参数,因为$request_uri包含参数,就绕开了缓存键
WordPress / Typecho 等 CMS 的特殊注意点
这类程序常在 HTML 里硬编码时间、随机数或用户 ID,缓存后所有用户看到同一份 HTML,结果首页显示“欢迎,张三”,但李四打开也是“张三”。
根本解法不是关缓存,而是拆分动态块:
- 用
ngx_http_sub_module替换 HTML 中的用户名(需编译进 Nginx,宝塔默认不含) - 更现实的做法:用插件(如 WP Super Cache)做服务端页面缓存,它生成真实
.html文件,不依赖 Nginx proxy_cache - 如果坚持用宝塔 proxy_cache,至少把用户相关路由排除,例如加
location ~ ^/(wp-admin|wp-login\.php|wp-json) { proxy_cache off; }
缓存 HTML 最容易翻车的地方,从来不是配置写错,而是没意识到“页面内容是否真的可缓存”。一个 Set-Cookie 头、一段 JS 时间戳、一次未声明的 AJAX 请求,都可能让缓存变成定时炸弹。

















