概述

IP 白名单模板用于集中管理一组允许访问数据库实例的 IP 或网段，可一次配置、批量关联多个实例，便于统一运维与安全管控。模板支持创建、查看、编辑、删除等操作。

注意事项

• 模板仅允许关联与模板同一地域的实例。
• 允许的地址格式：单个 IP（如 192.168.0.1）或 CIDR 网段（如 10.23.12.0/24）。多个地址请以英文逗号分隔，且不可重复；单个模板最多可录入 1000 条。
• 0.0.0.0/0 表示对所有来源开放，存在严重安全风险，不建议使用。
• 创建后模板名称不可修改；可随时编辑模板内的 IP 名单与关联的实例。
• 删除模板为不可恢复操作，并会解除该模板与所有已关联实例的绑定，模板内的白名单不再在这些实例上生效；请谨慎操作。
• 编辑或删除会即时影响已关联实例的访问控制，可能导致连接异常，请在业务低峰期进行并做好回退预案。

操作步骤

创建 IP 白名单模板

1. 登录云数据库 MongoDB 管理控制台。
2. 在左侧导航选择IP 白名单模板，进入模板列表页。
3. 单击创建 IP 白名单模板。

4. 在弹出的对话框中填写：

   • 模板名称：由小写字母、数字、下划线（_）组成，只能以小写字母开头，字母或数字结尾。
   • 允许访问 IP 名单：按上述格式录入，多个以英文逗号分隔。
   • 关联实例：从可选实例列表中勾选需要应用该模板的实例（仅显示同地域实例）。
5. 单击确定完成创建。模板将对已选择的实例立即生效。

查看模板详情

• 在模板列表页，单击模板名称即可查看详情。详情页显示模板名称、允许访问 IP 名单（支持一键复制）及已关联实例列表。

编辑模板

1. 在模板列表页的操作列，单击编辑。
2. 在弹出的对话框中，可调整 IP 名单与已关联实例。
3. 单击确定保存。保存后修改会同步生效到所有已关联实例。

删除模板

1. 在模板列表页的操作列，单击删除。
2. 阅读二次确认提示：删除后不可恢复，且会解除所有关联实例与该白名单模板的绑定。
3. 单击确定完成删除。

常见问题

• 为什么无法在关联实例中选择到我的实例？

  • 模板仅支持关联与模板同地域的实例，请在控制台页面左上角切换到实例所在地域后重试。

• 编辑模板是否会影响正在运行的业务连接？

  • 会。IP 白名单变更会立即生效，若移除了正在访问的来源 IP，业务将无法继续访问，请务必在维护窗口操作。

• 删除模板后实例是否会保留这些 IP？

  • 删除模板将解除绑定，模板内的白名单不再在这些实例生效。若实例仍需访问控制，请在实例的白名单功能中单独配置。

相关说明

• 模板功能当前主要面向控制台使用场景；暂无接口支持。