适用于 1.1.0 · Build 404。版本号与 Build 共同标识当前程序,后台“系统更新”可查看本机版本、可用新版及更新说明。
选择正确的包
| 文件 | 用途 |
|---|---|
| 全新部署包 | 新建站点、首次安装 |
| 热更新包 | 已有站点升级,按后台更新功能及随包说明使用 |
| 版本校验文件 | 核对对应 ZIP 的 SHA-256,确认下载完整 |
| 交付报告 | 查看版本、包信息与验证范围 |
| 升级内容说明 | 查看本次功能变化、修复与注意事项 |
不要用全新部署包直接覆盖生产站点来代替热更新,也不要混用不同 Build 的文件。
更新前准备
- 完整备份数据库、站点配置、上传文件及自定义插件、主题。
- 确认备份可恢复,并记录当前版本与备份时间。
- 查看更新内容和适配要求,在独立测试环境验证重要扩展。
- 确认磁盘空间、站点写权限、出站网络及安全运行组件正常。
- 选择业务低峰执行,避免多人同时发起更新。
检查与执行
进入后台 系统更新,检查可用版本并阅读更新内容。确认后使用页面提供的更新操作,更新过程中会显示阶段、进度和日志。
- 查看下载、校验、应用、迁移等当前阶段。
- 进度在局部刷新,不需要反复重新提交更新。
- 页面刷新或短暂断网后,重新进入更新页查看任务状态。
- 以最终成功/失败结果和升级记录为准,不能只凭进度百分比判断完成。
如果进度暂时不动,先检查最新日志及更新时间。不要重复点击更新、强行覆盖文件或在任务运行中删除运行目录。
强制更新提示
系统会定期检查强制更新,管理员进入后台时会收到对应提示。每 10 分钟检查、零点执行依赖服务器计划任务与正确时区;普通更新不会因为到了零点就自动安装。
请核对站点计划任务已按部署提示注册并正常执行。未配置任务或任务执行失败时,不能假定关掉浏览器后仍会自动完成更新;应及时处理通知并检查更新记录。
更新后核对
- 当前版本与目标 Build 一致,升级历史显示结果。
/home、/store、/login、/register、会员中心与自定义后台入口正常。- 站点名称、Logo、主题内容、商品与公告没有被旧缓存覆盖。
- 支付通知、邮件测试、工单附件及业务任务正常。
- 运行组件在网页检测中可用;若换过 PHP 版本,执行对应安装命令并复检。
Build 404 的官方下载源为 http://kededl.mercuryseek.cn/。安装组件时优先复制当前安装向导生成的命令,避免沿用旧版本命令中的校验值。
失败与恢复
| 情况 | 建议 |
|---|---|
| 下载或完整性校验失败 | 检查网络、包版本与校验文件,使用官方包重试;不要跳过校验 |
| 文件无法写入 | 检查运行用户权限、磁盘空间及安全策略 |
| 接口返回页面而非 JSON | 检查回源、伪静态、PHP 转发和缓存,详见故障处理 |
| 更新接近完成时页面无响应 | 重新进入更新页查看当前任务和日志,确认任务结束后再决定后续操作 |
| 数据迁移失败或页面异常 | 保留错误时间和日志,避免反复覆盖;联系支持确认恢复方案 |
后台提供的程序备份回滚不等于数据库恢复。若更新已修改数据结构,应使用同一时间点的数据库、配置与文件备份配套恢复。回滚前也应备份更新后新产生的数据,避免丢失订单或支付记录。