文档中心

文档数据库 MongoDB 版

白名单管理

绑定实例和白名单

绑定实例和白名单

文档数据库 MongoDB 版实例创建成功后，您需要为实例设置白名单，以允许外部设备访问该实例。本文介绍如何通过控制台绑定实例和白名单。

前提条件

已创建白名单。白名单创建方法，请参见创建白名单。

使用限制

每个火山引擎主账号在每个地域下最多可以创建 500 个 IP 白名单。

每个火山引擎账号在每个地域最多可设置一个默认白名单。新设置的默认白名单会自动顶替原有默认白名单，即原有默认白名单会自动变为非默认白名单。

每个白名单中最多添加 1000 个 IP 地址（或 CIDR 格式的 IP 地址段）。

每个白名单最多支持绑定 500 个实例。

每个白名单每次可最多批量绑定 200 个实例。

每个实例最多支持绑定 100 个白名单，但每个实例绑定的所有白名单中，IP 地址或 CIDR 格式的 IP 地址段的总和不可超过 1000 个。

每个实例每次可最多批量绑定 100 个白名单。

如果一个实例没有绑定任何白名单，表示禁止所有地址访问。

操作步骤

绑定实例至当前白名单

登录 MongoDB 控制台。

在顶部菜单栏，选择实例所属的项目和地域。

在左侧导航栏中，选择 NoSQL 数据库 > MongoDB > 白名单列表。

您可以选择如下任意一种方法将实例绑定至指定白名单中。

绑定方法一
绑定方法二
在白名单列表页，单击目标白名单右侧操作列中的绑定实例。
说明
您可以在白名单列表右上角的搜索框中，通过白名单名称、ID、描述或 IP 地址，快速筛选出目标白名单。
在弹出的面板中，勾选需要加入至当前白名单的实例。
说明
您可以在实例列表上方，先从所属项目下拉列表中选择实例所属的项目，然后在右侧搜索框中，通过实例名称或 ID 快速筛选出目标实例。
单击确定。
在白名单列表页，单击目标白名单名称。
说明
您可以在白名单列表右上角的搜索框中，通过白名单名称、ID、描述或 IP 地址，快速筛选出目标白名单。
在弹出的面板中的已绑定实例列表区域，单击绑定实例。
在弹出的面板中，勾选需要加入至当前白名单的实例。
说明
您可以在实例列表上方，先从所属项目下拉列表中选择实例所属的项目，然后在右侧搜索框中，通过实例名称或 ID 快速筛选出目标实例。
单击确定。

绑定白名单至当前实例

登录 MongoDB 控制台。

在顶部菜单栏，选择实例所属的项目和地域。

根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。

在目标实例类型列表页，单击目标实例名称。

在实例详情页，单击数据安全页签。

在白名单子页签下，单击绑定白名单。

在弹出的控制面板中，先确认实例名称和所属项目信息，再根据选择的绑定模式，完成后续操作。

绑定模式：已有白名单
绑定模式：新白名单
在已有白名单列表中勾选需要绑定的白名单。
说明
您可以在白名单列表上方，先从所属项目下拉列表中选择白名单所属的项目，然后在右侧搜索框中，通过白名单名称、ID、描述或 IP 地址，快速筛选出目标白名单。
单击确定。
从所属项目下拉列表中，为新建白名单选择需要加入的项目，默认会加入 default 项目。
输入新的白名单名称、描述（选填）和 IP 地址。
单击确定。
说明
关于创建白名单时的名称、描述和 IP 地址配置的更多说明，请参见创建白名单。
若通过子用户使用 MongoDB 云服务，您只能看到已为当前子用户授权项目下的白名单信息。更多详情，请参见通过子用户使用 MongoDB 云服务。

相关 API

API	描述
DescribeAllowLists	调用 DescribeAllowLists 接口查询当前账号下指定地域内的 IP 白名单列表。
DescribeAllowListDetail	调用 DescribeAllowListDetail 接口查询目标白名单的详细信息，包括 IP 地址和绑定的实例详情。
AssociateAllowList	调用 AssociateAllowList 接口将目标 MongoDB 实例绑定到指定 IP 白名单。

最近更新时间：2026.09.14 16:01:31

这个页面对您有帮助吗？

有用

有用

无用

无用