You need to enable JavaScript to run this app.
文档中心
文档数据库 MongoDB 版

文档数据库 MongoDB 版

复制全文
下载 pdf
网络与连接管理
修改连接地址
复制全文
下载 pdf
修改连接地址
文档数据库 MongoDB 版支持修改副本集实例和分片集群实例中 Mongos 节点的连接地址域名前缀,您可以将新实例的连接地址修改为原实例的连接地址,免去修改客户端连接地址代码的操作。本文介绍如何修改连接地址域名前缀。
前提条件
实例状态需为运行中。关于实例状态的更多详情,请参见实例状态
使用限制
当前仅支持修改副本集实例和分片集群实例中 Mongos 节点的私网或公网连接地址域名,不支持修改分片集群实例中 Shard 分片或 ConfigServer 节点的连接地址域名。各实例或组件类型支持的连接地址更多信息,请参见不同实例支持的连接地址
注意事项
  • 修改连接地址域名会导致部分服务的访问在短时间内受到影响,请谨慎操作。
  • 修改连接地址域名后,原有的连接会断开,请及时修改客户端的连接信息。连接实例的具体操作步骤,请参见通过 Mongo shell 工具连接实例
  • 如需修改公网地址的连接地址域名前缀,需要先为副本集实例或分片集群实例 Mongos 节点申请公网连接地址。具体操作步骤,请参见申请公网地址
操作步骤
  1. 登录 MongoDB 控制台
  1. 在顶部菜单栏,选择实例所属的项目和地域。
  1. 根据实例类型,在左侧导航栏中选择副本集实例列表分片集实例列表
  1. 在目标实例类型列表页,单击目标实例名称。
  1. 在实例详情页,单击连接管理页签。
  1. 连接管理页签,根据实例或节点类型,以及连接地址类型执行对应操作。
说明
  • 当前仅支持修改连接地址前缀,即 .mongodb.ivolces.com.mongodb.volces.com之前的部分。
  • 新域名需同时满足如下要求:
  • 连接地址前缀长度需为 8~63 个字符。
  • 连接地址前缀需以小写字母开头,以小写字母或数字结尾。
  • 连接地址前缀可包含小写字母、数字和连字符(-)。
  • 修改后的连接地址需要保证全局唯一,不可以与火山引擎中任何地域下的任何连接地址重名。
  • 副本集实例
    分片集群实例 Mongos 节点
    连接地址类型
    具体操作步骤
    私网地址
    1. 连接管理页签下的私网访问区域,单击私网地址最右侧的 图标。
    1. 修改连接地址弹窗中,先从节点下拉列表中选择需要修改连接地址域名的节点,然后在新连接地址文本框中输入新的连接地址域名前缀。
    说明
    • 您可以修改副本集实例的主、从、隐藏和只读节点的私网连接地址域名前缀。
    • 仅当实例添加了只读节点后,节点下拉列表中才会展示只读节点选项。添加只读节点的具体操作步骤,请参见添加只读节点
    公网地址
    您可以修改副本集实例的主、从或只读节点节点的公网连接地址域名前缀,具体操作步骤如下:
    • 修改主从节点公网连接地址
    1. 连接管理页签下的公网访问区域,单击主从节点公网地址最右侧的 图标。
    1. 修改连接地址弹窗中,先从节点下拉列表中选择需要修改连接地址域名的节点,然后在新连接地址文本框中输入新的连接地址域名前缀。
    • 修改只读节点公网连接地址
    1. 连接管理页签下的公网访问区域,在单节点地址表格中找到目标只读节点,单击公网地址最右侧的 图标。
    1. 修改连接地址弹窗中,先确认只读节点信息,然后在新连接地址文本框中输入新的连接地址域名前缀。
    说明
    • 您需要为副本集实例申请公网连接地址后,才可以查看并修改公网连接地址域名。具体操作步骤,请参见申请公网地址
    • 仅当实例中存在只读节点时,才会展示只读节点的连接地址信息。关于只读节点的更多信息,请参见管理只读节点
  1. 修改连接地址弹窗的右下角,单击确定
注意
  • 修改连接地址域名会将导致部分服务的访问在短时间内受到影响,请谨慎操作。
  • 修改连接地址域名后,原有的连接会断开,请及时修改客户端的连接信息。连接实例的具体操作步骤,请参见通过 Mongo shell 工具连接实例
最近更新时间:2026.09.14 16:01:30
这个页面对您有帮助吗?
有用
有用
无用
无用