各位同仁，作为一名长期奋战在AnQiCMS一线的网站运营人员，我深知内容管理系统的稳定与高效对业务发展的重要性。最近，不少运营伙伴在咨询AnQiCMS从2.x版本升级到3.x版本，特别是涉及多站点数据迁移的推荐方案。今天，我将结合我们的实践经验和AnQiCMS的最新文档，为大家详细解读这一过程，确保您的多站点平稳过渡。
AnQiCMS 3.x版本在架构和功能上进行了显著优化，尤其在部署简易性和多站点管理方面有了质的飞跃。相较于2.x版本较为复杂的独立部署模式，3.x版本通过Go项目管理和统一的多站点后台，大大降低了运维成本，提升了整体安全性与运行效率。因此，这次升级不仅仅是版本迭代，更是对您内容管理策略的一次优化。
升级主AnQiCMS实例
多站点升级的第一步是处理您目前部署的AnQiCMS主实例。这个主实例通常是您最先安装、或拥有多站点管理权限的站点。
首先，请您登录到这个主站点的后台管理界面。在后台的系统升级功能中，将AnQiCMS程序升级到最新的3.x版本。完成程序升级后，由于2.x版本通常依赖计划任务来维持运行，您需要通过原有的计划任务脚本（例如start.sh）来执行一次重启操作，以确保升级后的程序能够正常启动。如果重启后后台版本信息未能及时更新，请尝试清理系统缓存或检查日志文件进行排查。
接下来，我们将这个主实例转换为3.x版本推荐的“Go项目”部署模式。您需要停止并删除2.x版本对应的计划任务。然后，按照AnQiCMS 3.x的安装指南，在您的服务器管理面板（如宝塔面板）中，将这个AnQiCMS实例添加为一个Go项目。在配置Go项目时，务必选择指向您现有AnQiCMS安装目录下的anqicms可执行文件，并使用您当前站点正在监听的端口（通常是8001）。通过这种方式，新部署的3.x版本将直接继承您现有站点的配置和数据，无需重新进行初始化安装。
将现有子站点整合到3.x多站点管理体系
完成主AnQiCMS实例的升级和部署模式转换后，我们就可以着手处理其余的2.x版本子站点了。在3.x版本中，所有的子站点都将由同一个AnQiCMS实例进行统一管理，这极大地简化了多站点架构。
对于每个原有的2.x子站点，您首先需要停止并删除其对应的计划任务。然后，登录到您已升级完成的3.x主AnQiCMS实例的后台，进入“多站点管理”功能，点击“添加新站点”。
在添加新站点的界面中，这是数据迁移的关键步骤。请您仔细填写各项信息：
- 站点名称：根据子站点的实际用途进行命名，方便您在后台区分。
- 站点根目录：这里需要填写原有2.x子站点的物理根目录路径。例如，如果原站点文件在
/www/wwwroot/sub.anqicms.com/，您应填写/www/wwwroot/sub.anqicms.com，以便新站点能够识别并使用旧有的静态资源和文件结构。 - 网站地址：填写您子站点的域名，确保域名已经解析并绑定到服务器上。
- 管理员账号和密码：为新站点设置独立的后台管理账号和密码。
- 数据库名称：请填写原有2.x子站点使用的数据库名称。
- 数据库信息复用：如果您原有2.x子站点和主实例共用数据库账号，可以选择复用。如果数据库账号独立，请如实填写。
关键在于，通过指定原有的根目录和数据库信息，AnQiCMS 3.x在创建新站点时，将自动识别并继承原2.x子站点的所有数据，包括文章、分类、页面、设置等。这样，原有的子站点数据就完成了无缝迁移，无需额外的导入导出操作。新站点将不会进入初始化安装步骤，而是直接加载您旧有的内容。
最后一步是为新整合的子站点配置反向代理。在您的Web服务器（如Nginx或Apache）中，为子站点的域名添加反向代理配置，将其流量代理到您3.x主AnQiCMS实例监听的端口（例如，8001）。确保Web服务器的运行目录配置指向子站点根目录下的/public文件夹。这样，外部用户访问子站点域名时，请求将通过反向代理正确地路由到AnQiCMS 3.x实例，并由其处理并展示对应站点的内容。
迁移后的验证与优化
完成所有子站点的迁移和配置后，务必对每个站点进行全面的访问测试。
- 验证前台页面是否正常显示，包括首页、文章列表、详情页、单页面等。
- 登录每个子站点的后台，检查内容、分类、标签等数据是否完整，各项功能（如发布、编辑、SEO设置）是否运行正常。
- 确认伪静态规则是否生效，URL结构是否与预期一致。
- 检查模板文件是否正确加载，尤其是在2.x版本中可能存在一些自定义模板路径的站点。3.x版本模板机制更加规范，可能需要根据
design-convention.md和design-director.md进行微调。
通过将所有站点统一到AnQiCMS 3.x的多站点管理模式下，您将能够在一个后台界面高效地管理所有站点的内容和配置，同时享受3.x版本带来的性能和安全提升。
常见问题解答
AnQiCMS 2.x升级3.x多站点迁移方案有哪些主要优势？
AnQiCMS 3.x的多站点管理模式允许所有站点在同一套程序下运行，并通过统一的后台界面进行管理。这大大简化了部署复杂度，减少了资源占用，并使后续的系统更新和维护变得更加便捷和高效。此外，3.x版本基于Go语言的高并发特性，也为站点带来了更好的性能表现和安全性。
在将2.x子站点整合到3.x多站点管理体系时，我的数据是否会丢失？
不会。AnQiCMS 3.x设计了无缝继承机制。在您添加新站点时，只要正确填写了原有2.x子站点的物理根目录和数据库信息，系统就会自动识别并加载旧有的所有内容和设置。因此，您的文章、分类、页面等关键数据都将得到完整保留和迁移。
如果我在2.x版本有自定义开发的模板，在3.x版本中可以直接使用吗？
由于AnQiCMS 3.x在模板标签和结构上可能存在一些调整，虽然其模板引擎语法（类似Django模板）保持一致，但一些旧版模板文件可能需要进行少量修改以适应新的数据模型和标签用法。您需要参考design-convention.md、design-director.md和tag-*.md等文档，对照更新模板代码，以确保其在3.x环境下正常运行和显示。