一、支持的操作系统
| Linux 操作系统 | Windows 操作系统 |
| CentOS 5/6/7/8 | Windows Server 2008R2Windows Server 2012Windows Server 2016Windows Server 2019Windows Server 2022Windows Server 2025 |
| | Ubuntu 10/12/14/16/18/20/22/24 |
| | Debian 7/8/9/10/11/12 |
| | SUSE 11/12/15 |
| | openSUSE 42/Leap-15 |
| | Amazon Linux AMI |
| | Red Hat 5/6/7/8/9 |
| | Oracle Linux 5/6/7/8/9 |
二、支持的迁移模式
公网迁移模式内网迁移模式
如果你的源端和目标云服务器都具有公网访问能力，则可以使用公网迁移模式进行迁移。在目前的公网迁移模式中，迁移工具通过互联网访问腾讯云 API 发起迁移请求，并向目标云服务器传输数据，将源端服务器迁移至腾讯云的目标云服务器。公网迁移场景如下：
如果你的源端服务器或目标云服务器处于内网中，源端服务器不能通过互联网直接与目标云服务器建立连接，则可以使用工具的内网迁移模式进行迁移。内网迁移模式需要通过使用如 VPC 对等连接、VPN 连接、云联网 或者 专线接入 等方式建立源端服务器与目标云服务器的连接通道。
·场景1：（该场景仅支持 使用工具迁移）如果你的源端服务器或目标云服务器不能访问公网，则可以先通过一台拥有公网访问能力的服务器（如网关）以互联网方式访问腾讯云 API 发起迁移请求，再通过连接通道向目标云服务器传输数据进行迁移。此场景不要求对源端服务器和目标云服务器具有公网访问能力。
·场景2：如果你的源端服务器可以访问公网，则可以先在源端服务器上通过互联网访问腾讯云 API 发起迁移请求，再通过连接通道向目标云服务器传输数据进行迁移。此场景要求对源端服务器具有公网访问能力，而目标云服务器则不要求。
·场景3：如果你的源端服务器可以通过代理访问公网，则可以先在源端服务器上通过网络代理访问腾讯云 API 发起迁移请求，再通过连接通道向目标云服务器传输数据进行迁移。此场景不要求对源端服务器和目标云服务器具有公网访问能力。
三、压缩包文件说明
go2tencentcloud.zip 解压后，文件说明如下：
| 文件名 | 说明 |
| go2tencentcloud-linux | Linux 系统的迁移工具目录。 |
| go2tencentcloud-windows | Windows 系统的迁移工具目录。 |
| readme.txt | 目录简介文件。 |
| release_notes.txt | 迁移工具变更日志。 |
go2tencentcloud-linux迁移工具目录文件说明如下：
| 文件名 | 说明 |
| go2tencentcloud_x64 | x86架构64位 Linux 系统的迁移工具可执行程序。 |
| go2tencentcloud_x32 | x86架构32位 Linux 系统的迁移工具可执行程序。 |
| go2tencentcloud_arm64 | arm架构64位 Linux 系统的迁移工具可执行程序。 |
| tools | 迁移工具依赖文件目录。 |
| logs | 迁移工具日志目录。 |
| user.json | 迁移时的用户信息。 |
| client.json | 迁移时迁移工具的配置文件。 |
| rsync_excludes_linux.txt | 配置文件，排除 Linux 系统下不需要迁移的文件或目录。 |
go2tencentcloud-windows 迁移工具目录文件说明如下：
| 文件名 | 说明 |
| go2tencentcloud_x64.exe | 64位 Windows 系统的迁移工具可执行程序。 |
| logs | 迁移工具日志目录。 |
| user.json | 迁移时的用户信息。 |
| client.json | 迁移时迁移工具的配置文件。 |
| client.exe | Windows 系统的迁移可执行程序。 |
注意：不能删除配置文件，并请将配置文件存放在和 go2tencentcloud 可执行程序同级目录下。
四、rsync_excludes_linux.txt 文件说明
排除 Linux 源端服务器中不需要迁移传输的文件，或指定目录下的配置文件。该文件中已经默认排除以下目录和文件，请勿删改。
/dev/*/sys/*/proc/*/var/cache/yum/*/lost+found/*/var/lib/lxcfs/*/var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
如果你需要排除其他目录和文件，请在该文件尾部追加内容。例如，排除挂载在 /mnt/disk1 的数据盘的所有内容。
/dev/*/sys/*/proc/*/var/cache/yum/*/lost+found/*/var/lib/lxcfs/*/var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*/mnt/disk1/*
五、工具常用运行参数说明
| 参数选项 | 说明 |
| -help | 打印帮助信息。 |
| -check | 检查源端服务器是否满足迁移，仅做检查不迁移。 |
| -ignore-check | 迁移时跳过工具自动检查，直接迁移。 |
| -log-file | 设置日志文件名称，默认为 log。 |
| -log-level | 日志输出级别，取值范围为1（ERROR 级别），2（INFO 级别）和3（DEBUG 级别），默认值为2。 |
| -version | 打印工具版本号。 |
| -secret-id | 腾讯云 API 目标账号访问密钥 SecretId。 |
| -secret-key | 腾讯云 API 目标账号访问密钥 SecretKey。 |
| -region | 需要迁移到的目标地域。 |
| -mode | 数据传输网络模式，取值范围为0（公网模式，通过公网传输数据），2（内网模式场景2，通过内网传输数据），3（内网模式场景3，通过内网传输数据），默认值为0。 |
| -console | 让工具自动创建任务并进行迁移，无需在迁移控制台手动创建任务，适用于批量迁移场景。 |
| -dest-type | 迁移目标类型，取值范围为 Image（迁移为云服务器镜像）和 Instance（迁移为目标云服务器实例），默认值为 Instance。 |
| -instance-id | 迁移为实例时，需要迁移到的目标云服务器实例 ID。 |
| -out-image-name | 迁移为云服务器镜像时，设置镜像名称。 |
| -dest-vpc-id | 使用内网模式迁移为云服务器镜像时，已和源端服务器内网环境连通的 VPC ID。 |
| -dest-subnet-id | 使用内网模式迁移为云服务器镜像时，已和源端内网环境连通的子网 ID。 |
| -proxy-ip | 当源端服务器借助 HTTP 代理访问公网时，给工具设置 HTTP 代理 IP。 |
| -proxy-port | 当源端服务器借助 HTTP 代理访问公网时，给工具设置 HTTP 代理端口。 |
| -proxy-user | 当源端服务器借助 HTTP 代理访问公网时，给工具设置 HTTP 代理用户名。 |
| -proxy-password | 当源端服务器借助 HTTP 代理访问公网时，给工具设置 HTTP 代理用户密码。 |
| -bandwidth-limit | 设置限速带宽，单位是KB/s，工具默认不限速。仅限于 Linux 迁移。 |
六、迁移失败指引
在控制台服务器迁移操作后，会因为一些原因导致任务失败。在任务失败的情况下，你可以在 控制台 查看错误码，并根据以下内容进行排查。
| 错误码 | 错误说明 | 指引 |
| ERROR_REMOTE_INSTANCE_STATUS_NOT_VALID | 当前迁移目标云服务器实例状态不允许迁移 | 仅支持运行中和已关机的实例作为迁移目标云服务器实例。 |
| ERROR_SAME_INSTANCE | 源端服务器和目标云服务器实例相同，不允许迁移 | 请更换目标云服务器实例后重新发起迁移任务。 |
| ERROR_NO_IPV6 | 目标云服务器实例 IPv6 地址缺失 | 目标云服务器实例没有 IPv6 地址，你可以使用 IPv4 地址进行迁移。 |
| ERROR_NO_PUBLIC_IP | 目标云服务器实例没有公网 IP，无法使用公网模式迁移 | 目标云服务器实例没有公网 IP，无法使用公网模式迁移，你可以将云上的目标云服务器实例分配一个 弹性公网IP，或者使用内网模式迁移。 |
| ERROR_SAME_IP | 内网迁移模式下，源端服务器内网 IP 和目标云服务器实例内网 IP 相同，无法建立连接 | 你可以采用公网模式进行迁移；或者更换目标云服务器实例的内网 IP。 |
| ERROR_OS_NOT_MATCH | Windows 与 Linux 实例不能互相迁移 | Windows 系统的实例只能迁移到 Windows 实例上。Linux 系统的实例只能迁移到 Linux 的实例上。你可以更换目标云服务器实例重新迁移。 |
| ERROR_INSTANCE_TYPE_NOT_SUPPORTED | 目标云服务器实例的实例类型暂不支持作为迁移目标 | 方法一：你可以将迁移目标设置为云服务器镜像，得到迁移后的自定义镜像后，再选择你需要的实例类型基于此镜像创建实例。方法二：你可以先迁移到另一台支持的类型（例如标准型 SA5 等）的实例上，迁移后 创建自定义镜像，再选择你需要的实例类型基于此自定义镜像创建实例。 |
| ERROR_SEC_GROUP_PORT_NOT_OPEN3 | 目标云服务器实例安全组80、443、3389端口未开放 | 你可以在 控制台 开放你相应的安全组端口。 |
| ERROR_ADD_MORE_DISK | 目标云服务器实例数据盘数量不够 | 你可以增加目标云服务器实例的数据盘数量，以达到迁移的要求。 |
| ERROR_SYSTEM_DISK_SIZE_NOT_ENOUGH | 目标云服务器实例系统盘空间不足 | 你可以 扩容系统盘，以达到迁移的要求。 |
| ERROR_RUN_INSTANCES_NO_PAYMENT_RIGHTS | 子账号没有支付权限 | 主账号进入 访问管理，为子账号添加 QCloudFinanceFullAccess 策略。 |
| ERROR_ENTER_MIGRATE_MODE | 目标云服务器实例进入迁移模式失败 | 请你联系 客服 协助。 |
| ERROR_HOST_TO_HOST_CONNECTION | 迁移源无法连接到目标云服务器实例 | 请你联系 客服 协助。 |
| ERROR_INIT_SERVER | 初始化目标服务器失败 | 请你联系 客服 协助。 |
| ERROR_DATA_TRANSMISSION | 数据传输失败 | 请你联系 客服 协助。 |