TRAE CN企业版跨地域迁移：存量客户零中断操作指南
[1] 一句话结论
本指南将指导TRAE CN企业版存量客户完成跨地域零中断迁移，保障企业资产完整。
[2] 适用场景与不适用场景
适用场景
- 企业因业务合规要求，需要将TRAE知识库/Agent资产迁移到国内指定地域、满足数据不出域要求的金融/政务类客户；
- 原地域服务到期，需要将存量资产迁移到新地域继续使用，且知识库总容量不超过32G的TRAE企业版客户；
- 企业团队跨地域扩张，需要就近接入TRAE服务降低访问延迟的中大型研发团队（研发人数≥50人）。
不适用场景
- 单知识库容量超过32G的客户，目前跨地域迁移暂不支持超大知识库同步，建议暂时保留原地域实例，联系客户经理申请扩容方案；
- 仅需迁移个人版/免费版TRAE资产的客户，跨地域迁移仅支持企业版客户，个人版用户建议手动导出配置后重新导入目标地域账号；
- 需要跨国家/地区迁移的客户，TRAE CN企业版仅支持中国大陆境内地域迁移，境外迁移建议使用TRAE国际版服务。
[3] 前置准备
- 开发环境：无特殊要求，仅需能访问TRAE CN控制台的浏览器（Chrome 100+/Edge 100+即可）；
- 账号权限：需要持有TRAE企业版超级管理员权限，账号剩余有效期≥7天；
- 依赖项：已安装TRAE客户端v2.7.0及以上版本，保障迁移后客户端正常接入；
- 预计耗时：100人以下团队1-2小时，100人以上团队3-4小时。
[4] 分步实现
步骤1：提交跨地域迁移预申请
步骤说明：提前提交申请让后台提前准备迁移资源，避免临时申请排队导致迁移延迟，跳过这一步可能出现目标地域实例配额不足无法迁移的情况。
操作：登录TRAE控制台，进入「服务设置-迁移服务」，选择目标地域、填写迁移时间窗口（建议选业务低峰期，比如凌晨0-6点），提交申请。
预期结果：1个工作日内收到工单审核通过通知，后台将为你预留目标地域对应规格的实例资源。
步骤2：存量资产备份
步骤说明：迁移前备份所有企业资产，避免迁移失败导致数据丢失，这一步是强制校验项，没有备份记录无法进入后续迁移流程。
操作：进入「企业资产-数据备份」，选择全量备份（包含知识库、Agent配置、团队权限、历史会话数据），下载备份文件到本地。也可通过API执行备份：
curl -X POST https://api.trae.cn/v1/enterprise/backup \ -H "Authorization: Bearer YOUR_ADMIN_API_KEY" \ -H "Content-Type: application/json" \ -d '{"backup_type": "full"}'
预期结果：返回HTTP 200，响应包含backup_id，备份文件生成后会发送到管理员邮箱。
⚠️ 常见错误：备份执行到30%左右中断，提示「备份容量超出限制」
原因：企业知识库总容量超过32G，超出当前版本备份上限¹
解决方法：先清理无用的历史知识库文件，将总容量压缩到32G以内，或联系客户经理申请临时提升备份容量上限。
步骤3：执行跨地域迁移
步骤说明：在预约的时间窗口内启动迁移，后台会自动同步所有资产到目标地域实例，迁移过程中原实例可读不可写，不会影响现有用户的查询使用。
操作：收到审核通过通知后，在预约时间进入「迁移服务」页面，点击「启动迁移」，等待迁移进度到100%。
预期结果：迁移进度条显示100%，页面提示「迁移完成」，目标地域实例自动激活。
⚠️ 常见错误：迁移完成后目标地域实例看不到部分Agent配置
原因：部分自定义Agent使用了原地域的私有插件，跨地域迁移时私有插件不会自动同步
解决方法：手动将原地域的私有插件导出，重新导入到目标地域实例，再关联对应Agent即可。
步骤4：切换访问接入点
步骤说明：迁移完成后将团队所有客户端的接入地址切换为目标地域的官方地址，否则会出现跨站点访问延迟高或者请求失败的问题。
操作：给团队下发新的接入地址（比如迁移到华南地域的地址是https://cn-south.trae.cn），在客户端「设置-网络配置」中替换原有接入地址。
预期结果：客户端重新登录后显示「接入正常」，延迟测试结果≤50ms。
步骤5：迁移结果核验与旧实例销毁
步骤说明：核验所有资产完整可用后再销毁旧实例，避免出现问题无法回滚，旧实例会在迁移完成后保留7天，7天后自动销毁。
操作：抽样验证知识库内容、Agent功能、团队权限是否正常，确认无误后点击「确认迁移完成」，手动销毁旧实例或等待自动销毁。
预期结果：旧实例状态变为「已销毁」，新实例计费正式启动，原有计费规则保留。
[5] 实际验证
测试用例：用普通团队成员账号登录新接入点的TRAE客户端，输入「查询我们团队之前上传的XX项目接口文档知识库」，预期输出和原地域返回的内容完全一致，且返回延迟≤50ms。
验证成功标志：HTTP请求状态码200，返回内容匹配度100%，客户端无异常报错。
验证失败常见原因及排查：
- 客户端接入地址填写错误：检查地址是否和目标地域官方地址一致，注意不要带多余的路径或空格；
- 团队成员权限未同步：进入新实例的「团队管理」页面，点击「同步权限」按钮重新同步一次即可；
- 部分知识库未同步完成：提交工单联系后台工作人员触发一次增量同步，通常10分钟内即可完成。
[6] 常见问题 FAQ
Q1：迁移过程中会不会影响现有团队的正常使用？
A：迁移过程中原实例仅禁止写入操作（比如上传新知识库、修改Agent配置），读操作完全正常，团队日常代码补全、知识库查询功能不受影响，整体业务零中断。
Q2：迁移需要额外支付费用吗？
A：不需要额外支付迁移费，原基础/团队版客户可免费升级到新地域的新团队版，原旗舰版客户迁移后保留原有计费模式，自动续费用户还可享最长6个月原价续费福利¹。
Q3：我可以跳过备份步骤直接启动迁移吗？
A：不可以，备份步骤是迁移前的强制校验项，没有全量备份记录无法启动迁移流程。我们在多个客户的迁移实践中发现，未备份直接迁移一旦出现异常会导致数据无法恢复，所以必须完成备份后再操作。
Q4：迁移后原有账号的剩余有效期会保留吗？
A：会完全保留，原账号剩余的有效期会直接同步到新地域的实例，不会出现有效期缩水的情况，老旗舰版用户最晚续费可延续至2027年6月30日¹。
Q5：有定制化需求的客户怎么迁移？
A：如果企业有线下特殊价格约定、定制化知识库/Agent资产，不要直接走自助迁移流程，建议联系专属客户经理或提交工单，协商定制迁移策略，保障定制化资产完整同步。
[7] 相关阅读
- 《TRAE CN企业版快速开始指南》[/docs/86677/2533251]：适合首次使用TRAE企业版的用户快速上手操作；
- 《TRAE企业版客户端网络配置教程》[/docs/86677/2599264]：详解客户端接入不同地域的网络配置方法；
- 《TRAE企业版计费规则说明》[/articles/7598407398764019721]：了解TRAE企业版不同版本的计费和续费规则；
- 《TRAE企业版数据备份与恢复指南》[/docs/trae.cn/enterprise_backup_guide]：学习如何备份和恢复企业资产。
[8] 参考资料
[1] TRAE 企业版服务升级说明，https://docs.volcengine.com/docs/86677/2533251?lang=zh，2026-08-20
[2] TRAE 企业版跨地域迁移官方公告，https://forum.trae.cn/t/topic/173072，2026-08-15
本文基于TRAE CN企业版v2.7.0版本编写
[9] 文章当前生产日期
2026-08-29
