# 扫描本地镜像安全
#### 操作场景
集群节点或非集群节点安装企业主机安全Agent成功后，Agent会立即启动镜像同步任务，将节点本地镜像信息同步至企业主机安全控制台；此后每2.5小时进行一次信息更新同步。
您在查看到本地镜像信息后，可手动执行镜像安全扫描，检测本地镜像安全。
#### 手动扫描本地镜像
1. [登录企业主机安全控制台](https://console.huaweicloud.com/hss/?locale=zh-cn)。
2. 在控制台左上角，单击![](https://support.huaweicloud.com/usermanual-hss2.0/zh-cn_image_0000002384023862.png)图标，选择区域或项目。
3. 在左侧导航栏，选择"风险预防 \> 容器镜像安全"，进入"容器镜像安全"界面。
4. 在页面右上方，单击"手动扫描"，弹出手动扫描对话框。 
   如仅需扫描单个镜像，您也可以选择"镜像视图"，在目标镜像所在行的"操作"列，单击"立即扫描"。
   
   
5. 选择"本地镜像"页签，配置手动扫描参数，相关参数说明请参见[表1]。
   
   图1手动扫描本地镜像   
   ![](https://support.huaweicloud.com/usermanual-hss2.0/zh-cn_image_0000002659275641.png "点击放大")
    表1手动扫描本地镜像参数说明 
   | 参数名称   | 参数说明                                                                                                                                                                                                                                                                                                                                                                 | 取值样例 |
   |:---|:---|:---|
   | 扫描风险类型 | 需要扫描的风险类型： - 漏洞风险：检测镜像中存在系统漏洞、应用漏洞。  - 基线检查：OpenClaw应用基线检查。  - 经典弱口令：检测容器中可能存在的弱口令。   HSS会默认扫描"软件信息"此处无需选择。 | 全选   |
   | 扫描镜像范围 | 选择扫描"全部镜像"或"指定镜像"。 全量扫描时间较长，且开始全量扫描后无法中断扫描，请谨慎操作！                                                                                                                                                                                                                                                                                    | 指定镜像 |
      
   
   
6. 单击"确定"，开始扫描。

7. 在页面右上角，单击"任务管理"，选择"镜像扫描"页签，可查看镜像扫描任务执行情况。 
   安全扫描的时长主要取决于镜像的大小。一般情况下扫描一个镜像可以在3分钟之内完成。
   
   
8. 镜像扫描任务执行完成后，返回"镜像视图"列表，可查看每个镜像的扫描状态。扫描状态说明请参见[表2]。
   
    表2扫描状态说明 
   | 状态名称 | 状态说明                  |
   |:---|:---|
   | 未扫描  | 表示镜像未进行扫描。            |
   | 扫描中  | 当前正在对镜像进行扫描。          |
   | 扫描成功 | 扫描镜像成功，可查看扫描结果。       |
   | 扫描失败 | 扫描镜像时遇到了错误或问题，导致扫描失败。 |
   | 等待扫描 | 已创建扫描任务，镜像正在排队等待扫描。   |
   | 扫描终止 | 扫描任务已取消，镜像被终止扫描。      |
      
   
   
 
#### 停止扫描任务
如果镜像扫描任务开始执行后，您想要停止扫描，可参考如下操作：
**约束限制**
- 停止扫描任务必须具备如下两类权限：
  - 企业主机安全服务权限：批量扫描镜像（hss:images:set）或容器资产管理（hss:containers:set）权限。
  
  - 命名空间权限（Kubernetes RBAC授权）：具有对HSS命名空间中"job"或"cronjob"资源的删除权限。
   
**操作步骤**
1. 在"容器镜像安全"界面右上角，单击"任务管理"，弹出"任务管理"页面。
2. 在"镜像扫描"页签，找到目标任务。
3. 在目标任务所在行的"操作"列，单击"取消扫描"。
4. 查看目标任务的"镜像扫描情况"列显示为"已取消扫描"，表示镜像扫描任务取消成功。
 
#### 相关文档
- 如需查看或处理本地镜像安全扫描结果，请参见[查看并处理本地镜像扫描结果](https://support.huaweicloud.com/usermanual-hss2.0/hss_01_0728.html)。
- 如需导出本地镜像安全扫描结果，请参见[导出本地镜像扫描结果](https://support.huaweicloud.com/usermanual-hss2.0/hss_01_0729.html)。