平滑升级 pbootCMS 的核心在于先完整备份数据库和配置文件，再覆盖核心代码，最后通过后台触发数据库更新脚本。
先说结论：升级前必须全量备份，覆盖文件时避开配置和上传目录，升级后务必清理缓存。
- 适合：需要修复漏洞、获取新功能或解决已知 Bug 的现有站点。
- 先准备：完整的文件包、数据库备份文件、测试环境（可选但推荐）。
- 验收：后台版本号变更、前台页面正常显示、核心功能（搜索、表单）可用。
- 保底：保留备份文件直至确认升级稳定，以便随时回滚。
命令速用版
如果你熟悉服务器命令行，可以用以下命令快速完成备份与恢复操作，减少手动失误：
cd /www/wwwroot/your_site # 备份整个站点目录 tar -zcf backup_$(date +%F).tar.gz . # 备份数据库（假设使用 MySQL） mysqldump -u 用户名 -p 数据库名 > backup_db_$(date +%F).sql # --- 升级失败恢复命令 --- # 恢复文件 tar -zxf backup_YYYY-MM-DD.tar.gz # 恢复数据库 mysql -u 用户名 -p 数据库名 < backup_db_YYYY-MM-DD.sql
注意：命令中的路径、用户名、数据库名需替换为实际值，恢复前请确保服务正常。
分步处理
1. 全量备份与配置锁定（止血步骤）
在操作前，通过 FTP 或服务器命令下载整个网站目录，并导出当前数据库。这是升级失败后能恢复的唯一保障。
为防止配置文件被误覆盖，建议先锁定配置：chmod 444 config/config.php
2. 下载最新安装包
前往 pbootCMS 官方渠道下载最新版本的源码包。不要使用第三方修改版，以免引入未知风险。
3. 覆盖核心文件
解压安装包，将除了以下目录外的文件上传覆盖到服务器：
- config/：包含数据库连接信息，必须保留原版。
- upload/：包含用户上传的图片附件，覆盖会导致历史图片丢失。
- runtime/：运行缓存，建议清空而不是覆盖。
4. 触发数据库更新
登录后台，系统通常会自动提示数据库需要升级。如果没有提示，可尝试访问 /index.php?tag=database 或查阅官方文档获取具体更新入口。执行完成后请删除或保护该入口。
5. 清理缓存与权限修正
在后台点击“清理缓存”，或者手动删除 runtime/ 目录下的所有文件。
检查目录权限，确保 Web 服务可写：
chmod -R 755 runtime/ chmod -R 755 upload/
升级失败回滚方案
如果升级后出现白屏、数据库错误等功能异常，请立即执行回滚：
1. 恢复文件
将之前备份的压缩包解压覆盖回网站根目录，或使用上述 tar 命令恢复。
2. 恢复数据库
使用备份的 SQL 文件导入数据库，覆盖当前数据。
3. 清理缓存
删除 runtime/ 下所有文件，确保旧版本代码正常运行。
怎么验证是否生效
1. 检查版本号
登录后台，查看底部或系统信息处的版本号是否已变为最新。
2. 前台页面检查
打开首页、列表页、详情页，确认排版正常，图片加载无误。
3. 功能测试
测试搜索功能、表单提交、留言功能等交互模块，确保没有报错。
4. 查看日志
检查 runtime/logs/ 下的日志文件，确认没有频繁的 PHP 错误或数据库连接错误。
常见坑
1. 误覆盖配置文件
这是最致命的问题。一旦 config/ 被新版本覆盖，数据库连接信息会变回默认，网站直接打不开。务必在覆盖前锁定或跳过此目录。
2. 权限问题
升级后，部分新文件或目录可能权限不足，导致无法写入缓存或上传文件。检查 runtime/ 和 upload/ 目录权限，建议设置为 755，所属用户组需与 Web 服务一致，避免使用 777。
3. 浏览器缓存干扰
有时候升级完了页面还是旧的，是因为浏览器缓存了静态资源。尝试强制刷新页面或清理浏览器缓存。
4. 插件兼容性
如果安装了第三方插件，升级核心后插件可能失效。建议先确认插件是否支持新版本，必要时暂时禁用插件。