前置准备：100%避免更新事故的3项操作
不管自动还是手动更新，必须做3项硬准备，漏做任何一项都可能导致数据丢失或系统崩溃：
- 备份全站数据：登录服务器后台（宝塔/CPanel/主机管家）或本地通过FTP/SFTP工具（FileZilla免费），将网站根目录下所有文件压缩成zip/rar包，同时到EyouCMS后台【系统-系统工具-数据库备份】，点击全选+立即备份，等待备份完成后下载到本地。
- 关闭所有缓存：EyouCMS后台【系统-系统基本参数-性能设置】，将前台页面缓存、数据缓存、模板缓存三个选项的勾全部去掉，点击保存。
- 关闭网站维护模式：先确认维护模式是否开启，若开启状态更新，补丁包文件可能无法正常覆盖后台入口，导致后续无法登录操作。关闭位置在后台【系统-系统基本参数-站点设置】底部，若开启了维护模式，将勾去掉点击保存；若没开启，可跳过此步，但建议临时在维护模式说明框写“系统临时维护中，请稍后访问”，更新完成后再清空。
方法一：EyouCMS后台自动一键更新（官方推荐优先用）
自动更新是最安全、最快的方式，适合服务器配置正常、网络连接EyouCMS官方仓库稳定的用户，步骤如下：
步骤1：检测并查看可用补丁
登录EyouCMS后台，默认首页左侧导航栏顶部会有红色提示气泡（无气泡则无需更新），点击气泡进入【系统-系统升级-升级列表】；也可直接通过路径访问。在升级列表中，官方会按时间倒序展示所有未安装的安全/功能补丁，每个补丁都有补丁说明、适用版本、更新大小三项核心信息。
步骤2：确认适配性后安装补丁
- 适用版本检查：先看每个补丁的适用版本，必须与当前EyouCMS版本完全匹配（当前版本查看位置：后台【系统-系统基本参数-系统信息-系统版本】），比如当前是V1.6.4，就只能安装标注“适用V1.6.4”的补丁，版本不匹配强制安装100%会出问题。
- 逐个或批量安装：适配的单个小补丁可直接点击右侧【立即升级】；批量适配的大补丁（比如季度安全包）可全选后点击底部【批量升级】。
- 等待升级完成：升级过程中会显示“正在下载补丁包”“正在解压”“正在覆盖文件”“正在更新数据库”等进度条，绝对不要关闭页面或刷新，直到弹出“升级成功，点击跳转”的提示框。
步骤3：验证更新结果并恢复缓存
点击提示框跳转后，先查看系统版本是否更新到对应补丁的最新子版本（比如V1.6.4-安全补丁202X0X0X）；再检查网站前台首页、后台核心功能（比如文章发布、会员登录、订单管理）是否正常；确认无误后，重新到【系统-系统基本参数-性能设置】开启之前关闭的三个缓存，清空维护模式说明框。
方法二：本地手动更新（自动更新失败专用）
自动更新失败通常有3个原因：服务器无法连接EyouCMS官方仓库、当前版本被第三方模板/插件修改过核心文件、补丁文件被服务器安全软件拦截，此时必须用本地手动更新，步骤如下：
步骤1：下载适配的官方补丁包
访问EyouCMS官方补丁下载页面：https://www.eyoucms.com/upgrade/，在页面顶部的搜索框输入当前系统主版本号（比如输入1.6.4，不要输入子版本），点击搜索；在搜索结果中找到与后台升级列表一致、适用版本完全匹配的补丁，点击右侧【下载】按钮，下载到本地电脑。
步骤2：检查本地补丁包与网站核心文件的冲突
- 解压本地补丁包：用WinRAR/7-Zip免费工具解压下载的zip包，解压后得到一个以“upgrade_日期”命名的文件夹。
- 对比核心文件哈希值：下载第三方免费哈希值对比工具（比如HashMyFiles），将解压后文件夹里的所有.php/.html/.js/.css核心文件，与服务器根目录下的对应位置文件进行MD5/SHA1对比；如果有哈希值不同的文件，说明当前网站核心文件被修改过，必须先将被修改的文件单独复制一份到本地安全位置（后续补丁覆盖后，需要用对比工具找出差异，手动将第三方修改加回去），如果所有文件哈希值一致，可直接跳过此步。
步骤3：上传并覆盖补丁包文件
- 上传前临时关闭服务器安全软件：宝塔/CPanel/主机管家后台找到对应的安全模块（比如宝塔的【Nginx防火墙】【文件校验】），临时将拦截级别调到最低或暂停10分钟，避免上传/覆盖文件时被拦截。
- 上传补丁文件：通过FileZilla/SFTP工具连接服务器，将解压后“upgrade_日期”文件夹里的所有内容（不要直接传文件夹本身），拖到服务器根目录下（与index.php同级），覆盖所有同名文件（点击“全部是”）。
步骤4：执行数据库升级脚本
上传完成后，不要直接关闭FTP工具，先访问网站后台入口路径+“/upgrade.php”（比如原来的后台是/eyou_admin/，就访问http://你的域名/eyou_admin/upgrade.php）；如果后台入口被修改过（比如改成了/xxx_backend/），就对应修改路径；如果页面显示“没有需要执行的数据库升级”，说明补丁不需要修改数据库，可直接跳转；如果有SQL语句，点击立即执行，直到弹出“数据库升级成功”的提示框。
步骤5：清理临时文件与验证结果
- 删除升级相关文件：用FTP工具删除服务器根目录下的upgrade_日期.zip（如果之前直接传了压缩包）和upgrade.php，这两个文件留着会有安全隐患。
- 恢复第三方修改的核心文件：如果之前有被修改的核心文件，用对比工具对比本地备份的修改版和服务器上的补丁版，找出差异，手动将第三方修改（比如自定义的会员验证逻辑、插件挂载代码）加回去，每次修改后保存并刷新网站验证功能是否正常。
- 验证全站与恢复安全设置：验证步骤同方法一的步骤3；验证完成后，重新开启服务器安全软件的拦截级别，删除本地临时备份的哈希值对比文件。
常见问题快速解决
- 问题1：自动更新提示“下载补丁失败”：检查服务器是否能访问外网（在服务器后台ping www.baidu.com或ping www.eyoucms.com，看是否有丢包），如果能访问外网但不能访问EyouCMS仓库，换方法二手动更新。
- 问题2：更新后前台或后台空白：第一时间恢复前置准备中备份的全站文件和数据库，然后检查第三方模板/插件是否与补丁冲突，逐个禁用插件、切换默认模板测试。
- 问题3：更新后会员或订单数据丢失：第一时间恢复数据库备份（文件不用恢复），EyouCMS官方补丁不会删除业务数据，丢失通常是因为覆盖了错误的数据库表或备份时未全选。
