注意：说明：
注意：由于镜像底层使用了云硬盘快照服务：
一、导入准备
你需提前准备好符合导入限制的镜像文件。
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 驱动镜像需安装 cloud-init，详情参见 Linux 导入镜像安装 cloud-init如因其它原因，镜像无法安装 cloud-init，请根据 强制导入镜像 自行配置实例 |
| 文件系统 | 为了确保 Linux 系统在启动文件系统时能够正确识别磁盘，请你检查并正确配置 GRUB 文件磁盘标识方式。详情参见 配置 GRUB 文件磁盘标识方式为 UUID。为了确保 Linux 系统在挂载文件系统时能够正确识别磁盘，请你检查并正确配置 fstab 文件磁盘标识方式。详情参见 配置 fstab 文件磁盘标识方式为 UUID。 |
| 内核限制 | 镜像最好是原生内核，修改可能会导致云服务器无法导入 |
| 地域限制 | 境外地域导入镜像服务仅支持同地域 COS 文件，即需用同地域 COS 链接导入 |
| 镜像属性 | 条件 |
| 操作系统 | Windows Server 2008R2 /2012R2 /2016 /2019 /2022 /2025、Other Windows(Win10/Win11等） |
| 镜像格式 | 支持 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 驱动下载地址如下，请对应实际网络环境进行下载：公网下载地址：https://mirrors.tencent.com/install/windows/virtio_64_1.0.9.exe内网下载地址：https://mirrors.tencentyun.com/install/windows/virtio_64_1.0.9.exe |
| 地域限制 | 境外地域导入镜像服务仅支持同地域 COS 文件，即需用同地域 COS 链接导入 |
| 其他 | 导入的 Windows 系统镜像不提供 Windows 激活 服务 |
二、导入步骤
1. 登录云服务器控制台，单击左侧导航栏中的 镜像。选择自定义镜像，单击导入镜像。
2. 根据操作界面要求，先 开通 COS，再 创建 bucket 存储桶，上传对象 镜像文件到 bucket 并 获取镜像文件 URL（建议你复制临时链接 URL 用于镜像导入）。
3. 单击下一步。按照实际情况，填写表单，单击开始导入。
| 参数名称 | 必填 | 说明 |
| 地域 | 是 | 确定你导入的自定义镜像所在地域，请与你需要创建实例的地域保持一致，本地域的自定义镜像不可直接用于其他地域创建实例；若其他地域需要使用当前镜像，可以使用 复制镜像 跨地域复制你的自定义镜像。 |
| 系统盘文件 | 是 | 系统盘文件包含了服务器操作系统的内核、库文件、驱动程序等核心组件，通过系统盘文件，服务器能够启动并运行操作系统，从而提供基础的服务和功能。导入方式从 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-initWindows 镜像导入，可以参见文档 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-userInvalidDatasourceList – datasource_list 中没有 ConfigDrive | 强烈建议修复：1. 修改 cloud-init 配置文件： 根据不同操作系统，下载 cloud.cfg。点此下载 Ubuntu 操作系统的 cloud.cfg。点此下载 CentOS 操作系统的 cloud.cfg。点此下载 OpenSUSE / SUSE 操作系统的 cloud.cfg2. 将 /etc/cloud/cloud.cfg 的内容替换为已下载的 cloud.cfg 文件内容。 |
| Fstab | 镜像中 /etc/fstab 文件配置了系统磁盘设备挂载信息，错误的配置会导致系统启动异常，例如配置的挂载设备信息不存在、设备 UUID 错误等 | Supported – 满足DeviceNotFound – 配置中有设备不存在DeviceConfig – 使用的是 /dev/vd* 的配置项 | 建议修复：1. 若你的操作系统非 FreeBSD，修复参见文档 配置 fstab 文件磁盘标识方式为 UUID。2. 若你的操作系统是 FreeBSD。添加 Label。# 设置Labeltunefs -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 的方式配置的 | 建议修复：修复参见文档 配置 GRUB 文件磁盘标识方式为 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 – 不支持 | 强烈建议修复：修复请参见文档 Windows 操作系统安装 Cloudbase-Init。 |
| CloudbaseConfig | cloudbase 配置是否正常 | Supported – 满足NotSupported – 不支持 | 强烈建议修复： 修复请参见文档 修改 cloudbase-init 配置文件。 |
| SupportBareMachine | 镜像是否支持裸金属 | Supported – 满足NotSupported – 不支持 | 可选修复：若你不使用裸金属实例，则无需关注；如镜像不满足裸金属实例要求，你可以联系客服协助。自助驱动下载地址：Windows Server 2016Windows Server 2019下载下来的文件是 zip 文件，解压之后，右键 bnxtnd.inf 文件，选择安装。 |