ZBlog程序静态缓存功能的开启与基础设置实操指南

一、前置条件确认

当前仅支持ZBlog PHP 1.5及以上版本开启静态缓存，若使用更低版本，请先通过后台【系统升级】功能升级至最新正式版。同时需准备FTP工具或主机在线文件管理器，确保具备ZBlog根目录的文件读写权限。

二、核心操作步骤

1. 登录ZBlog后台

直接访问后台登录地址：你的域名/api/zb_system/login.php，替换“你的域名”为实际站点域名，例如站点为https://www.example.com，登录地址即对应上述格式，输入管理员账号密码完成登录，请勿在公共网络泄露登录信息。

2. 安装并启用静态缓存官方插件

• 登录后点击左侧菜单栏【插件管理】；
• 在插件列表顶部搜索框输入“静态缓存”，找到作者为“ZBlog官方团队”的【静态缓存插件】，请勿使用第三方非官方插件；
• 点击插件右侧【安装】按钮，页面提示“安装成功”后，点击【启用】按钮。

3. 配置静态缓存关键参数

启用插件后，点击左侧菜单栏【插件】→【静态缓存设置】进入配置页面，以下参数需严格设置：

• 静态缓存有效期：设置为86400（单位秒，对应1天；若每周仅更新1次内容，可调整为604800即7天）；
• 静态缓存存储路径：默认值为/cache/static/，若该目录不存在，需通过FTP在ZBlog根目录手动创建“cache”文件夹，再在cache下创建“static”子文件夹，设置两个文件夹权限为755；
• 需缓存的页面类型：勾选【首页】【分类页】【文章页】【标签页】，取消勾选【搜索页】【404页】（这两类页面动态性强，不适合缓存）；
• 缓存清除方式：勾选【自动清除（发布文章/修改评论时）】，无需手动清理旧缓存，避免操作失误。

所有参数设置完成后，点击页面底部【保存设置】按钮。

三、验证配置是否生效

1. 手动生成静态缓存文件

回到静态缓存设置页，点击页面上方【生成静态缓存】按钮，等待页面提示“静态缓存生成完成”。通过FTP工具进入/cache/static/目录，可查看生成的对应页面静态文件，例如首页为index.html，文章页为post-123.html（123为文章ID）。

2. 实际访问测试

打开无痕浏览器窗口访问博客首页，按F12打开开发者工具【网络】面板，查看首页加载时间，对比开启静态缓存前的测速结果，加载速度应提升30%以上。同时尝试发布新文章，1分钟后查看/cache/static/目录，会自动生成对应文章的静态文件，旧缓存也会自动清除，说明配置生效。

四、常见问题快速排查

1. 静态缓存无法生成

首先检查/cache/static/目录权限是否为755，若不符，通过FTP右键文件夹设置权限为755；其次确认静态缓存插件已启用，未启用则重新执行安装启用步骤；最后排查插件冲突，暂时禁用所有非官方插件后重试。

2. 修改文章后页面不更新

检查【静态缓存有效期】是否设置过长，若超过7天，缩短有效期后重新生成缓存；部分版本插件在编辑文章时需勾选【更新缓存】选项，若未勾选，重新编辑文章并勾选后发布即可。

3. 静态缓存占用磁盘空间过大

每月通过静态缓存设置页的【清除过期缓存】按钮，清理超过有效期的旧缓存，避免不必要的空间占用。