全部文档
当前文档
最近更新时间：2026-10-08 10:01:33
本文介绍如何将私有镜像导入金山云云服务器（KEC）控制台，涵盖Linux和Windows镜像的导入要求、准备工作、操作步骤以及常见错误提示说明，帮助您顺利完成镜像导入并用于创建实例或重装系统。
导入的镜像不支持创建联网增强型实例。
如需导入的镜像支持扩容系统盘，请参考自动扩容系统盘安装资源包。
目前支持 RAW、VHD、QCOW2 和 VMDK 格式，其他格式镜像可参考镜像格式转换相关内容，进行转换。
Linux 镜像的功能限制与要求如下表所示。
功能 | 详细描述 |
|---|---|
密码与账号 |
|
网络相关 | 网络接口：可支持双网卡。 |
驱动与防火墙 | 驱动：安装 KVM virtio 驱动。 |
Linux 镜像的基础环境和关键配置等要求如下表所示。
类别 | 详细要求 |
|---|---|
标准镜像类型 | CentOS 6、CentOS 7、CentOS 8 |
基础环境要求 |
|
关键配置要求 | 为保证系统的正常创建与启动，必须遵守下列对配置文件的要求： |
Windows 镜像的功能限制与要求如下表所示。
功能 | 详细描述 |
|---|---|
密码与账号 |
|
驱动与网卡 |
|
防火墙与启动文件 |
|
Windows 镜像的基础环境等要求如下表所示。
项目 | 限制内容 |
|---|---|
标准镜像类型 | Windows Server 2022 R2 Datacenter 64 位中文版本 |
基础环境要求 |
|
导入镜像之前，需要完成如下准备工作：
按照金山云镜像要求制作镜像。
对于 Linux 镜像，运行镜像检测工具检查镜像是否满足导入要求。
开通对象存储（KS3）服务，创建目标地域下的存储空间（Bucket），并将制作好的镜像上传到存储空间。
确认已授权 KEC 官方服务账号访问 KS3 资源的权限。子用户默认无权限操作服务授权，需要主账号给子用户授权，授权流程可参考附录。
登录云服务器 KEC 控制台。
在左侧导航栏中，选择镜像，默认进入自定义镜像管理页面。
在自定义镜像管理页面，点击导入。
确保导入前准备页面的各项工作均已完成，并单击下一步。
根据页面提示，配置镜像参数，配置过程中需要注意如下信息：
参数 | 是否必须 | 说明 |
|---|---|---|
地域 | 是 | 系统默认获取当前在自定义镜像管理页面所选地域，必须与创建的存储空间在同一地域。 |
镜像文件地址 | 是 | 输入镜像所在存储空间的地址，形如 |
镜像名称 | 是 | 输入镜像名称，镜像导入成功后该名称将显示在自定义镜像列表中。 |
操作系统 | 是 | 当前导入镜像的具体操作系统版本，可点击下拉框进行选择。 |
系统架构 | 是 | 支持选择 |
启动模式 | 是 | 用于指定操作系统的引导方式，不同模式对操作系统版本和驱动支持有要求。请选择与镜像实际引导方式一致的启动模式，否则可能导致实例无法启动。ARM架构的实例规格仅支持UEFI启动。 |
镜像格式 | 是 | 当前仅支持raw、qcow2、vmdk、vhd的镜像格式。若镜像文件不符合上述格式，请先完成格式转换后再进行导入。 |
云盘配置 | 是 | 勾选该参数，默认沿用镜像中的系统盘配置。如需新增数据盘，点击添加云盘，输入数据盘镜像地址并设置数据盘容量范围为 |
高级设置 | 否 |
|
关联快照的所属项目 | 是 | 根据实际情况选择相应项目即可。 |
单击确定，等待系统完成镜像导入，其状态变为可用。
镜像导入耗时可能过长，请耐心等待，其相关错误提示及原因可参考附录内容。
主账号给子用户授权流程如下：
确定所需授权的操作项，如下表所示：
中文名称 | Action |
|---|---|
创建角色 | CreateRole |
附加角色访问策略 | AttachRolePolicy |
设置角色查看所有项目 | SetRoleViewAllProject |
查询角色基本信息 | GetRole |
主账号用户参考创建自定义授权相关内容，在设置策略类型区域选择策略语法类型，输入自定义策略代码，代码如下：
{
"Version": "2015-11-01",
"Statement": [
{
"Sid": "Stmt16460307498350",
"Effect": "Allow",
"Action": [
"iam:CreateRole",
"iam:AttachRolePolicy",
"iam:SetRoleViewAllProject",
"iam:GetRole"
],
"Resource": "*",
"Condition": []
}
]
}输入代码后，单击确定，完成自定义策略创建。
将此自定义策略授权给子用户。
单击同意授权，即可完成授权。子用户再次登录后，即可拥有访问 KS3 资源的权限。
导入镜像耗时较长，一般需要数小时，具体时长取决于镜像文件大小和当前导入任务的繁忙程度。
导入过程中，系统将会进行简单的镜像规范检查并给出错误提示。常见错误说明如下表所示。
提示信息 | 原因分析 |
|---|---|
格式不符合条件 | 镜像格式错误，仅支持 RAW、VHD、QCOW2 和 VMDK 格式。若想改变镜像格式，请参考镜像格式转换。 |
| Windows 镜像中未检测到 |
镜像文件分区错误 | 镜像没有分区。 |
Windows 镜像中未安装驱动 | 相关驱动文件 |
镜像系统盘大小不匹配 | 可能的原因有： |
格式不符合条件或与填写的不匹配 | 可能的原因有： |
缺少系统信息文件 | 可能的原因有： |
若出现以上错误信息提示，需要按照上述镜像要求重新制作镜像并上传至 KS3 存储空间。如果遇到未知错误，请联系金山云客服。
纯净模式