tencent cloud

Cloud Virtual Machine

호환성 및 도구 구성 설명

다운로드
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-09-07 14:16:14
AI 번역

지원되는 운영 체제

현재 온라인 마이그레이션 툴에서는 다음과 같은 소스 CVM 운영 체제를 지원합니다.
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/26
Debian 7/8/9/10/12
SUSE 11/12/15
openSUSE 42/Leap-15
Amazon Linux AMI
Red Hat 5/6/7/8/9/10
Oracle Linux 5/6/7/8/9

지원하는 마이그레이션 모드

공중망 마이그레이션 모드
사설망 마이그레이션 모드
사용자의 소스 CVM과 대상 CVM 모두 공중망 액세스 기능이 있다면 공중망 마이그레이션 모드의 마이그레이션을 사용할 수 있습니다.
현재 공중망 마이그레이션 모드에서는, 소스 CVM에서 인터넷을 통해 Tencent Cloud API에 액세스하여 마이그레이션 요청을 보낸 다음, 대상 CVM에 데이터를 전송함으로써 소스 CVM을 Tencent Cloud의 대상 CVM으로 마이그레이션합니다. 공중망 마이그레이션 시나리오는 다음 이미지와 같습니다.

사용자의 소스 CVM이나 대상 CVM이 특정 사설망이나 VPC에 있다면 인터넷을 통해 소스 CVM을 대상 CVM에 바로 연결할 수 없으므로, 툴의 사설망 마이그레이션 모드로 마이그레이션할 수 있습니다. 사설망 마이그레이션을 사용하려면 Peering Connection, VPN Connections, Cloud Connect Network 또는 Direct Connect 등의 방법으로 소스 CVM과 대상 CVM 간의 통로를 생성해야 합니다.

시나리오1
: (이 시나리오는 툴 마이그레이션 사용만 지원) 사용자의 소스 CVM 혹은 대상 CVM이 공중망에 액세스할 수 없다면, 게이트웨이 같이 공중망 액세스 기능을 갖춘 호스트에서 인터넷을 통해 Tencent Cloud API를 호출하여 마이그레이션을 요청한 다음, 터널을 연결하여 데이터를 대상 CVM으로 마이그레이션 할 수 있습니다. 이 시나리오에서는 소스 CVM과 대상 CVM의 공중망 액세스 기능이 필요하지 않습니다.


시나리오2
: 사용자의 소스 CVM이 공중망에 액세스할 수 있다면, 먼저 소스 CVM에서 인터넷을 통해 Tencent Cloud API를 호출하여 마이그레이션을 요청한 다음, 터널을 연결하여 데이터를 대상 CVM으로 마이그레이션 할 수 있습니다. 이 시나리오에서는 소스 CVM의 공중망 액세스 기능이 필요하며 대상 CVM은 해당 기능이 필요하지 않습니다.


시나리오3
: 사용자의 소스 CVM이 프록시를 통해 공중망에 액세스할 수 있다면, 먼저 소스 CVM에서 네트워크 프록시를 통해 Tencent Cloud API를 호출하여 마이그레이션을 요청한 다음, 터널을 연결하여 데이터를 대상 CVM으로 마이그레이션 할 수 있습니다. 이 시나리오에서는 소스 CVM과 대상 CVM의 공중망 액세스 기능이 필요하지 않습니다.


압축 파일 설명

go2tencentcloud.zip 압축 해제 후 파일 설명은 다음과 같습니다.
파일 이름
설명
go2tencentcloud-linux.zip
Linux 시스템용 마이그레이션 zip.
go2tencentcloud-windows.zip
Windows 시스템용 마이그레이션 zip.
readme.txt
디렉터리 소개 파일.
release_notes.txt
마이그레이션 툴 변경 로그.
go2tencentcloud-linux 압축 해제 후 파일 설명은 다음과 같습니다.
파일 이름
설명
go2tencentcloud_x64
64비트 Linux 시스템의 마이그레이션 툴에서 실행 가능한 프로그램입니다.
go2tencentcloud_x32
32비트 Linux 시스템의 마이그레이션 툴에서 실행 가능한 프로그램입니다.
go2tencentcloud_arm64
arm 아키텍처 64비트 Linux 시스템의 마이그레이션 툴 실행 프로그램입니다.
tools
마이그레이션 툴 의존 파일 디렉터리입니다.
logs
마이그레이션 툴 로그 디렉터리.
user.json
마이그레이션의 사용자 정보입니다.
client.json
마이그레이션 툴의 구성 파일입니다.
rsync_excludes_linux.txt
rsync 구성 파일로, Linux 시스템에서 마이그레이션 하지 않을 파일 디렉터리를 제외합니다.
go2tencentcloud-windows 압축 해제 후 파일 설명은 다음과 같습니다.
파일 이름
설명
go2tencentcloud_x64.exe
64비트 Windows 시스템의 마이그레이션 툴에서 실행 가능한 프로그램입니다.
logs
마이그레이션 툴 로그 디렉터리.
user.json
마이그레이션의 사용자 정보입니다.
client.json
마이그레이션 툴의 구성 파일입니다.
client.exe
Windows 시스템의 마이그레이션 실행 가능 프로그램입니다.
주의사항:
삭제할 수 없는 구성 파일은 go2tencentcloud의 실행 가능 프로그램과 같은 단계의 디렉터리로 이동해 놓으시기 바랍니다.

rsync_excludes_linux.txt 파일 설명

Linux 소스 CVM에서 마이그레이션하지 않을 파일을 제외하거나 디렉터리 안의 구성 파일을 지정합니다. 다음의 디렉터리 및 파일이 제외 파일로 기본 설정되어 있습니다. 삭제하지 마시기 바랍니다.
/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
Tencent Cloud API 타겟 계정 액세스 키 SecretId.
-secret-key
Tencent Cloud API 타겟 계정 액세스 키 SecretKey.
-region
마이그레이션할 대상 리전입니다.
-mode
데이터 전송 네트워크 모드. 입력값 범위는 0(공용 네트워크 모드, 공용 네트워크를 통해 데이터 전송), 2(내부 네트워크 모드 시나리오 2, 내부 네트워크를 통해 데이터 전송), 3(내부 네트워크 모드 시나리오 3, 내부 네트워크를 통해 데이터 전송)이며, 기본값은 0입니다.
-console
툴이 작업을 자동으로 생성하고 마이그레이션을 진행하도록 하며, 마이그레이션 콘솔에서 작업을 수동으로 생성할 필요가 없어 일괄 마이그레이션 시나리오에 적합합니다.
-dest-type
마이그레이션 대상 유형입니다. 입력값 범위는 Image(CVM 이미지로 마이그레이션) 및 Instance(타겟 CVM 인스턴스로 마이그레이션)이며, 기본값은 Instance입니다.
-instance-id
마이그레이션할 클라우드 서버 인스턴스의 대상 인스턴스 ID입니다.
-out-image-name
CVM 이미지로 마이그레이션할 때 이미지 이름을 설정합니다.
-dest-vpc-id
내부 네트워크 모드를 사용하여 CVM 이미지로 마이그레이션할 때, 소스 서버 내부 네트워크 환경과 연결된 VPC ID입니다.
-dest-subnet-id
내부 네트워크 모드를 사용하여 CVM 이미지로 마이그레이션할 때, 소스 내부 네트워크 환경과 연결된 서브넷 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
현재 마이그레이션 대상 CVM 인스턴스 상태에서는 마이그레이션할 수 없습니다
마이그레이션 대상 CVM 인스턴스는 실행 중 또는 꺼짐 상태의 인스턴스만 지원됩니다.
ERROR_SAME_INSTANCE
소스 서버와 대상 CVM 인스턴스가 동일하여 마이그레이션할 수 없습니다
타겟 CVM 인스턴스를 변경한 후 마이그레이션 작업을 다시 시작하십시오.
ERROR_NO_IPV6
타겟 CVM 인스턴스의 IPv6 주소가 없습니다
타겟 CVM 인스턴스에 IPv6 주소가 없습니다. IPv4 주소를 사용하여 마이그레이션할 수 있습니다.
ERROR_NO_PUBLIC_IP
타겟 CVM 인스턴스에 공용 IP가 없어 공용 네트워크 모드로 마이그레이션할 수 없습니다
타겟 CVM 인스턴스에 공용 IP가 없어 공용 네트워크 모드로 마이그레이션할 수 없습니다. Tencent Cloud의 타겟 CVM 인스턴스에 탄력적 공용 IP를 할당하거나 내부 네트워크 모드로 마이그레이션할 수 있습니다.
ERROR_SAME_IP
인트라넷 마이그레이션 모드에서 소스 서버 내부 IP와 타겟 CVM 인스턴스 내부 IP가 동일하여 연결을 설정할 수 없습니다
퍼블릭 네트워크 모드로 마이그레이션하거나 타겟 CVM 인스턴스의 내부 네트워크 IP를 변경할 수 있습니다.
ERROR_OS_NOT_MATCH
Windows 인스턴스와 Linux 인스턴스는 서로 마이그레이션할 수 없습니다
Windows 시스템 인스턴스는 Windows 인스턴스로만 마이그레이션할 수 있습니다. Linux 시스템 인스턴스는 Linux 인스턴스로만 마이그레이션할 수 있습니다. 타겟 CVM 인스턴스를 변경한 후 다시 마이그레이션할 수 있습니다.
ERROR_INSTANCE_TYPE_NOT_SUPPORTED
타겟 CVM 인스턴스의 인스턴스 유형은 현재 마이그레이션 대상으로 지원되지 않습니다
방법 1: 마이그레이션 타겟을 CVM 이미지로 설정할 수 있습니다. 사용자 정의 이미지를 생성한 후, 필요한 인스턴스 유형을 선택하여 해당 사용자 정의 이미지를 기반으로 인스턴스를 생성할 수 있습니다.
방법 2: 먼저 지원되는 다른 유형(예: 표준형 SA5 등)의 인스턴스로 마이그레이션할 수 있습니다. 마이그레이션 후 사용자 정의 이미지를 생성하고, 필요한 인스턴스 유형을 선택하여 해당 사용자 정의 이미지를 기반으로 인스턴스를 생성할 수 있습니다.
ERROR_SEC_GROUP_PORT_NOT_OPEN3
타겟 CVM 인스턴스 보안 그룹의 80, 443, 3389 포트가 열려 있지 않습니다
콘솔에서 해당 보안 그룹 포트를 개방할 수 있습니다.
ERROR_ADD_MORE_DISK
타겟 CVM 인스턴스의 데이터 디스크 수량이 부족합니다
타겟 CVM 인스턴스의 데이터 디스크 수량을 추가하여 마이그레이션 요구사항을 충족할 수 있습니다.
ERROR_SYSTEM_DISK_SIZE_NOT_ENOUGH
타겟 CVM 인스턴스의 시스템 디스크 공간이 부족합니다
시스템 디스크를 확장하여 마이그레이션 요구사항을 충족할 수 있습니다.
ERROR_RUN_INSTANCES_NO_PAYMENT_RIGHTS
서브 계정에 결제 권한이 없습니다
루트 계정으로 액세스 관리에 접속하여 서브 계정에 QCloudFinanceFullAccess 정책을 추가하십시오.
ERROR_ENTER_MIGRATE_MODE
타겟 CVM 인스턴스가 마이그레이션 모드로 전환되지 못했습니다
고객센터에 문의하시기 바랍니다.
ERROR_HOST_TO_HOST_CONNECTION
마이그레이션 소스가 타겟 CVM 인스턴스에 연결할 수 없습니다
고객센터에 문의하시기 바랍니다.
ERROR_INIT_SERVER
타겟 서버 초기화에 실패했습니다
고객센터에 문의하시기 바랍니다.
ERROR_DATA_TRANSMISSION
데이터 전송에 실패했습니다
고객센터에 문의하시기 바랍니다.

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백