镜像制作

云桌面镜像的初始来源是操作系统厂商提供的安装盘 ISO 文件。由于从原始 ISO 开始安装操作系统及配置环境的过程较为繁琐，且镜像文件体积较大（通常在 10G~30G 以上），制作过程重复，因此现实中我们通常推荐 基于已经制作好的 QCOW2 镜像文件进行二次加工，以提高部署效率。

一、镜像操作系统要求

Windows：
- Windows 7 x64 SP1
- Windows 10 x64（推荐 22H2 版本）
- Windows 11 x64（推荐 23H2 版本；24H2/25H2 等更高版本目前存在部分兼容性问题，待后续版本解决后再行提供）
Linux：
- Ubuntu 22.04 或以上版本
- 统信 1060 或以上版本
- 麒麟 V10 SP1 或以上版本
- Deepin 20.6 或以上版本
- 中科方德 NFSDesktop 5.0 或以上版本

重要提示：

关于支持的操作系统与 CPU 架构详见产品简介 -> 技术架构 -> 代理端 -> 三、支持的操作系统与 CPU 架构章节。我们目前仅预制了部分常用的镜像。如果您需要的镜像在支持列表中，但我们并未预制，请联系厂商技术支持。我们会协助您完成从 ISO 到 QCOW2（用于 KVM 虚拟化）的镜像制作。注意：对于非 QCOW2 格式的镜像制作，我们不做承诺。

二、镜像制作过程建议

如果您在业务上确实需要基于操作系统官方发布的原始 ISO 文件制作虚拟机镜像，由于步骤涉及复杂的底层驱动加载与系统初始化，请务必参考我们版本发布目录配套的 《VDI 镜像制作手册》。该手册提供了详尽的图文步骤，指引您完成从 ISO 到 QCOW2 镜像的转化。

在已有基础镜像的基础上，推荐的二次加工流程如下：

资源入库：将配套的基础镜像文件上传到底层云平台，并在已添加的云平台处进行镜像资源同步。
创建专用桌面：在云空间中创建一个“专用桌面池”，并基于该基础镜像创建一个 专用桌面。

核心提示：必须确保虚拟机成为云空间中的“桌面”对象。如果仅仅是在 IaaS 平台直接创建虚拟机，其内部的代理端组件（Mole）即使指向了管理端，也不会被管理端接纳，导致无法建立联系。
定制化操作：通过 Web 控制台或远程工具进入桌面，执行以下操作：
- 按需对操作系统进行深度优化。
- 更新代理端组件（详见下文）。
- 安装 QGA：必须安装 qemu-guest-agent，系统后续通过云平台执行“重置密码”等指令依赖此组件。
- 安装平台插件：若底层为ZStack等云平台，还需安装其官方提供的类似 vmtools 的增强工具包。
- 安装业务所需的各类应用软件及个性化配置。
保存镜像：
- 方式 A：在云空间租户控制台中，将该云桌面执行“创建镜像”操作。此镜像将作为该租户的 自定义镜像。
- 方式 B：在底层云平台中基于该虚拟机保存为新镜像，随后在云空间系统控制台中云平台处通过“同步镜像”将其导入为 系统镜像（供所有租户使用）。

三、更新云空间代理端组件

代理端组件是实现桌面管理与协议连接的核心。由于提供的基础镜像中通常预装了旧版本的 Mole，在制作新镜像前必须将其更新至与当前管理端匹配的版本。

3.1 准备工作

在操作之前，请确保系统管理员已在系统控制台 -> 版本管理 -> 代理端版本章节中上传了最新的代理端安装包，并将其设置为 默认版本。

3.2 更新流程（推荐通过 Mole 自动升级）

1. 配置指向与连接

在桌面内运行 Mole 配置工具，将 Mole 指向云空间主管理节点的 IP。

Windows 桌面：
- 文件路径：C:\Program Files\Mole\moleConfig.exe
- 操作说明：在 Mole 配置界面的 AS6 地址 栏填写主管理节点的 IP 地址，点击应用配置。
Linux 桌面：
- 文件路径：/opt/apps/mole/run_moleconfig.sh
- 操作说明：请确保使用 sudo 权限运行。配置逻辑及状态检查与 Windows 类似。

2. 状态确认与自动升级

状态检查：应用配置后，Mole 服务会自动重启。待重启完成后，若连接状态显示为 已连接到AS6，则表示通信建立成功。
触发升级：成功建立联系后，Mole 会自动检测管理端的默认版本，并顺序触发 HSRServer、USBRedirect 和 Mole 自身的后台静默升级流程。

3. 检查验证

请耐心等待 1-3 分钟，待升级进程结束后，检查 Mole 配置界面中的版本号。确认 Mole、HSRServer 和 USBRedirect 的版本已成功升级至管理端指定的“默认版本”即可。

四、核心运维说明

环境一致性：请确保提取镜像的专用桌面在制作期间网络通畅，以便 Mole 能够顺利完成组件升级。
版本校对：在保存镜像前，务必确认所有代理端组件已显示为“最新”或“默认版本”，避免新镜像创建的桌面出现版本不匹配。

注意：虽然可以手动在虚拟机里下载并安装最新版的 Mole、HSRServer 和 USBRedirect，但我们更推荐通过 Mole 自动升级机制来完成，以确保组件版本的一致性与稳定性。