文档中心

消息队列 RocketMQ版

白名单管理

创建白名单

创建白名单并和 RocketMQ 实例绑定后，只有在白名单中配置的 IP 地址或地址段才能访问该实例。本文介绍创建白名单的操作步骤。

注意事项

每个火山引擎账号在每个地域下最多创建 100 个白名单。

每个白名单中最多设置 300 个 IP 地址和 CIDR 格式的 IP 地址段。

背景信息

白名单与 RocketMQ 实例绑定之后，仅配置在白名单中的 IP 地址与地址段才能访问消息队列 RocketMQ版实例。安全起见，建议您创建白名单，并将客户端的 IP 地址或 IP 地址段添加到 RocketMQ 实例的白名单中。建议您定期维护和管理白名单，提高 RocketMQ 实例访问的安全性。

注意

如果 RocketMQ 实例从创建之日起，从未绑定过任何白名单，则允许所有 IP 地址访问该实例。实例一旦绑定了白名单后，则只有白名单内的 IP 地址可访问实例；实例解绑所有白名单后，表示禁止所有 IP 地址访问此实例。

操作步骤

登录消息队列 RocketMQ版控制台。

在顶部菜单栏的左上角，选择实例所属的地域。

在左侧导航栏中，单击白名单列表。

在白名单列表页面左上角，单击创建白名单。

填写白名单配置。

参数	说明
白名单名称	白名单名称。应满足以下要求：不能以数字、中划线（-）开头。长度范围为 1～128 个字符。只能包含中文、字母、数字、下划线（_）、中划线（-）。不能与当前地域下已有的白名单名称重复。
描述	白名单的简单描述，长度不可超过 200 个字符。
IP地址	需要添加到白名单中的 IP 地址或 IP 地址段。只有配置在白名单中的 IP 地址与地址段才能访问消息队列 RocketMQ版实例。每个白名单中最多设置 300 个 IP 地址或 CIDR 格式的 IP 地址段，多个地址间用中英文逗号、空格或换行符隔开。不支持在白名单中设置重复的 IP 地址。

单击确定。

后续操作

成功创建白名单后，您可以为白名单绑定实例，请参见为白名单绑定实例。

最近更新时间：2025.07.09 16:22:42

这个页面对您有帮助吗？

有用

无用