云服务器兼容性与工具配置说明

支持的操作系统
在线迁移工具支持的源端服务器操作系统包括但不限于以下操作系统（建议关注支持的最低系统版本）：
Linux 操作系统
Windows 操作系统
CentOS 5/6/7/8
Windows Server 2008R2
Windows Server 2012
Windows Server 2016
Windows Server 2019
Windows Server 2022
Windows 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
让工具自动创建任务并进行迁移，无需在迁移控制台手动创建任务，适用于批量迁移场景。
-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
数据传输失败
请您联系 客服 协助。

错误码	错误说明	指引
`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`	数据传输失败	请您联系客服协助。

Linux 操作系统	Windows 操作系统
CentOS 5/6/7/8	Windows Server 2008R2 Windows Server 2012 Windows Server 2016 Windows Server 2019 Windows Server 2022 Windows 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

文件名	说明
go2tencentcloud-linux	Linux 系统的迁移工具目录。
go2tencentcloud-windows	Windows 系统的迁移工具目录。
readme.txt	目录简介文件。
release_notes.txt	迁移工具变更日志。

文件名	说明
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_x64.exe	64位 Windows 系统的迁移工具可执行程序。
logs	迁移工具日志目录。
user.json	迁移时的用户信息。
client.json	迁移时迁移工具的配置文件。
client.exe	Windows 系统的迁移可执行程序。

参数选项	说明
`-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`	让工具自动创建任务并进行迁移，无需在迁移控制台手动创建任务，适用于批量迁移场景。
`-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 迁移。

兼容性与工具配置说明

本页目录：

支持的操作系统

支持的迁移模式

压缩包文件说明

rsync_excludes_linux.txt 文件说明

工具常用运行参数说明

迁移失败指引