全部文档
当前文档
最近更新时间：2026-10-08 10:01:32
本文介绍金山云镜像规范检测工具的使用方法，包括适用平台、检测项及报告输出。可帮助您定位镜像不合规原因并生成检测报告，适用于制作符合规范的Linux自定义镜像场景。
云服务器支持使用自定义镜像创建实例。该自定义镜像可以是您基于线下服务器、虚拟机或者其他云平台的云服务器创建的。您导入的镜像需要满足一定镜像要求，更多详情，请参阅导入镜像须知。为缩短镜像制作及创建实例的周期，金山云推荐您使用此镜像规范检测工具，本文简称检测工具，制作符合规范的镜像。检测工具能基于服务器环境检测各项配置指标、定位不合规原因、生成 TXT 和 JSON 格式检测报告并给出解决意见。
目前检测工具仅支持检测 Linux 类型镜像，包括 Ubuntu、CentOS、Debian、RedHat、Fedora 和 Other Linux 发行版本。
登录服务器、虚拟机或者其他云平台的云服务器。
下载镜像检查工具。
使用 root 权限运行 image_check，也可使用 -p [目标路径] 命令指定检测报告的生成路径，不指定则默认输出到检测工具所在的路径。
chmod +x image_check #添加可执行权限
sudo ./image_check #执行镜像检查工具等待检测工具检测系统配置，并输出相应检测报告。报告格式为 image_check_report_日期_时间.txt 或 image_check_report.json。
该工具检查详细内容，可参看附录相关内容。
为避免使用您的自定义镜像创建的实例功能不全，检测工具主要检测服务器以下配置项。
检测项 | 不合规后果 | 合规建议 |
|---|---|---|
| 实例无法正常开机 | 安装虚拟化 |
| 无法修改密码文件，控制台变更密码服务将不能使用 | 不要使用 |
| 实例可能出现异常现象，影响使用 | 不要通过修改 |
| 实例网络功能不稳定 | 关闭或删除 |
| 无法从控制台远程连接实例 | 打开 |
| 实例可能出现异常现象，影响使用 | 关闭防火墙 |
| 实例创建失败、实例无法正常工作 | 使用 |
| 实例创建失败、实例黑屏 | 修改 |
| 无法使用用户名和密码远程连接实例 | 保留 |
| 实例无法新增用户 | 保留 |
| 无法正常启动实例 | 采用 MBR 分区 |
| 无法自动化配置实例 |
|
| N/A | 系统盘大小需要满足导入要求 |
| 无法为实例配置网络 | 保留足够的磁盘空间 |
| 无法为实例配置网络 | 保留足够的 |
| 无法登录实例 | 保证 Ubuntu 镜像中有 |
检测工具会根据检测项给出 OK、FAILED 或者 WARNING 检测结果。
OK：检测项均符合要求。
FAILED：检测项不符合要求，使用该自定义镜像创建的实例无法正常启动。建议您修复报错项，否则镜像在导入时会失败。
WARNING：检测项不符合要求，使用该自定义镜像创建的实例可以启动，但实例可能在使用时出现异常现象，影响您的效率。您可以选择立即修复，也可以暂时忽略问题。
检测系统环境后，会输出 TXT 和 JSON 两种格式检测报告。输出路径可以使用 -p [目标路径] 指定，不指定则默认输出在检测工具所在的路径。
TXT 格式报告名称为 image_check_report_日期_时间.txt，报告内容包括服务器配置信息以及检测结果。以 CentOS 6.8 64 位服务器为例：
The infomation you need to input when you import your image to Kingsoft Cloud website:
Current system is: CentOS 6.8 服务器操作系统及其版本
Architecture: x86_64 系统架构
System disk size: 21 GB 服务器系统容量
The program can obtain system version information from any of these files, but please ensure that these files retain the original content.
Do not modify /etc/issue, /etc/*release*, or /etc/debian_version (this file is not available for all distributions).
Failure to do so will result in the system's release being unrecognized and causing system creation to fail.
Check driver 检测项名称
Pass: kvm driver exists. 检测结果
Kingsoft Cloud supports kvm virtualization technology.
We strongly recommend installing kvm driver.JSON 格式报告名称为 image_check_report.json，报告内容包括服务器配置信息以及检测结果。以 CentOS 6.8 64 位服务器为例：
"platform":"CentOS", \\服务器操作系统
"os_big_version":"6", \\操作系统版本号（高位）
"os_small_version":"8", \\操作系统版本号（低位）
"architecture":"x86_64", \\系统架构
"system_disk_size":"21", \\服务器系统盘容量
"version":"1.0.0", \\检测工具版本
"time":"2018-07-13_23-42-21", \\检测时间
"check_items":[{
"name":"driver", \\检测项名称
"result":"OK", \\检测结果
"error_code":"0", \\错误码
"descrption":"Pass: kvm driver exists.", \\描述
"comment":"Kingsoft Cloud supports kvm virtualization technology. We strongly recommend installing kvm driver. "
}]
}报告中显示的服务器系统盘容量大小是近似值，单位为GB。检测时是精确到bit进行的。如果报告显示为21GB，但检查项
disk size为OK，则可以导入。
纯净模式