静态页面缓存
静态页面缓存
静态页面缓存用于把首页、列表页、详情页缓存为静态文件,加快访问速度,并支持推送到静态站点服务器。
入口路径
后台顶部菜单 →「功能」→「系统功能」→「静态页面缓存」。实际地址:/system/plugin/system/htmlcache,需要管理员权限(canAdmin)。
功能说明
页面可设置缓存总开关、首页/列表/详情缓存时间、静态网站服务器与静态网站地址,并提供生成与推送操作。
界面截图

设置项说明
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 是否开启静态页面缓存 | 缓存总开关 | radio:关闭(实测默认)/ 开启 [实测] | 访问量大且更新不频繁时开启 | 关闭后以下缓存设置不生效 |
| 首页缓存时间 | 首页缓存秒数 | 数字,实测 300 秒 [实测];0 表示不缓存 | 首页更新少可设 300–3600 | — |
| 列表缓存时间 | 列表页缓存秒数 | 数字,实测 3600 秒 [实测];0 表示不缓存 | 列表更新中等设 3600 | — |
| 详情缓存时间 | 详情页缓存秒数 | 数字,实测 86400 秒 [实测];0 表示不缓存 | 详情几乎不变可设 86400 | — |
| 静态网站服务器 | 静态文件推送目标 | 单选 9 项:关闭(实测默认)/ 阿里云/腾讯云/七牛云/又拍云/谷歌云/亚马逊S3/FTP/SFTP [源码+实测] | 需要纯静态站时选择 | 非 VIP 不可选;无本地选项 |
| 静态网站地址 | 静态站访问地址 | 文本,无默认 [源码] | 填静态站域名 | — |
配置项详解
静态网站模式的影响
出现条件:静态网站服务器不为「关闭」时 [源码]。
启用静态网站后,搜索、留言、评论、301 跳转等需要提交数据到后台的功能均失效,网站退化为纯展示 [源码+i18n]。
前置条件:需要自适应模板,且必须先开启静态页面缓存。
填错后果:误启用会导致全部交互功能不可用。
手动生成缓存
出现条件:始终显示 [源码]。
提供「清理所有缓存」「手动生成所有缓存/首页/栏目/文档/标签缓存」等操作 [源码]。
注意:调整模板、修改全局/内容/联系方式/导航设置、修改伪静态规则后,不会自动重新生成静态页,必须手动生成 [源码+i18n]。「清理所有缓存」只清服务器本地缓存,无法清静态服务器文件 [源码]。
操作步骤
- 进入「功能 → 系统功能 → 静态页面缓存」。
- 开启缓存并设置各类页面缓存时间。
- 点击「提交」保存。
- 使用「生成操作」手动生成缓存,或「清理所有缓存」。
- 需要静态站时配置服务器并执行推送。
操作步骤
- 进入「功能 → 系统功能 → 静态页面缓存」。
- 开启缓存并设置各类页面缓存时间。
- 点击「提交」保存。
- 使用「生成操作」手动生成缓存,或「清理所有缓存」。
- 需要静态站时配置服务器并执行推送。
适用场景与建议
- 访问量大、内容更新不频繁的站点适合开启缓存。
- 生成操作支持按首页、栏目、文档、标签分别生成,便于局部更新。
注意事项
- 启用静态网站后,搜索、留言、评论、301跳转等需要提交数据的功能会失效,站点仅剩展示能力。
- 修改模板、全局设置、内容设置、导航、伪静态规则后,不会自动生成静态页,需手动重新生成。
- 静态网站需要自适应模板,且必须先开启静态页面缓存。