AnqiCMS 2.x 版本平滑升级到 3.x 版本的详细指南
作为一名资深的安企CMS运营人员，我深知每一次版本升级对于网站的稳定运行和内容管理效率至关重要。AnqiCMS 从 2.x 升级到 3.x 版本，不仅带来了性能上的优化和功能上的增强，更在系统部署和多站点管理方面进行了革新，特别是通过“Go项目”管理方式，使得系统的维护更为简洁高效。本篇文章旨在为您提供一个清晰、详尽的升级路径，确保您的网站能够平稳过渡至 3.x 新版本。
升级前的周全准备
在着手进行任何系统升级之前，最核心的原则就是“数据无价，备份先行”。请务必对您的现有 AnqiCMS 2.x 版本进行彻底的备份。
首先，请完整备份您的数据库。您可以使用宝塔面板等服务器管理工具提供的数据库备份功能，或者通过命令行导出 SQL 文件。
其次，全量备份您的网站文件。这包括 AnqiCMS 的程序文件、上传的图片、自定义模板以及所有配置相关的文件。您可以直接打包整个网站根目录，以防万一。
完成备份后，建议您花些时间审视当前 2.x 版本的运行环境。虽然 3.x 版本在架构上有所优化，但确保您的服务器资源充足，例如内存和磁盘空间，仍是保障升级后系统流畅运行的基础。
理解版本间的差异也是平滑升级的关键。AnqiCMS 3.x 引入了对宝塔面板“Go项目”的官方支持，这大大简化了程序的部署和运行管理。同时，您需要特别留意在 2.1.1 版本中已经进行的模板标签重构，即移除了原有的 article/product 标签，新增了 archive 标签。这意味着如果您有定制化的前端模板，它们很可能需要进行相应的修改以兼容 3.x。
核心升级流程：逐站迁移
AnqiCMS 3.x 版本的设计理念是实现多站点统一管理，而非像 2.x 那样需要为每个站点部署独立的程序副本。因此，升级过程将分为主站点升级和多站点整合两个阶段。
第一步：选择并升级主站点
在您的服务器上，选择一个当前正在运行的 AnqiCMS 2.x 实例作为您的主站点（即您通常登录后台管理多站点的那个实例）。登录其后台管理界面，通过“系统升级”功能将其升级到最新的 3.x 版本。这一操作将更新程序的底层文件。
第二步：平稳过渡主站点运行环境
完成后台升级操作后，新版本的文件已经部署，但程序可能仍在使用旧的进程。此时，您需要通过原来 2.x 版本为该站点配置的计划任务（例如 start.sh 脚本），尝试执行一次重启操作，以确保新版本程序被正确加载。
如果在重启后，您访问后台发现界面或版本号并未更新至 3.x，这可能是由于浏览器缓存或旧进程未能完全停止导致。您可以尝试在浏览器中强制刷新（通常是 Ctrl+F5 或 Shift+F5）来清除缓存。如果问题依旧，则需要手动干预：首先通过命令行或服务器管理工具查找并终止旧的 AnqiCMS 进程（例如在 Linux 下使用 lsof -i:{端口号} 查找进程 ID，再用 kill -9 {PID} 终止），然后再次执行您原有的计划任务脚本来启动 AnqiCMS。
第三步：切换至 Go 项目管理模式
当主站点确认已升级到 3.x 并正常运行后，您可以开始优化其运行管理方式。首先，停止并删除该主站点在 2.x 版本中配置的计划任务。
接下来，如果您使用的是宝塔面板，请前往“网站”菜单下的“Go项目”功能。点击“添加Go项目”，按照 3.x 版本的部署指南配置您的主站点。项目的执行文件应指向您已升级的 AnqiCMS 可执行文件（例如 /www/wwwroot/anqicms.com/anqicms），项目端口填写您 AnqiCMS 默认或已配置的端口（例如 8001）。由于您的数据已通过后台升级完成，此处添加 Go 项目并不会触发初始化步骤，而是直接接管运行。
第四步：多站点合并与优化
对于同一台服务器上原来独立部署的 AnqiCMS 2.x