云服务器
视频服务与安全产品捉虫活动邀您参加！> HOT
文档中心>云服务器>操作指南>镜像>导入镜像>导入镜像概述

导入镜像概述

最近更新时间：2024-10-30 16:12:02

我的收藏

本页目录：

除了使用 创建自定义镜像 功能外，腾讯云同时支持使用导入功能。可将本地或其他平台的服务器系统盘镜像文件导入至云服务器（Cloud Virtual Machine，CVM）自定义镜像中。导入后可以使用该导入镜像创建云服务器或对已有云服务器重装系统。
说明：
由于镜像底层使用了云硬盘快照服务：
国内地域提供80 GB 的免费额度，详情请参见 赠送额度。
在创建自定义镜像时会默认创建关联该镜像的快照，且保留自定义镜像会产生一定的快照费用，详情请参见 快照计费概述。
若您的腾讯云账户进入欠费状态，为避免您的数据丢失，我们将保留您的自定义镜像及关联的快照，且不会产生新的费用。

导入准备

您需提前准备好符合导入限制的镜像文件。
Linux 系统类型镜像限制
Windows 系统类型镜像限制
镜像属性
条件
操作系统
基于 CentOS、CentOS Stream、Ubuntu、Debian、RedHat、OpenSUSE、CoreOS、FreeBSD、Kylin（麒麟）、UnionTech、TencentOS、Fedora、AlmaLinux、Rocky Linux、OpenCloudOS、Other Linux 发行版的镜像
支持32位、64位和 arm_64位
镜像格式
支持 RAW、VHD、QCOW2、VMDK 镜像格式
使用 qemu-img info imageName | grep 'file format' 查看镜像格式
其它格式的镜像文件，您可参见 转换镜像格式 转换后导入
文件系统及分区
支持 xfs、ext3 和 ext4 文件系统，支持 MBR 和 GPT 分区
说明：
支持 ext4 文件系统，但不能包含特性64bit，并且特性project和quota不能成对出现。您可以运行以下命令查看 ext4 文件系统中包含的特性列表。
tune2fs -l <ext4文件系统盘所在路径> | grep features
不建议系统盘有多个分区，建议只有单个根分区，如果有多个分区时，系统所在分区之后不建议再存在其他分区，否则将导致磁盘扩容失败
不建议通过 LVM 来构建系统盘分区（根分区），否则可能导致实例启动、修改密码、使用密码 SSH 登录等问题
镜像大小
镜像实际大小不超过1024G，使用qemu-img info imageName | grep 'disk size'查看镜像实际大小
镜像 vsize 不超过1024G，使用qemu-img info imageName | grep 'virtual size'查看镜像 vsize
注意：导入镜像时审查大小以转换为 QCOW2 格式后的镜像信息为准
网络
腾讯云默认为实例提供 eth0 网络接口
用户可以在实例内通过 metadata 服务查询实例的网络配置，详见 实例元数据
驱动
镜像必须安装虚拟化平台 KVM 的 Virtio 驱动，详情参见 Linux 导入镜像检查 Virtio 驱动
镜像需安装 cloudinit，详情参见 Linux 导入镜像安装 cloudinit
如因其它原因，镜像无法安装 cloudinit，请根据 强制导入镜像 自行配置实例
文件系统
为了确保 Linux 系统在启动文件系统时能够正确识别磁盘，请您检查并正确配置 GRUB 文件磁盘标识方式。详情参见 配置 GRUB 文件磁盘标识方式为 UUID。
为了确保 Linux 系统在挂载文件系统时能够正确识别磁盘，请您检查并正确配置 fstab 文件磁盘标识方式。详情参见 配置 fstab 文件磁盘标识方式为 UUID。
内核限制
镜像最好是原生内核，修改可能会导致云服务器无法导入
地域限制
境外地域导入镜像服务仅支持同地域 COS 文件，即需用同地域 COS 链接导入
镜像属性
条件
操作系统
Windows Server 2022 、Windows Server 2019 、Windows Server 2016 、Windows Server 2012 、Windows Server 2008 、Other Windows相关版本
支持32位、64位和 arm_64位
镜像格式
支持 RAW、VHD、QCOW2、VMDK 镜像格式
使用qemu-img info imageName | grep 'file format'查看镜像格式
其它格式的镜像文件，您可参见 转换镜像格式 转换后导入
文件系统及分区
支持 NTFS 文件系统，支持 MBR 和 GPT 分区
支持在系统盘上创建多个分区
请确保系统所在磁盘的启动分区（C盘）之后不再存在其他分区，否则可能导致实例启动失败或磁盘扩容失败
镜像大小
镜像实际大小不超过1024G，使用qemu-img info imageName | grep 'disk size'查看镜像实际大小
镜像 vsize 不超过1024G，使用qemu-img info imageName | grep 'virtual size'查看镜像 vsize
注意：导入镜像时审查大小以转换为 qcow2 格式后的镜像信息为准
网络
腾讯云默认为实例提供本地连接网络接口
用户可以在实例内通过 metadata 服务查询实例的网络配置，详见 实例元数据
驱动
镜像必须安装虚拟化平台 KVM 的 Virtio 驱动。Windows系统默认未安装 Virtio 驱动，用户可安装 Windows Virtio 驱动后导出本地镜像。Windows Virtio 驱动下载地址如下，请对应实际网络环境进行下载：
公网下载地址：http://mirrors.tencent.com/install/windows/virtio_64_1.0.9.exe
内网下载地址：http://mirrors.tencentyun.com/install/windows/virtio_64_1.0.9.exe
地域限制
境外地域导入镜像服务仅支持同地域 COS 文件，即需用同地域 COS 链接导入
其他
导入的 Windows 系统镜像不提供 Windows 激活 服务

导入步骤

1. 登录云服务器控制台，单击左侧导航栏中的镜像。



2. 选择自定义镜像，单击导入镜像。



3. 根据操作界面要求，先 开通 COS，再 创建 bucket 存储桶，上传对象 镜像文件到 bucket 并 获取镜像文件URL（建议您复制临时链接 URL 用于镜像导入）。



4. 单击下一步。
5. 按照实际情况，填写表单，单击开始导入。
参数名称
必填
说明
地域
是
确定您导入的自定义镜像所在地域，请与您需要创建实例的地域保持一致，本地域的自定义镜像不可直接用于其他地域创建实例；若其他地域需要使用当前镜像，可以使用 复制镜像 跨地域复制您的自定义镜像。
系统盘文件
是
系统盘文件包含了服务器操作系统的内核、库文件、驱动程序等核心组件，通过系统盘文件，服务器能够启动并运行操作系统，从而提供基础的服务和功能。
导入方式
从 COS 列表存储选择
在下拉列表选择文件所在 COS 桶，再选择对应的镜像文件，系统自动获取镜像文件 URL。注意：当前方法仅支持选择本地域下的 COS 文件。
直接输入 COS 对象地址
前往 对象存储控制台 找到镜像文件所在的存储桶列表，并逐级搜索镜像文件，在镜像文件详情页面，您可以直接单击 临时链接-复制临时链接，即可获取镜像文件 URL。
操作系统
是
1、选择 Linux 或 Windows 操作系统
请与镜像文件的操作系统类型保持一致。
2、系统平台
用于标识导入镜像文件的操作系统平台；请与镜像文件的操作系统平台保持一致。
Linux 操作系统：支持选择 CentOS、CentOS Stream、Ubuntu、Debian、RedHat 等常用系统平台，若导入的系统平台不在列表中，请选择 Other Linux。
Windows 操作系统：支持选择 Windows Server 2022 、Windows Server 2019 等常用系统，若导入的系统平台不在列表中，请选择 Other Windows。
3、系统版本
用于标识导入镜像文件的 Linux 操作系统版本，例如 CentOS 支持选择8、7、6、5多个版本。请与镜像文件的操作系统版本保持一致。
4、系统架构
支持32位、64位和 arm_64位。请与镜像文件的操作系统架构保持一致。
数据盘文件
（功能公测中，您可以联系客服体验）
否
数据盘文件用于存储用户数据文件，例如应用程序数据、用户文档、数据库文件等；若您的镜像有数据盘文件，可以通过勾选添加数据盘来输入。
导入方式
从 COS 列表存储选择
在下拉列表选择文件所在 COS 桶，再选择对应的镜像文件，系统自动获取镜像文件URL。注意：当前方法仅支持选择本地域下的 COS 文件。
直接输入 COS 对象地址
前往 对象存储控制台 找到镜像文件所在的存储桶列表，并逐级搜索镜像文件，在镜像文件详情页面，您可以直接单击 临时链接-复制临时链接，即可获取镜像文件 URL。
镜像名称
是
导入镜像文件后显示的镜像名称。请注意，镜像名称只支持中文、字母、数字或连接符号"-_."，且最多60个字符。
镜像描述
否
增加镜像说明，便于后续管理。
标签
否
设置标签，便于搜索和管理。
更多配置
参数名称
必填
说明
导入方式
否
如果您的镜像无法正常导入，您可以选择使用启用强制导入选项。这种方式仅对文件的完整性进行检查，而不会因驱动或配置问题而阻止导入过程。详情请参见 强制导入。
启动模式
是
请您确认当前选择的启动模式与镜像文件的启动模式一致，否则使用该镜像会影响您实例的正常启动。相关最佳实践请参见：启动模式 Legacy BIOS/UEFI 最佳实践。
导入成功或失败，均会以 站内信 的形式通知。

导入失败检查与处理

在控制台进行导入镜像操作后，会因为一些原因导致任务失败。在任务失败的情况下，您可以在 控制台 或者 站内信 查看错误码，并根据以下内容进行排查。
错误码
错误原因
建议处理方式
InvalidUrl
输入的 COS 链接无效；可能原因：
输入了不是 腾讯云 COS 的镜像文件链接
COS 的对象地址不具备公有读私有写权限
COS 文件的访问权限为私有读，但是签名已失效
在境外地域导入镜像时，使用了非同地域的 COS 链接；境外地域导入镜像服务仅支持同地域 COS 服务器
当前 COS 文件已被删除
检查 COS 链接与导入镜像链接是否相同
InvalidFormatSize
导入镜像的格式或大小不符合腾讯云导入镜像功能的限制
导入镜像支持 qcow2，vhd，vmdk，raw 4种格式的镜像文件
镜像系统盘大小不得超过1024GB，单块数据盘不得超过2048GiB（按转换为 qcow2 格式的镜像文件为准）
镜像需要满足 导入准备 中关于镜像格式和镜像大小的限制
可以根据 Linux 镜像制作 的镜像格式转换内容将镜像文件转换为合适的文件格式、精简镜像内容以满足大小限制后重新导入镜像
超出限制的文件，也可以使用 离线实例迁移 功能迁移镜像
VirtioNotInstall
未安装 virtio 驱动：
腾讯云使用 KVM 虚拟化技术，要求用户导入的镜像内已安装 virtio 驱动。除了少部分用户定制的 Linux 操作系统外，大部分的 Linux 操作系统已经安装 Virtio 驱动；Windows 操作系统则需要用户手动安装 Virtio 驱动
Linux 镜像导入，可以参见文档 Linux 系统检查 Virtio 驱动
Windows 镜像导入，可以参见文档 Windows 镜像制作安装 Virtio 驱动
CloudInitNotInstalled
cloud-init 未安装：
腾讯云使用开源程序 cloud-init 初始化子机，因此未安装 cloud-init 程序将导致用户子机初始化失败
Linux 镜像导入，可以参见文档 Linux 系统安装 cloud-init
Windows 镜像导入，可以参见文档 Windows 操作系统安装 cloudbase-init
PartitionNotPresent
未找到分区信息，导入的镜像不完整
镜像损坏，请检查制作镜像时是否包含引导分区，可能是错误的镜像制作方式导致的
RootPartitionNotFound
未检测到导入的镜像包含根分区，可能的原因：
上传了安装包文件
上传了数据盘镜像
上传了引导分区镜像
上传了错误的文件
镜像损坏，可能是错误的镜像制作方式导致的
InternalError
其他错误
请联系客服协助

检测结果说明及修复建议

导入镜像会自动对镜像可用性检测，您可以在控制台查看导入镜像检测结果，建议您根据检测结果完善镜像，以保证功能可用性。

Linux 操作系统检测项及说明如下：

检测项
检测说明
检测结果
修复建议
Virtio
镜像中 virtio 驱动是否安装
Supported - 满足
KernelNotSupported - 内核不支持
BlkDriverNotFound - 磁盘驱动未找到
NetDriverNotFound - 网络驱动未找到
强烈建议修复：
修复请参见文档 Linux 系统检查 Virtio 驱动
CloudInit
镜像中是否安装 cloud-init
Supported - 满足
NotSupported - 不支持
强烈建议修复：
修复请参见文档 Linux 系统安装 cloud-init
CloudinitConfig
cloud-init配置是否正常
Supported - 满足
Invalid - cloud.cfg内容无法加载
InvalidCloudFinalModules - cloud_final_modules配置项中没有scripts-user
InvalidDatasourceList - datasource_list 中没有 ConfigDrive
强烈建议修复：
1. 修改 cloud-init 配置文件： 根据不同操作系统，下载 cloud.cfg。
点此下载 Ubuntu 操作系统的 cloud.cfg。
点此下载 CentOS 操作系统的 cloud.cfg。
点此下载 OpenSUSE / SUSE 操作系统的 cloud.cfg
2. 将 /etc/cloud/cloud.cfg 的内容替换为已下载的 cloud.cfg 文件内容。
Fstab
镜像中 /etc/fstab 文件配置了系统磁盘设备挂载信息，错误的配置会导致系统启动异常，例如配置的挂载设备信息不存在、设备 UUID 错误等
Supported - 满足
DeviceNotFound - 配置中有设备不存在
DeviceConfig - 使用的是 /dev/vd* 的配置项
建议修复：
1. 若您的操作系统非FreeBSD，修复参见文档 配置 fstab 文件磁盘标识方式为 UUID。
2. 若您的操作系统是 FreeDSB。
添加 Label。
# 设置Label
tunefs -L root /dev/da3
# 查看结果
ls /dev/ufs/root
修改 /etc/fstab。
# 备份文件
cp /etc/fstab /etc/fstab.bak
# 修改
vim /etc/fstab
修改结果。
/dev/ufs/home      /            ufs     rw              2      2
Grub
镜像中 grub 引导文件是否正常。例如 device 设备配置异常、相关设备不存在、UUID 错误等，会导致系统启动异常
镜像为 FreeBSD 时不做此项检查
Supported - 满足
NotSupported - 不是采用的 UUID 的方式配置的
建议修复：
Selinux
镜像是否关闭 SELinux。云上镜像不建议开启 SELinux，有可能会导致系统启动异常
镜像为 FreeBSD 时不做此项检查
Supported - 满足
ConfigNotFound - 启用情况下 /etc/selinux/config 不存在
Enforcing - 开启了最高级别
建议修复：
修复参考
# 切换到root用户
vim /etc/selinux/config
修改成
# This file controls the state of SELinux on the system.
# SELINUX= can take one of these three values:
#       enforcing - SELinux security policy is enforced.
#       permissive - SELinux prints warnings instead of enforcing.
#       disabled - No SELinux policy is loaded.
SELINUX=permissive
# SELINUXTYPE= can take one of these two values:
#       targeted - Targeted processes are protected,
#       mls - Multi Level Security protection.
SELINUXTYPE=targeted

OnlineResizeFS
镜像是否支持根分区自动扩容。镜像中安装有 cloud-init、growpart(gpart, parted, growpart) 命令等，使用镜像创建实例后，根分区会自动扩容。例如您的镜像空间大小是20 GB，创建实例时系统盘大小为100 GB，则实例创建后，根分区会自动扩容至100 GB
Supported - 满足
NotSupported - 不支持
建议修复：
当操作系统为 CentOS 6, CentOS 7, TencentOS Server 2版本。
# root用户
yum install cloud-utils-growpart
当操作系统为 CentOS 8, CentOS Stream, Rocky Linux, TencentOS Server 3版本。
# root用户
dnf -y install cloud-utils-growpart
当操作系统为 Ubuntu。
# root用户
apt-get install cloud-guest-utils
Network
镜像中网络配置是否符合 cloud-init 标准
此项只对操作系统 Debian 和 Ubuntu 进行检查
Supported - 满足
Unsupported - 不支持
建议修复：
/etc/network/interfaces中必须包含source /etc/network/interfaces.d/*
SupportBareMachine
镜像是否支持裸金属
Supported - 满足
Unsupported - 不支持
可选修复：
若您不使用裸金属实例，则无需关注；如镜像不满足裸金属实例要求，您可以联系客服协助
TimeSync
是否安装有 NTP，保持时间同步
Supported - 满足
Unsupported - 不支持
可选修复：
当操作系统为 CentOS 6, CentOS 7, TencentOS Server 2版本。
# root用户
yum install ntpd
当操作系统为 CentOS 8, CentOS Stream, Rocky Linux, TencentOS Server 3版本。
# root用户
dnf install chrony
当操作系统为 Ubuntu。
# root用户
apt-get install ntp

Windows 操作系统检测项及说明如下：

检测项
检测说明
检测结果
修复建议
Virtio
镜像中 virtio 驱动是否安装
Supported - 满足
BlkDriverNotFound - 磁盘驱动未找到
强烈建议修复：
修复请参见文档 制作 Windows 镜像 中检查或安装 Virtio 驱动部分的指引。
Cloudbase
镜像中是否安装 cloudbase
Supported - 满足
NotSupported - 不支持
强烈建议修复：
CloudbaseConfig
cloudbase 配置是否正常
Supported - 满足
NotSupported - 不支持
强烈建议修复： 修复请参见文档 修改 cloudbase-init 配置文件。
SupportBareMachine
镜像是否支持裸金属
Supported - 满足
NotSupported - 不支持
可选修复：
若您不使用裸金属实例，则无需关注；如镜像不满足裸金属实例要求，您可以联系客服协助。
自助驱动下载地址：
Windows Server 2016
Windows Server 2019
下载下来的文件是 zip 文件，解压之后，右键bnxtnd.inf 文件，选择安装。

中国站
文档反馈
文档活动
message-icon联系我们
目录