前台页面缓存与 CDN
校对日期:2026-10-30。适用于社区版及全部商业版。
前台页面(首页、栏目页、文章页、标签页、搜索页、会员主页)由模板按访问者的登录状态实时渲染:登录后页头显示会员菜单, 文章页显示评论框以及关注、收藏状态。因此系统只允许访问者自己的浏览器缓存这些页面,不允许 CDN、反向代理等共享缓存 保存;登录后访问的页面则完全不缓存。本文说明响应头约定、CDN 与反向代理的配置要求,以及"登录后仍显示未登录"的排查方法。
一、响应头约定
| 请求 | Cache-Control | 说明 |
|---|---|---|
| 未登录访问首页、栏目页、文章页、标签页、搜索页、会员主页(含子目录站点) | private, max-age=,并带 Vary: Cookie | 浏览器缓存 5 分钟;登录、登出后 Cookie 变化,浏览器自动重新获取;共享缓存不保存 |
| 已登录(含"记住我"、模板预览)访问上述页面 | no-store | 任何缓存都不保存 |
/sitemap*.xml、/rss、/robots.txt、/llms.txt | public, max-age= | 内容与访问者无关,CDN 可缓存 1 小时 |
登录、注册、会员中心、接口(/api/、/frontend/)、后台(/cp/)、草稿预览、主题预览、非 GET 请求 | no-store | 不缓存 |
主题静态资源、/static/、/uploads/、后台静态文件 | 应用自身不设置缓存时间(当前为 no-store) | 由 Nginx 或 CDN 按目录、后缀规则设置缓存时间(演示站由 Nginx 设置:js / css 12 小时、图片 30 天),见“CDN 与反向代理的配置要求”一节 |
静态化生成的 HTML 文件由 Nginx 等 Web 服务器直接提供,不受以上约定影响。
二、CDN 与反向代理的配置要求
- 节点缓存策略选择遵循源站 Cache-Control(腾讯云 EdgeOne 的「站点加速 → 节点缓存 TTL → 遵循源站 Cache-Control」, 阿里云、Cloudflare 等有同类选项)。按上表约定,CDN 会自动缓存订阅源,不缓存页面与接口,无需再为页面单独设置规则。
- 静态资源按路径或后缀单独设置缓存时间。Nginx 直接提供
themes/、uploads/等目录下的文件时,用expires规则即可 (宝塔面板默认的 js / css 12 小时、图片 30 天就够用,CDN 会遵循);文件由应用提供时,用 CDN 规则引擎对/themes/、/static/、/uploads/、/cp/assets/等目录设置节点缓存 TTL(例如 12 小时)。规则只匹配这些目录或后缀,不要匹配页面路径或整个站点。 - 不要用规则引擎对 HTML 页面强制设置缓存时间,也不要忽略源站的
private/no-store。否则登录用户会拿到匿名访客的页面, 甚至有登录用户的页面被缓存后发给其他访客的风险。 - 如需进一步减轻源站压力,可对
/sitemap*、/rss设置更长的缓存时间;页面请使用静态化功能,不要在 CDN 上缓存动态页面。 - 反向代理(Nginx
proxy_cache、Varnish 等)同样以源站响应头为准。Nginx 默认不缓存带private/no-store的响应, 不要配置proxy_。ignore_ headers Cache-Control
三、排障:登录后页面仍显示未登录状态
现象:登录后仍提示"请登录后发表评论"、页头头像为匿名,刷新无效,过几分钟或换一篇文章又正常。原因几乎都是中间的缓存保存了页面。 检查方法:
bash
curl -sI https://www.example.com/article/1 | grep -i -E 'cache-control|vary|cache-status|age'cache-control应为private, max-age=,并带300, must-revalidate vary: Cookie。若显示public,说明 CDN 或代理改写了响应头。- 页面的 CDN 命中状态(EdgeOne 为
eo-cache-status,其他厂商多为x-cache)应为MISS或DYNAMIC,连续请求不应出现HIT;主题资源应为HIT。 - 带登录 Cookie 再请求一次,
cache-control应为no-store。