若客户端无法正常连接云数据库MongoDB实例,您可以通过连接诊断功能诊断客户端的IP地址是否已正确配置在云数据库MongoDB实例的白名单中。

使用限制

云数据库MongoDB仅单节点、副本集和分片集群实例支持连接诊断功能。

操作步骤

  1. 登录MongoDB管理控制台
  2. 根据实例类型,在左侧导航栏,单击副本集实例列表分片集群实例列表
  3. 在页面左上角,选择实例所在的资源组和地域。
  4. 单击目标实例ID。
  5. 基本信息页面的连接信息区域,单击右侧的连接诊断
  6. 连接诊断面板中,根据下表的连接场景,填写IP地址。
    连接场景操作说明
    同地域ECS实例连接云数据库MongoDB实例。

    支持通过专有网络(私网)或公网进行访问。

    1. 选择客户端类型选择ECS实例
    2. 选择ECS实例ID(仅支持相同地域实例)
      • 若ECS实例ID为绿色:表示该ECS实例与当前云数据库MongoDB实例为同一VPC网络,可以通过专有网络(私网)或公网进行访问。
      • 若ECS实例ID为红色:表示该ECS实例与当前云数据库MongoDB实例不在同一VPC网络,仅支持通过公网进行访问。
    3. 选择访问的ECS IP地址
    • 跨地域ECS实例连接云数据库MongoDB实例。

      例如ECS实例为华北2(北京)地域,云数据库MongoDB实例为华东1(杭州)地域。

    • 本地设备连接云数据库MongoDB实例。

    仅支持通过公网进行访问。

    1. 选择客户端类型填写IP地址
    2. 填写IP地址
  7. 单击开始诊断
  8. 查看诊断结果。
    • 检测失败:表示该IP地址未加入云数据库MongoDB实例的白名单列表。您可以单击一键添加,根据页面完成操作,将当前IP加入云数据库MongoDB实例的白名单列表中的default分组中,并进行再次诊断。

      您也可以单击白名单设置,前往白名单设置页面手动添加该IP至白名单中。

      示例:检测失败
    • 检测通过:表示该IP地址已加入云数据库MongoDB实例的白名单列表。
      示例:检测通过
    诊断结束,请在客户端上使用检测通过的IP地址连接云数据库MongoDB实例。
    说明 本功能仅诊断客户端的IP地址是否已正确配置在云数据库MongoDB实例的白名单中,若当前IP地址检查通过,但仍无法成功连接云数据库MongoDB实例,可能存在如下问题:
    • 网络异常:请通过ping命令测试客户端与云数据库MongoDB实例间的网络是否正常,若异常,请检查客户端所在网络环境。
    • 客户端存在网络动态变更:若公网环境下的客户端IP地址发生变更,会导致连接失败。此时,可设置固定的客户端IP地址或在实例白名单中添加0.0.0.0/0

      0.0.0.0/0表示允许任何设备访问云数据库MongoDB实例,请谨慎使用。

    • 密码错误:请检查云数据库MongoDB实例的数据库账号密码。