在线升级

能做什么

KingCMS X1 可以在后台检查新版本，并一键升级到新版本。升级前会自动备份代码和数据库，升级失败会自动回滚，网站不会停在半截状态。

进入检查升级

打开左侧菜单「系统设置 → 检查升级」（/admin/about）。页面会显示当前版本、上次检查时间，以及系统升级区域。

检查升级页所有管理员都能打开，但系统升级区域和升级操作只对超级管理员显示和开放。

原来的 /admin/settings/system/upgrade 地址会自动跳转到 /admin/about。

检查更新

1. 点「立即检查更新」。
2. 页面显示上次检查时间。发现新版本时，会显示新版本号、发布时间和更新说明；没有新版本时显示「当前已是最新版本」。
3. 系统定时任务每天自动检查一次。自动检查只读取版本信息，不会自动升级。

如果提示「未配置升级公钥，无法在线升级」，需要先由服务器管理员配置升级公钥，配置前不能在线升级。

一键升级

开始前先看页面上的警告：

• 如果提示某些目录或文件不可写，在线升级会失败。先按提示调整代码目录和 data 目录的写权限，再重新检查。
• 升级期间网站会暂时停止对外访问，建议在访问低峰时操作。

步骤：

1. 确认页面显示有新版本，并阅读更新说明。
2. 点「一键升级」，在确认框里确认。
3. 页面显示「升级进度」，每 3 秒自动刷新。进度里会显示目标版本、当前步骤和「执行记录」。
4. 升级过程依次包括：校验升级公钥、下载升级包、校验 sha256、校验签名、环境检查、解压、检查写入权限、备份代码和数据库、检查主题文件、进入维护模式、覆盖文件、执行数据库迁移、清理缓存、退出维护模式、升级完成。
5. 状态变为「升级完成」后，前台恢复访问。刷新后台页面确认版本号已经变化。

升级失败怎么办

• 系统会自动回滚代码和数据库，并退出维护模式，进度里显示「升级失败」和「已自动回滚代码和数据库」。
• 如果自动回滚失败，网站会保持维护模式，执行记录里会给出人工恢复的目录和文件。按记录恢复后，再点页面上的「解除维护」。
• 如果升级进程已经结束，但页面仍显示「站点仍处于维护模式」，先确认升级已经停止，再点「解除维护」并确认。

国家数据

「国家数据」区域显示当前数据版本，与系统升级分开更新：

1. 在「系统升级」区域找到「国家数据」。
2. 点「更新国家数据」并确认。系统从升级服务器下载最新的国家数据文件并校验 hash。
3. 成功后提示「国家数据已更新到 <版本>」；失败时显示失败原因。

不需要升级 KingCMS 本体时，也可以单独更新国家数据。

主题文件

• 升级会检查当前主题文件是否被修改过。被修改过的主题文件不会被新版本覆盖，原文件会备份到数据目录，执行记录里会写明保留的路径和备份位置。
• 如果当前版本没有主题清单，系统无法判断文件是否被修改，会先把主题文件全部备份，再用新版本覆盖。

因此，用「模板在线编辑」发布过修改的主题，升级后需要重新检查前台效果；被保留文件的备份路径会写在执行记录里。

升级设置

打开「系统设置 → 设置 → 安全与系统 → 升级设置」（/admin/settings/system/update）：

修改升级服务器后，重新回到「检查升级」页点「立即检查更新」验证是否可用。

当前版本：X1.0.0-beta.3。升级前建议先了解备份，升级后如需调整站点可参考初始设置。