代理订阅

代理订阅功能由内置模块提供，此功能默认关闭，支持在 EMQ X Broker 运行期间动态启停，请参见。

配置代理订阅规则

代理订阅功能开启之后还需要配置相应的规则，EMQ X 的代理订阅规则支持用户自行配置，用户可以自行添加多条代理订阅规则，代理订阅规则支持用户配置 Topic 和订阅选项（QoS、No Local、Retain As Published、Retain Handling），其中 Topic 为必填项，订阅选项如果不配置的话 EMQ X 会应用默认的配置。

需要注意的是，订阅选项中的 No Local、Retain As Published、Retain Handling 仅支持 MQTT V5 协议，当客户端以 MQTT V3 或 MQTT V3.1.1 连接时，代理订阅配置中仅有 Topic 与 QoS 的配置生效。

在配置代理订阅的主题时，EMQ X 提供了 %c 和 %u 两个占位符供用户使用，EMQ X 会在执行代理订阅时将配置中的 %c 和 %u 分别替换为客户端的 Client ID 和 Username，需要注意的是，%c 和 %u 必须占用一整个主题层级。


module.subscription.2.qos = 2
module.subscription.2.nl  = 1
module.subscription.2.rh  = 1

配置 A、B 两个客户端，客户端 A 的 Client ID 为 testclientA，Username 为，客户端 B 的 Client ID 为 testclientB，Username 为 testerB。

A 客户端使用 MQTT V3.1.1 协议连接 EMQ X，根据上文的配置规则，代理订阅功能会主动帮客户端订阅 QoS 为 1 的 client/testclientA 和 QoS 为 2 的 user/testerA 这两个主题，因为连接协议为 MQTT V3.1.1，所以配置中的 No Local、Retain As Published、Retain Handling 不生效。