黑名单管理
Download
聚焦模式
字号
使用场景
黑名单管理用于快速封禁异常或非法的 MQTT 客户端连接。当您发现某些客户端存在异常行为（如频繁建连、恶意攻击、未授权访问等）时，可以通过配置黑名单规则，立即阻断目标客户端的连接，保障实例安全。
限制与约束
每个实例最多支持创建 10 条黑名单规则，每条规则最多支持 3 个排除条件。
仅对标准 MQTT 客户端连接生效，暂不对 HTTP Publish 方式生效
封禁规则顺序不敏感，多条规则之间为 OR 关系，命中任意一条即拦截。
配置与管理
新建规则
1. 登录消息队列 MQTT 版控制台 > 客户端管理 > 黑名单管理，单击左上角新建规则按钮，进行配置。
参数 | 是否必填 | 说明 |
规则名称 | 是 | 黑名单规则的唯一标识符。仅支持英文字母、数字、连字符（-）和下划线（_），长度 3-64 个字符。 |
备注 | 否 | 对规则用途的自由描述，支持中文，最多128个字符。 |
匹配维度 | 是 | 规则生效的匹配维度，支持 Client ID、Username、IP Address 三选一，一条规则只能选择一个维度且匹配条件和排除条件需属于同一维度 |
匹配条件 | 是 | 在所选维度下的匹配表达式。Client ID 和 Username 支持通配符（ * 匹配任意字符，? 匹配单个字符）；IP Address 支持精确 IP 或 CIDR 格式（如 203.0.113.0/24） |
排除条件 | 否 | 在匹配条件命中范围内，指定不受规则影响的具体对象，与匹配维度相同，支持通配符（ * 匹配任意字符，? 匹配单个字符）。每条规则下最多填写 3 个排除条件。 |
到期时间 | 否 | 规则的自动失效时间。可选择永久生效或指定到期时间。到期后规则自动失效，但记录会在控制台上保留，可进行手动删除。 |
2. 单击提交，规则创建后立即生效，已匹配的存量连接和后续新建连接均会被阻断。
查看规则
1. 登录消息队列 MQTT 版控制台 > 客户端管理 > 黑名单管理，即可查看当前实例下所有黑名单规则。
列表展示以下信息：
字段 | 说明 |
规则名称 | 黑名单规则的唯一标识 |
备注 | 规则的描述信息 |
匹配维度 | 规则生效的连接属性维度（Client ID / Username / IP Address） |
匹配条件 | 规则的匹配表达式 |
排除条件 | 规则排除的对象列表（如有） |
到期时间 | 规则的失效时间。显示为具体时间或"永久生效" |
状态 | 规则当前状态：生效中或已过期 |
操作 | 支持编辑和删除操作 |
编辑规则
1. 在黑名单管理页面，找到目标规则，单击操作列的编辑。
2. 在弹出的对话框中修改规则参数。
3. 单击确定保存修改，修改后立即生效。
删除规则
1. 在黑名单管理页面，找到目标规则，单击操作列的删除。
2. 在弹出的确认对话框中，确认删除操作。
3. 单击确认删除，完成规则删除。
注意：
编辑规则后将立即应用新的封禁条件，请确认修改内容无误后再保存。
删除后规则立即失效且不可恢复，之前被阻断的客户端将可以重新连接实例。
使用示例
场景：封禁异常测试客户端，保留监控客户端。某业务测试完成后，需要批量封禁所有以
test- 为前缀的测试客户端，但保留 test-monitor 监控客户端的连接。配置方式：
匹配维度：Client ID
匹配条件：
test-*排除条件：
test-monitor到期时间：指定到期时间（如 7 天后自动失效）
文档反馈