文档中心

云服务器

导入自定义镜像

导入自定义镜像

导入自定义镜像

本章节介绍如何上传自定义镜像，上传成功后，即可使用该镜像创建实例。

前提条件

条件	说明
依赖功能	导入自定义镜像需配合对象存储与快照产品实现，请确认您当前账号已开通对象存储、快照产品服务。
权限	首次使用时，需授权ECS官方服务账号可以访问您的对象文件。确认授权。
镜像文件	您需要参考制作Linux镜像、制作Windows镜像在本地制作符合条件的镜像文件。镜像文件需满足如下限制：镜像文件格式为QCOW2、RAW、VHD、VMDK。镜像文件大小：单个镜像文件大小需不超过2 TiB。整机镜像包含的系统盘镜像文件与数据盘镜像文件大小之和，需不超过32 TiB。说明若超过限制，您可以通过服务器迁移中心（SMC）迁移数据至平台自定义镜像。

操作步骤

步骤一：上传镜像文件

导入镜像前，您需要先将镜像文件上传到对象存储TOS服务，并授权后台服务可访问TOS的对象地址。

注意

如需导入包含系统盘、数据盘的整机镜像，请根据本步骤指引分别将系统盘、数据盘镜像文件上传至TOS。

登录对象存储控制台。

在顶部导航栏选择目标存储桶所在项目。

单击存放镜像文件目标存储桶名称，进入存储桶详情页。

注意

目标存储桶“区域”需与您期望导入镜像的地域相同，您也可以按需创建新存储桶。

上传镜像文件。

在左侧目录树选择“文件列表”。

单击“上传文件”按钮，进入上传文件配置页面。

根据上传文件指引，选择待上传的镜像文件并单击“上传”按钮，开启上传流程。

获取镜像文件URL。

上传完成后，单击目标文件右侧“操作”列下的“详情”按钮，进入文件详情页面。

单击“URL”右侧复制按钮，获取文件的URL。格式为https://{桶名}.{TOS域名}/{object路径}。

步骤二：导入镜像

登录镜像控制台。

在顶部导航栏，选择期望导入生成的自定义镜像所在地域。

选择“自定义镜像”页签。

（可选）若您已开通快照服务请跳过本步骤，否则，请将鼠标悬浮至“导入镜像”按钮上，在弹窗中勾选“点击开通表示您知悉并同意《云服务器服务条款》”并单击“开通”按钮。

开通快照服务后，单击“导入镜像”按钮，填写如下信息。

参数	说明	取值示例
地域	导入后镜像所在的地域。说明选择后，该镜像只能为该地域中的资源所用，不可迁移。如需更换地域，请在顶部导航栏选择目标地域。	华北2（北京）
镜像文件地址	请填入上传镜像文件获取的系统盘镜像URL。	https://test.tos-cn-beijing.volces.com/ubuntu.qcow2
镜像名称	配置镜像的名称。	image-1
操作系统	选择待上传镜像的平台和版本。如果您的镜像的操作系统是根据Linux内核定制开发的，请提交工单联系我们。	CentOS-8.3
云盘配置（可选）	导入包含数据盘的镜像时，需开启本选项并配置数据盘信息。勾选“配置云盘属性”。系统盘参数已默认填写，且默认挂载至/vda目录，无需改动。单击“增加数据盘”按钮，填入上传镜像文件获取的目标数据盘镜像URL。说明最多支持添加15块数据盘。	-
镜像架构	选择镜像架构，支持x86_64和arm64镜像架构。	x86_64
启动模式	选择镜像的启动模式，支持BIOS和UEFI启动。说明请确保设置的启动模式与镜像本身支持的启动模式相匹配，否则使用该镜像创建的云服务器实例将无法正常启动。弹性裸金属型规格的云服务器，仅支持使用UEFI模式启动，在其他实例规格上运行的镜像默认为UEFI启动模式。	UEFI
许可证类型	选择激活操作系统的许可证类型。取值：火山引擎官方许可证：使用平台官方提供的许可证激活操作系统。自带许可证（BYOL）：使用您镜像自带的许可证（Bring Your Own License，BYOL）激活操作系统。说明导入Red Hat Enterprise Linux、 SUSE Linux Enterprise Server镜像时，仅支持选用自带许可证（BYOL）。	火山引擎官方许可证
镜像检测（可选）	是否启用镜像检测功能。本功能可检测您的自定义镜像是否满足平台镜像规范，避免自定义镜像无法创建出正常运行的平台云服务器。了解更多。说明镜像检测流程将在自定义镜像创建完成后开启，检测失败或未通过检测也不会阻塞创建、导入自定义镜像流程。	-
所属项目（可选）	选择自定义镜像所属的项目。选定项目后，导入的自定义镜像只能被具有该项目权限的用户查看、使用。如果下拉框中没有项目可以选择，可以根据新建项目指引进行新建。导入成功后，如果需要调整镜像所属项目，可查看项目资源管理。说明项目是一组资源的集合，您可以将自定义镜像添加到项目中并按项目进行分类和管理，还可以控制项目内用户和角色对自定义镜像的权限。了解更多。	projectA
标签（可选）	标签由一个键值对（Key-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者或环境等）对具有相同特征的云资源进行分类，便于搜索和聚合，从而轻松管理云上资源。单击“+”图标，输入标签键和标签值，为镜像添加标签。更多信息，请参见标签概述。	Key:Value

单击“确定”按钮，创建一个导入镜像任务，镜像状态为创建中，同时可在状态下方查看导入进度。

步骤三：查看导入结果

登录镜像控制台。

在顶部导航栏，选择目标镜像所在地域。

选择“自定义镜像”页签。

查看目标镜像状态。

状态	说明
创建中	表示镜像正在创建，请等待创建完成。
可用	表示镜像已完成创建且未发现异常，可以正常使用。
错误	表示镜像存在异常，无法正常使用。

相关文档

ImportImage

ModifyImageAttribute

最近更新时间：2025.10.29 11:49:31

这个页面对您有帮助吗？

有用

有用

无用

无用