部署设置

部署设置页面允许您查看和配置 EMQX Cloud 部署的关键设置，包括部署信息、云平台详情以及 MQTT 协议行为。

您可以在部署左侧导航栏中的部署设置下访问此页面。

概览

部署设置页面包含两个选项卡：

• 常规设置：查看部署详情、计费信息和云平台设置。

• MQTT 设置：配置 MQTT 参数，包括报文大小、共享订阅策略和会话行为。

常规设置

常规设置选项卡提供部署信息和云环境的概览，以及管理套餐和计费的选项。

部署信息

本节显示部署的基本信息。

字段	描述
部署名称	部署的名称。您可以点击编辑图标直接修改，或使用复制图标进行复制。
部署 ID	部署的唯一标识符。您可以在需要时（例如联系技术支持或使用 API 时）使用复制图标复制该 ID。
套餐	当前部署套餐，例如专有版或 Serverless。
EMQX 版本	部署中当前运行的 EMQX 版本。
规格	当前性能规格，表示支持的最大会话数和消息吞吐量（TPS）。点击调整规格可调整部署容量。详情请参见调整部署规格。
计费方式	当前计费方式（例如，按量计费）。您可以联系 EMQ 获取年度订阅或自定义定价方案。

提示： 联系 EMQ 销售团队，了解专属折扣或独立容量选项。

云平台信息

本节显示托管部署的云基础设施信息。

字段	描述
云平台	托管部署的云服务商，例如阿里云或腾讯云。
地域	云实例所在的地理区域（例如，杭州）。

删除部署

如需永久删除部署，请点击页面底部的删除部署。删除部署将移除与之关联的所有数据和配置。

注意

此操作不可撤销。详情请参见删除部署。

MQTT 设置

MQTT 设置选项卡允许您自定义 MQTT 协议参数以满足应用需求。这些配置控制 EMQX Cloud 如何处理客户端会话、订阅、消息分发和报文验证。

基础设置

设置	描述
最大报文大小	定义 EMQX 接受的最大 MQTT 报文大小。如果客户端发送的报文超过此限制，EMQX Cloud 将断开该客户端的连接。使用此设置可防止过大的载荷影响性能。
共享订阅策略	决定 EMQX Cloud 如何在共享订阅组的订阅者之间分发消息。可用策略： random：将每条消息发送给随机选择的订阅者。 round_robin：按顺序将消息均匀分发给各订阅者。 round_robin_per_group：在每个共享订阅组内执行轮询分发。 sticky：持续向同一订阅者分发消息，直到该订阅者断开连接。 local：优先选择本地节点上的随机订阅者；如果不可用，则在集群中随机选择。 hash_topic：使用消息来源主题的哈希值确定订阅者。 hash_clientid：使用发送方客户端 ID 的哈希值确定订阅者。此设置有助于优化集群环境中的负载均衡和消息分发一致性。 有关共享订阅的更多信息，请参见 EMQX Cloud 中的共享订阅以及 MQTT 5.0 共享订阅介绍。
共享订阅初始 Sticky 选择策略	指定在使用 sticky 分发策略时，如何选择第一个订阅者。 选项： random：随机选择一个订阅者。 local：优先选择本地节点上的订阅者；如果不可用，则在集群中随机选择。 hash_clientid：对发布者的客户端 ID 进行哈希以选择订阅者。 hash_topic：对发布主题进行哈希以选择订阅者。 此设置决定共享订阅组激活时的初始负载分配行为。
使用对端证书作为用户名	允许 EMQX Cloud 从客户端的 TLS 证书中提取 MQTT 用户名字段。适用于基于证书的身份验证。 支持的方式： cn：使用证书的 Common Name（CN）字段。 dn：使用证书的 Distinguished Name（DN）字段。 crt：使用 DER 或 PEM 证书的原始内容。 pem：将 DER 内容转换为 PEM 格式并用作用户名。 md5：使用 DER 或 PEM 证书的 MD5 哈希值。 仅对 TLS 连接有效。
使用对端证书作为客户端 ID	允许 EMQX Cloud 从客户端的 TLS 证书中派生客户端 ID。支持的方式与用户名相同：cn、dn、crt、pem 或 md5。 此选项为基于证书的连接提供了一种安全且确定性的客户端 ID 生成方式。
客户端属性	定义在连接时如何初始化自定义客户端属性。每个属性可声明为 client_attrs.{NAME}，其中 {NAME} 是 set_as_attr 配置字段中指定的属性键。 初始化后的属性存储在 client_attrs 属性中，可用于动态渲染挂载点，或在身份验证和授权规则中引用。 有关如何配置和使用客户端属性的详细信息，请参见 EMQX 客户端属性。

会话设置

设置	描述
会话过期间隔	指定客户端断开连接后 EMQX Cloud 保留会话数据的时长。仅适用于非 MQTT 5.0 连接。使用此设置可控制离线消息或订阅的保留时长。
最大飞行窗口	定义可同时发送而不需要确认的 QoS 1 和 QoS 2 消息的最大数量。较高的值可能提升吞吐量，但会增加内存使用。
最大消息队列长度	指定持久客户端断开连接或飞行窗口已满时的最大消息队列长度。当队列达到此限制时，较旧的消息将被丢弃。

更新配置

修改 MQTT 设置后，点击更新以应用更改。新配置将立即生效。