设置

账户信息

子账户：子账户由admin创建或统一认证系统同步，且受admin管理，子账户对自己创建的虚拟资源拥有管理权限。子账户对作用域的资源可以进行创建、删除、分享、召回等操作，实现对资源归属及权限控制的细粒度划分。

旧术语	当前术语
第三方认证	统一认证SSO
第三方认证服务器	统一认证服务器
第三方认证系统	统一认证系统
第三方用户	统一认证用户
第三方子账户	统一认证子账户
第三方属性	统一认证属性

主题外观

主题外观：用户可自定义设置云平台主题外观。详情可参考《定制化主题外观》章节。

可用区管理

可用区管理：可用区是一套完整的云环境，具有独立的管理节点、网络、硬件和云资源。多个可用区间可实现用户同步和免密登录。

功能优势

多可用区管理：支持在云平台上添加多个可用区，并无缝切换，便捷操作各可用区中的资源，提升运维效率。
用户统一认证：支持多可用区用户信息同步和统一认证。不同可用区的用户可从统一入口登录云平台，免密访问全部可用区。

注意事项

ZStack Cloud UI默认不展示可用区管理界面，如需开启该界面，请联系官方技术支持。

管理可用区

可用区支持以下操作：

操作	描述
修改登录配置	修改统一登录地址。
添加可用区	添加一个新的可用区。 Note: 为确保用户信息同步成功，避免数据冲突，除首次添加的默认可用区外，建议其他可用区中不要预先设置用户信息。
同步数据	从数据源向其他可用区同步用户信息。 Note: 首次设置的默认可用区将作为数据源。如数据源被删除，则当前默认可用区将成为新的数据源。
修改可用区配置	修改可用区AccessKey、地址、管理服务端口、UI服务端口等信息。
设置为默认可用区	将可用区设置为默认可用区。 Note: 仅处于健康状态且用户信息同步成功的可用区可设置为默认可用区。
移除可用区	移除可用区。 Note: 移除后，将解除该可用区和其他可用区的关联关系，不再支持用户同步和无缝切换。如后续重新添加该可用区，可能产生用户信息冲突，导致添加失败，请谨慎操作。默认可用区不支持移除。

时间管理

时间管理：管理云平台时间和配置时间源，配置后云平台所有物理机将根据指定的时间源进行时间同步。

邮箱服务器

云平台报警选择邮箱类型的通知对象，需设置邮箱服务器，用来发送报警邮件。

注意事项

从ZStack Cloud 3.3.0开始，支持设置AD/LDAP、邮箱服务器的接连超时时间，设置方法如下：
进入/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties，在zstack.properties配置文件中设置如下参数：
- ```
# 设置AD/LDAP连接超时时间
Ldap.addServer.connectTimeout = XX
```
- ```
# 设置邮箱服务器连接超时时间
SNS.addEmailPlatform.connectTimeout = XX
```
- # 设置邮箱服务器读取数据超时时间
```
SNS.addEmailPlatform.readTimeout = XX
```
Note:
- 系统默认上述三个参数的超时时间均为5000（单位默认为ms）。
- 若需修改超时时间，可通过zstack-ctl configure命令进行修改，例如：
```
[root@localhost ~]# zstack-ctl configure Ldap.addServer.connectTimeout = 10000
[root@localhost ~]# zstack-ctl configure SNS.addEmailPlatform.connectTimeout = 10000
[root@localhost ~]# zstack-ctl configure SNS.addEmailPlatform.readTimeout = 10000
```
  设置完成后使用zstack-ctl restart_node命令重启管理节点生效。

日志服务器

日志服务器：添加日志服务器至云平台，收集管理节点或平台操作日志，可用于操作追溯和问题定位，提高云平台运维效率。

日志服务器类型

管理节点日志服务器：用于接收云平台管理节点日志。仅admin或平台管理员可以添加管理节点日志服务器。
Note: 需要设置日志设备类别与日志服务器的配置完全一致，才能正常接收日志信息。
平台操作日志服务器：用于接收平台操作日志。admin/平台管理员或项目用户均可添加平台操作日志服务器。
- 项目用户添加：仅可查看本项目下各个成员的操作记录。每个项目仅可添加一台平台操作日志服务器。
- admin/平台管理员添加：可查看云平台所有用户的操作日志。

高级监控服务器

高级监控服务器：一个定制的云主机，专用于接收和处理负载均衡等资源的高级监控数据。

SNMP管理

SNMP管理：启用后，用户可通过第三方平台直接监控云平台上的资源和事件，并接收云平台推送的报警消息。

如图 2所示：

操作	简介
启用SNMP管理	启用SNMP管理。
修改SNMP协议信息	修改SNMP协议信息，包括SNMP Agent端口、协议类型、团体字、用户名、用户鉴权、数据加密等参数。
添加SNMP Trap接收端	添加SNMP Trap接收端。 SNMP Trap接收端可以被添加为报警通知对象并绑定到指定报警器，绑定后，云平台将向该接收端推送指定的报警消息。
编辑SNMP Trap接收端	编辑SNMP Trap接收端的IP地址和端口号。
删除SNMP Trap接收端	删除SNMP Trap接收端。 Note: 如已将SNMP Trap接收端添加为报警通知对象，该通知对象将被同步删除。
下载MIB文件	下载云平台提供的MIB文件，用于第三方平台采集数据和解析报警消息。
停用SNMP管理	停用SNMP管理。停用后，第三方平台不再主动向云平台获取资源监控数据。但云平台仍将向已添加为通知对象的SNMP Trap接收端推送报警消息。停用后，云平台仍将保存SNMP相关参数，便于下次启用时直接使用。

全局设置

提供平台层面的功能特性设置，一经设置，云平台全局范围内生效。

在全局设置界面，点击右上角恢复全局设置按钮，全局设置将恢复至初始配置

全局设置包括基本设置与高级设置。ZStack Cloud支持上百种高级设置，用户可根据自身需求搜索并且修改对应的设置。

资源高级设置

ZStack Cloud支持使用高级设置对资源进行细粒度的特性配置，用户可根据自身需求搜索并且修改对应的设置。默认使用全局设置的值。

场景封装

基于用户实际生产场景需求，提供场景化的一键全局设置，方便快速将云平台设置为所需状态，提高运维效率。

支持以下四种场景封装模板：

生产推荐配置
高可用快速恢复
云主机性能调优
云平台安全配置

场景封装模板 | 云主机性能调优

本模板适用于云主机高性能场景，具体介绍如下：

云主机CPU模式：
- 选择云主机的CPU类型是否与物理机的CPU类型一致。可选模式为：none、host-model、host-passthrough。
  - host-model：云主机CPU型号与物理机CPU型号接近或一致，例如：都显示为Haswell Intel CPU。相比none模式，该模式下，云主机可继承所在物理机CPU较多特性。
  - host-passthrough：云主机CPU型号与所在物理机CPU型号一致。同时，云主机CPU特性与物理机CPU特性一致，例如：都支持扩展页表、大页内存以及虚拟化等。相比none、host-model和自定义模式，该模式继承的物理机CPU特性最多。
  Note:
  - host-passthrough模式支持云主机的嵌套虚拟化，但该模式可能导致云主机在不同型号CPU的物理机之间迁移失败。
支持内核aio：
在QEMU存储驱动中使用内核异步IO。
SharedBlock云盘预分配策略：
用于设置SharedBlock中云盘的预分配策略，可选策略为none, metadata。
云主机Hyper-V开关：
云主机Hyper-V模拟的开启或关闭。

场景封装模板 | 高可用快速恢复

本模板适用于云主机高可用场景。

Note:

该场景适用于中小型集群且网络环境良好的场景。若集群规模较大或网络环境不稳定，启用后HA敏感度会很高，可能造成云主机重启。
该场景下网络波动可能导致物理机失联，请确保网络环境稳定。
应用"高可用快速恢复"模板后，所涉全局设置条目将同步修改，需重连物理机生效。

具体介绍如下：

异常物理机检查间隔：
单位为秒，用于设置在指定的时间间隔去检查一个异常的物理机。
判定物理机失联前尝试连接次数：
单位为次，用于设置系统尝试连接物理机的最大次数，如超过该次数仍无法连接到物理机，则判定该物理机失联。
判定物理机连接成功Ping返回时间：
单位为秒，用于设置系统 Ping 物理机并取得返回的时间限制，如果在该时间范围内，系统 Ping 通物理机并获得返回，则判定系统与物理机成功建立连接。
判定物理机恢复连接前最小连接成功次数：
单位为次，用于设置判定失联物理机恢复连接前，系统需要与该物理机成功建立连接的次数，只有达到该次数，系统才会判定该物理机连接正常。
判定物理机恢复连接的连接成功率：
系统与失联物理机建立连接时，如出现既有失败、又有成功的情况，成功连接数占尝试连接总数的比例需达到此数值，系统才会判定该物理机连接正常。
物理机自检间隔：
设置物理机状态自检的间隔。
物理机自检最大尝试次数：
用于设置在指定的最大次数去自检物理机，在最大的尝试测试次数均失败时，会判定物理机网络异常。
物理机连接主存储超时时间：
单位为秒，如在该时间内物理机无法与主存储连接，则判定物理机连接主存储超时。
高可用尝试启动云主机最大时间间隔：
单位为秒，用于设置 NeverStop 云主机异常关机后，系统执行 GC（垃圾回收）任务以实现高可用启动的时间间隔。
高可用云主机状态扫描间隔：
单位为秒，用于设置 NeverStop 云主机高可用启动失败后，下次扫描的时间间隔。
高可用启动云主机重试时间间隔：
单位为秒，用于设置 NeverStop 云主机上一次尝试高可用启动失败后，到尝试下一次高可用启动间的时间间隔。
物理机连接状态快速探测开关：
用于设置是否开启物理机连接状态快速探测。若为true，则会缩短探测物理机连接状态的时间间隔。
检查计算节点失败阈值：
单位为次，管理节点在检查计算节点时，尝试检查时允许的最大失败次数。
物理机重连SSH超时阈值：
单位为秒，用于设置重连物理机时测试物理机SSH超时的时间。若时间结束仍未SSH成功则表示物理机重连失败。
物理机内部关机HA时间优化服务：
用于在物理机执行关机或重启操作时，自动关闭与之关联的云主机和sanlock锁，确保它们在物理机关闭之前能够安全地关闭。修改状态后，需重连物理机生效。

场景封装模板 | 生产推荐配置

本模板适用于生产环境场景，具体介绍如下：

物理机保留内存：
- 所有KVM主机上保留的内存容量。建议可用单位：T/G/M。
- 例如：512M表示为系统预留512M内存，当系统剩下700M的内存时，用户又希望启动一个内存为512M的云主机是无法启动的。
- 若资源已单独设置该选项，此全局设置将不对该资源生效。
主存储超分率：
- 主存储超分率允许的范围: [1.00, 1000.00] （1到1000之间数，如果是小数，最多两位）。
- 如果主存储可用空间为2T，设置为1.1，那么ZStack Cloud会认为系统可以分配2.2T主存储空间给云主机使用。
- 用户需理解并设置正确的主存储使用阈值后再进行配置：
  - 设置[1.0，1.2]：数值过大会影响云主机IO性能
  - 设置1.2以上：数值过大可能会严重影响存储压力或导致磁盘容量快速占满，导致系统IO错误
- 若资源已单独设置该选项，此全局设置将不对该资源生效。
内存超分率：
- 内存超分率允许的范围: [1.00, 1000.00] （1到1000之间的数，如果是小数，最多两位）。
- 如果物理内存为4G，设置为1.1，那么ZStack Cloud会认为系统可以分配4.4G内存给云主机使用。
- 该数值需要根据不同系统和应用的需求进行配置：
  - 设置[1.0，1.2]：数值过大会影响云主机内存性能
  - 设置1.2以上：数值过大可能会严重影响物理机内存性能，导致系统OOM（内存溢出）
- 在生产环境中，如果用户打算采用物理内存超分，建议在安装系统时，配置相应的swap分区。
  - 例如，如果物理机内存为100G，并打算设置物理内存超分为2，建议设置swap分区也为100G，这样的配置在实际使用中，有足够的swap空间供内存超分使用。
- 若资源已单独设置该选项，此全局设置将不对该资源生效。
本地存储在线迁移：
- 本地存储在线迁移的全局设置打开或关闭。
- 打开此开关，则支持本地热迁移。
- 本地存储上Windows的云主机不支持热迁移。
云主机高可用全局开关：
- 可以打开或者关闭云主机高可用功能。
- 如果关闭此选项，则云主机不支持设置高可用，云主机详情也不会显示高可用信息。
- 如果关闭此选项，将全局禁用高可用功能，请谨慎操作！
CPU超分率：
- 主要用于设置可分配的虚拟CPU个数。
- 如果物理机的CPU为四核八线程， ZStack Cloud会将物理机CPU的总线程（8）乘以处理器超分率的倍数（10）计算可分配的虚拟CPU的个数，即总量为80。
- 该数值需要根据不同系统和应用的需求进行配置：
  - 设置10以上：数值过大可能会严重影响物理机性能，导致业务性能卡顿
- 虚拟CPU的总数可以在首页的处理器的总量查看。
- 若资源已单独设置该选项，此全局设置将不对该资源生效。
主存储使用阈值：
- 为了防止系统过度使用主存储空间（尤其是当设置了主存储的超分比例后，过度分配云盘有可能使存储溢出，从而导致云主机存储失效崩溃），需要设置主存储阈值。
- 主存储使用阈值: (0, 1] 之间的小数，最多四位。
  - 例如，阈值为0.9，如果当前主存储空间实际使用率到达总容量的90%，整个系统将不能新建云主机或者云盘。
  - 此时用户需添加更多的云盘给主存储，并手动重新连接计算节点后，即可进行新建云盘操作。
- 当使用大于1的主存储超分率后，该阈值应设定为0.6或更小，以确保可及时添加主存储。
- 用户需完全理解该设置的含义，才能进行相应的设置。否则会有严重的数据丢失风险！
云主机跨集群高可用开关：
用于设置云主机跨集群高可用功能是否启用。若为true，表示允许跨集群探测物理机，实现云主机跨集群高可用。注意：需提前确认集群间连通性良好，才可启用该功能。
主存储保留容量：
- 用于设置主存储的保留容量。
- 主存储保留容量在 0 到 1T 之间，输入形如 (1-1023) G/M/K/B g/m/k/b 或（ 0,1）T/t。
镜像服务器保留容量：
- 用于设置镜像服务器在使用是的保留使用容量。
- 镜像服务器保留容量在 0 到 1T 之间，输入形如（1-1023） G/M/K/B g/m/k/b 或（ 0,1）T/t。
监控数据保留周期：
单位为月，监控数据在本地保留的周期，可设置1到12之间的整数。
租户/子账户云盘快照数量配额：
设置账户的云盘快照配额。
物理机密码加密存储开关：
用于设置物理机密码在数据库中的加密存储策略。可选策略为：None、LocalEncryption。
- None：不进行加密存储。
- LocalEncryption：使用云平台自带的加密功能进行加密存储。

场景封装模板丨云平台安全配置

本模板适用于强安全性的云平台场景，具体设置如下：

云平台登录IP黑白名单：
默认为false，用于设置是否开启IP黑白名单功能，开启后，云平台将对登录IP进行防护。
物理机密码加密存储开关：
用于设置物理机密码在数据库中的加密存储策略。可选策略为：None、LocalEncryption。
- None：不进行加密存储。
- LocalEncryption：使用云平台自带的加密功能进行加密存储。
禁止同一用户多会话连接开关：
默认为false，用于设置是否禁止同一用户多会话连接。若为true，则同一用户只能存在一个登录会话，历史会话将强制退出。
会话超时时间：
- 设定ZStack Cloud图形界面登录后会话多长时间失效。默认为：7200秒，即2小时。
- 当登录会话失效后，需要重新登录。
SSL证书检查开关：
用于设置是否开启跳过LDAP SSL证书的所有检查的开关。若为true，表示跳过所有LDAP SSL证书的检查。
云平台登录验证码策略：
用于设置是否启用登录控制中的验证码功能。开启后连续登录失败次数超过上限将触发验证码保护机制，要求输入正确的账户名、密码以及验证码才能成功登录云平台。
云平台登录密码更新周期：
- 云平台登录密码更新周期开关：
  默认为false，用于设置是否启用密码更新周期开关。若为true，表示允许设置密码更新周期。当密码使用时间达到所设置的密码更新周期，重新登录将提示修改密码。
- 密码更新周期：
  默认为90天，用于设置需要重设密码的周期。
云平台登录密码不重复次数：
- 云平台登录密码不重复次数开关：
  默认为false，用于设置是否启用密码不重复次数开关。若为true，表示允许设置密码不重复次数。在所设置的密码不重复次数范围内，重设密码时，新密码不能与之前已使用过的历史密码重复。密码不重复次数可配置。
- 密码不重复次数：
  默认为5，用于设置密码不重复次数，例如：若为3，则新密码不能与之前3次已使用过的历史密码重复。
云平台连续登录失败锁定用户：
- 云平台登录连续登录失败锁定账户开关：
  默认为false，用于设置是否启用连续登录失败锁定账户开关。若为true，表示连续登录失败数次，账户将被锁定一段时间。连续登录失败次数上限可配置。
- 连续登录失败次数上限：
  默认为6，用于设置连续登录失败次数上限。当连续登录失败次数超过设置值，账户将被锁定一段时间。
- 连续登录失败锁定账户时长：
  默认为10分钟，当连续登录失败触发账户锁定，用于设置账户的锁定时长。
云平台登录密码强度：
- 云平台登录密码强度开关：
  默认为false，用于设置是否启用密码强度开关。若为true，表示允许设置密码强度，包括设置密码长度范围，并可选择是否启用数字、大小写和特殊字符组合的策略。
- 密码强度：
  默认为8-32，用于设置密码长度范围，并可选择是否启用数字、大小写和特殊字符组合的策略。
云平台登录双因子认证开关：
默认为false，登录管理节点时，是否开启双因子认证。
VNC控制台密码强度：
- VNC控制台密码开关：
  默认为false，用于设置是否启用密码登录VNC控制台。
- VNC控制台密码强度：
  默认为6-32，用于设置VNC密码的长度范围，并支持选择是否启用数字、大小写和特殊字符组合的策略。
云主机密码强度：
- 云主机密码强度开关：
  默认为false，用于设置是否启用密码登录云主机。
- 云主机密码强度：
  默认为8-18，用于设置云主机密码的长度范围，并支持选择是否启用数字、大小写和特殊字符组合的策略。
  Note: 设置云主机密码需确保云主机镜像中已安装cloud-init，且cloud-init推荐版本为：0.7.9、17.1、19.4、19.4以后版本。

高可用策略

高可用策略（HA Policy）：云平台内计算、存储、网络资源发生故障或云主机异常停机时，确保相关业务持续稳定运行的机制。启用后，支持自定义云主机高可用策略，确保业务连续性。

故障场景	管理网络连接状态	存储网络连接状态	业务网卡状态	故障时是否迁移云主机
场景一：业务网卡状态异常	正常	正常	故障	开启/关闭
场景二：存储网络连接异常	正常	故障	正常	开启/关闭
场景三：存储网络连接异常、业务网卡异常	正常	故障	故障	如场景一、场景二均为关闭，此处固定为关闭；如场景一、场景二任一为开启，此处默认固定为开启
场景四：管理网络连接异常	故障	正常	正常	关闭，不支持开启

功能原理

ZStack Cloud高可用策略主要包括以下两种机制：

轮询检测云主机运行状态，若云主机由于自身异常关机或计划性关机，将检测云主机的高可用模式。若云主机为NeverStop模式，将在所在物理机或其他物理机上重启该云主机。
如图 3所示：
图 3. 云主机自身异常关机后高可用启动
轮询检测云主机所在物理机状态，若物理机管理网络连接状态、存储网络连接状态、业务网卡状态任一状态异常，将检测云主机故障迁移策略以及云主机高可用模式。若对应故障迁移开关已打开，且云主机高可用模式为Neverstop，云主机将迁至其他物理机上启动运行。
如图 4所示：
图 4. 物理机业务网卡故障后云主机高可用启动

功能优势

高可用策略具备以下优势：

全面&强大：覆盖所有主流高可用场景，包括各类故障场景以及异常停机场景。通过高可用机制确保用户关键业务稳定性和连续性。
灵活&可视化：提供直观简单的真值表，支持一键配置故障迁移策略，组合全局粒度和云主机粒度高可用模式配置，可极大提高业务高可用配置的灵活度。

应用场景

以下介绍高可用策略的应用场景。

物理机业务网卡故障场景：
希望物理机业务网卡故障时，所有关联的云主机迁移至其他物理机，保障业务高可用。
- 例如：用户部署业务云主机承载MySQL数据库服务，要求云主机不允许出现业务长时间宕机的情况。可将这台云主机高可用模式设置为NeverStop，且设置业务网卡状态故障时触发迁移。在确保云平台内物理机资源充足情况下，当业务云主机所在物理机业务网卡故障时，云主机将迁至其他物理机上启动运行，不影响业务运行。
云主机异常停机场景：
希望云主机异常停机时能自动HA启动。
- 例如：用户部署业务云主机运行公司重要业务，为避免诸如物理机掉电、云主机过载等各类因素导致云主机停机、业务无法自动恢复，可将这些云主机高可用模式设置为NeverStop。当云主机停机时触发高可用机制立刻重新启动，保障业务连续性。

版本检查

版本检查：周期性自动检查最新版本并推送最新版本信息，包括版本号，版本亮点等。

插件管理

插件管理：将扩展资源或工具封装为标准化插件，便于在云平台上快速安装和集成，实现功能扩展。

体验升级计划

体验升级计划：体验升级计划是ZStack Cloud为提升产品操作体验和运行性能向用户推出的项目。征得用户同意后，该计划将统计和分析用户对云平台功能的使用情况，并将统计和分析数据用于指导产品改进优化，以期后续为用户提供更优质的服务。

如图 5所示：

数据采集范围

体验升级计划将采集以下数据：

产品配置数据：云平台产品信息、浏览器信息及访问终端信息。
- 云平台产品信息：产品名称、产品类型、产品版本号。
- 浏览器信息：浏览器名称、浏览器版本、浏览器语言、浏览器编码。
- 访问终端信息：操作系统类型、操作系统版本、屏幕分辨率。
功能使用数据：用户在当前云平台的功能使用和界面活动情况，包括：用户名、用户UUID、用户类型；当前页面URL、上一页面URL、访问时刻、访问时长、页面停留时长、按钮点击记录。
产品性能数据：云平台的性能指标和界面响应情况，包括：页面加载时长。

Note: 本计划主要采集用户的平台使用习惯和功能使用情况，不包含资源敏感数据或个人敏感信息。数据采集将在用户同意加入体验升级计划后开始，并在退出体验升级计划后终止。

数据存储和使用说明

上述数据采集后将保留在用户本地，且不会主动上传至任何平台或存储介质。
仅当用户授权ZStack Cloud官方服务人员进行平台运维、故障检查、配置变更、巡检等操作，且需结合上述数据进行分析时，才会将采集的数据从用户本地上传到其他特定存储介质。
该计划采集的数据及相关数据分析主要用于指导云平台产品功能和使用体验改进，旨在为用户提供更高质量的产品和服务。

证书管理

云平台支持配置和管理SSL证书。成功配置证书后，用户可通过HTTPS协议登录UI界面，从而确保云平台数据传输得到有效加密。

证书管理支持以下操作：

操作	简介
添加证书	添加SSL证书。 Note: 仅支持添加最多一张SSL证书。添加证书后，云平台界面将自动从HTTP地址的5000端口跳转至HTTPS地址的5443端口重新登录。
更新证书	更新SSL证书。
恢复HTTP	恢复HTTP方式登录UI。 Note: 恢复HTTP会重新建立会话，需重新登录UI界面。恢复后将通过HTTP协议的5000端口登录UI界面。

设置

账户信息

相关定义

主题外观

可用区管理

功能优势

注意事项

管理可用区

时间管理

邮箱服务器

注意事项

日志服务器

日志服务器类型

高级监控服务器

相关定义

SNMP管理

相关定义

全局设置

资源高级设置

场景封装

场景封装模板 | 云主机性能调优

场景封装模板 | 高可用快速恢复

场景封装模板 | 生产推荐配置

场景封装模板丨云平台安全配置

高可用策略

相关定义

功能原理

功能优势

应用场景

版本检查

插件管理

体验升级计划

数据采集范围

数据存储和使用说明

证书管理