添加 WxStack 云平台
云空间管理端通过对接 WxStack 的 API 接口,实现对底层算力资源的纳管。由于 WxStack 平台的资源组织特性,在接入前需先在底层平台端完成基础的“业务组”准备。
一、 前置准备:创建业务组
目前管理端尚未支持通过 API 接口调用来动态创建 WxStack 业务组,因此需要管理员在 WxStack 控制台中预先创建好用于存放云桌面的业务组。
-
进入业务组管理: 在 WxStack 管理页面中,打开“业务组”管理页面。

提示:作为云桌面场景常用的模块,建议将“业务组”入口菜单标注星号,收藏到左侧导航栏。
-
命名规范与过滤机制: 输入业务组名称。核心逻辑说明如下:
- 逻辑映射:WxStack 的 业务组 对应云空间中的 项目。
- 安全过滤:为避免将非桌面用途的虚拟机(如管理端、接入网关或其他业务云主机)同步进云空间,系统采用“分组前缀”匹配机制。
- 命名建议:默认约定以 “VDI” 开头(如
VDI001)。只有匹配该前缀的业务组才会被纳管为“项目”。 - 对应关系:业务组 ↔ 云空间项目 ↔ 桌面池。这三者是一一对应的关系。
-
虚拟机准备(可选): 您可以预先在业务组中创建虚拟机,同步后将作为云桌面资源;也可以待项目同步完成后,在云空间桌面池中来创建桌面(推荐方式)。
创建好的虚拟机将位于指定的业务组中,方便后续同步管理。

二、 操作流程
-
配置 WxStack 属性: 输入 WxStack 平台的各项参数信息,然后点击 “确定”。

- 云平台地址:WxStack 管理节点的 API 访问地址。
- 用户/密码:具备系统管理权限的账号。
- 分组前缀:填写在 WxStack 中预设的业务组名称特征(默认值为
VDI)。
三、 核心运维逻辑
-
资源纳管策略:
- 仅处于被纳管项目(匹配前缀的业务组)中的虚拟机实例,才会被同步到云空间并映射为桌面。
- 安全隔离:请务必将管理端和接入网关虚拟机存放在不带 VDI 前缀的业务组中,以防止被同步进云空间系统造成误操作风险。
-
一致性说明: 上述关于“项目 ↔ 业务组/虚拟机组”以及“分组前缀过滤”的设计逻辑,在 SmartX 和 ZStack 云平台中同样适用。
注意:关于云平台添加后的自动同步机制、进度监控及异常排查,请统一参考 云平台概述 -> 三、 资源同步与管理机制 章节。


