文档中心

文档数据库 MongoDB 版

网络与连接管理

修改连接地址

文档数据库 MongoDB 版支持修改副本集实例和分片集群实例中 Mongos 节点的连接地址域名前缀，您可以将新实例的连接地址修改为原实例的连接地址，免去修改客户端连接地址代码的操作。本文介绍如何修改连接地址域名前缀。

前提条件

实例状态需为运行中。关于实例状态的更多详情，请参见实例状态。

使用限制

当前仅支持修改副本集实例和分片集群实例中 Mongos 节点的私网或公网连接地址域名，不支持修改分片集群实例中 Shard 分片或 ConfigServer 节点的连接地址域名。各实例或组件类型支持的连接地址更多信息，请参见不同实例支持的连接地址。

注意事项

修改连接地址域名会导致部分服务的访问在短时间内受到影响，请谨慎操作。

修改连接地址域名后，原有的连接会断开，请及时修改客户端的连接信息。连接实例的具体操作步骤，请参见通过 Mongo shell 工具连接实例。

如需修改公网地址的连接地址域名前缀，需要先为副本集实例或分片集群实例 Mongos 节点申请公网连接地址。具体操作步骤，请参见申请公网地址。

操作步骤

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

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

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

在实例详情页，单击连接管理页签。

在连接管理页签，根据实例或节点类型，以及连接地址类型执行对应操作。

说明

当前仅支持修改连接地址前缀，即 .mongodb.ivolces.com 或 .mongodb.volces.com之前的部分。

新域名需同时满足如下要求：

连接地址前缀长度需为 8~63 个字符。

连接地址前缀需以小写字母开头，以小写字母或数字结尾。

连接地址前缀可包含小写字母、数字和连字符(-)。

修改后的连接地址需要保证全局唯一，不可以与火山引擎中任何地域下的任何连接地址重名。

副本集实例

分片集群实例 Mongos 节点

连接地址类型	具体操作步骤
私网地址	在连接管理页签下的私网访问区域，单击私网地址最右侧的图标。在修改连接地址弹窗中，先从节点下拉列表中选择需要修改连接地址域名的节点，然后在新连接地址文本框中输入新的连接地址域名前缀。说明您可以修改副本集实例的主、从、隐藏和只读节点的私网连接地址域名前缀。仅当实例添加了只读节点后，节点下拉列表中才会展示只读节点选项。添加只读节点的具体操作步骤，请参见添加只读节点。
公网地址	您可以修改副本集实例的主、从或只读节点节点的公网连接地址域名前缀，具体操作步骤如下：修改主从节点公网连接地址在连接管理页签下的公网访问区域，单击主从节点公网地址最右侧的图标。在修改连接地址弹窗中，先从节点下拉列表中选择需要修改连接地址域名的节点，然后在新连接地址文本框中输入新的连接地址域名前缀。修改只读节点公网连接地址在连接管理页签下的公网访问区域，在单节点地址表格中找到目标只读节点，单击公网地址最右侧的图标。在修改连接地址弹窗中，先确认只读节点信息，然后在新连接地址文本框中输入新的连接地址域名前缀。说明您需要为副本集实例申请公网连接地址后，才可以查看并修改公网连接地址域名。具体操作步骤，请参见申请公网地址。仅当实例中存在只读节点时，才会展示只读节点的连接地址信息。关于只读节点的更多信息，请参见管理只读节点。

在修改连接地址弹窗的右下角，单击确定。

注意

修改连接地址域名会将导致部分服务的访问在短时间内受到影响，请谨慎操作。

修改连接地址域名后，原有的连接会断开，请及时修改客户端的连接信息。连接实例的具体操作步骤，请参见通过 Mongo shell 工具连接实例。

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

这个页面对您有帮助吗？

有用

无用