云平台概述

云空间管理端以多台虚拟机的形式部署在 IaaS 虚拟化云平台上。它支持接入一个或多个云平台，将其作为底层基础算力资源池。管理端通过调用这些云平台的 API 接口，实现资源同步、桌面虚拟机的创建与日常维护。

在完成版本上传、了解租户与角色权限后，添加云平台是为新部署好的云空间提供算力资源的第一步。在现实场景中，访问不同的云平台所需的接入信息内容格式不尽相同。

提示：本章节主要介绍云平台接入的共性流程与参数。针对不同云平台类型（如 OpenStack、ZStack 等）特有的接入属性字段和详细配置，我们将在后续的各云平台创建专项章节中展开详细说明。

一、云平台适配与能力差异

在添加云平台前，请务必参考安装部署 -> 部署管理端 -> 环境要求核对已适配的云平台及版本号。

不同云平台在项目抽象、资源同步及桌面管理能力上存在显著差异，请参考下表：

维度	功能项	OpenStack	SmartX	UCloud	WxStack	ZStack
项目概念	项目定义	项目	虚拟机组	项目	业务组	云主机分组
云平台同步	模板	无	有	无	有	无
	镜像	有	无	有	无	有
	规格	有	无	无	无	有
	共享网络	有	无	有	有	有
	磁盘类型	有	有	有	有	有
项目同步	项目/实例	有	有	有	有	有
	私有网络	有	有	无	无	无
	云硬盘	有	有	有	有	有
自定义创建	自动创建项目	支持	未支持	未支持	未支持	支持
	自定义规格	未支持	未支持	未支持	未支持	支持
桌面管理能力	桌面同步导入	支持	支持	支持	支持	支持
	桌面创建	支持	支持	未支持	支持	支持
	桌面删除	支持	支持	未支持	支持	支持
	控制台	支持	未支持	未支持	未支持	支持
	开机/关机/重启	支持	支持	支持	支持	支持
	重置密码	支持	支持	支持	支持	支持
	还原/变更桌面	支持	未支持	未支持	未支持	未支持
	创建镜像	支持	不支持	未支持	不支持	支持

在添加云平台时，以下共性参数直接影响客户端的连接体验：

关联接入网关：当客户端从公网接入时，关联的接入网关集群将为该云平台内的云桌面提供公网接入与转发服务。
接入网段（IPv4/IPv6 公网与内网）：
- 识别逻辑：当桌面拥有多个网口时，系统会根据客户端接入位置进行地址识别。
- 内网接入：若客户端在内网，管理端会将匹配内网网段后的某一个网口的地址返回给客户端，供客户端直接通过 HSR 协议连接。
- 公网接入：若客户端在公网，管理端会将匹配公网网段后的某一个网口的地址返回给客户端，供客户端通过接入网关中转连接。
- 重要性：若桌面拥有双网口，必须准确配置此项，否则可能导致云桌面 IP 地址缺失，表现为客户端无法获取桌面 IP 地址，无法进行远程连接。

系统添加成功后，管理端将自动与底层云平台建立通信并启动资源同步流程。

首次同步：添加云平台后系统不会立即同步，需等待约 20 秒 后才自动触发首次资源同步。
定时循环：系统会在间隔 40~80 分钟 随机触发自动同步（平均每小时一次），以确保资源状态的最终一致性。
手动干预：
- 检测：点击“检测”按钮快速判断 API 接口通达性（验证网络、账号、密码是否正确）。
- 强制同步：若自动同步未及时触发，或底层资源有紧急变更，可点击表格右侧 “更多 -> 同步” 手动触发。

管理员可实时跟踪资源的加载状态：

若云平台状态异常或同步失败，请参考下表进行排查：

现象	可能原因	处理建议
云平台离线	API 地址、用户名或密码填写错误；网络不通	检查云平台接入参数，使用“检测”功能验证 API 连通性。
同步超时	网络延迟较大；底层平台响应缓慢	尝试点击“手动同步”；检查管理端与云平台间的带宽延迟。
特定资源缺失	资源未匹配“分组前缀”；底层权限不足	检查云平台端的资源分组命名；确保使用的账号具备系统管理员权限。
其他持续失败	适配层接口异常或版本不兼容	收集同步详情中的错误提示、云平台型号及版本号，联系厂商技术支持。