如何从外部连接Kubernetes中启用外部访问的MongoDB副本集？

问题根源 #

你遇到的报错是因为MongoDB副本集默认注册的是集群内部的Headless Service域名（如mongodb-0.mongodb-headless.mongodb.svc.cluster.local）。当外部客户端通过外部域名连接时，MongoDB会把这些内部地址返回给客户端，而外部环境无法解析集群内DNS，导致连接失败。

针对性解决方法（基于Bitnami MongoDB Chart 13.3.1） #

Bitnami的Chart内置了外部访问副本集的配置参数，直接修改部署配置即可让MongoDB对外暴露正确的节点地址：

方法1：统一外部域名后缀 #

如果你的外部节点域名是mongodb-0.dev、mongodb-1.dev这种统一后缀格式，执行以下Helm升级命令：

helm upgrade mongodb bitnami/mongodb --version 13.3.1 \
  --set replicaSet.externalAccess.enabled=true \
  --set replicaSet.externalAccess.domain=dev \
  --set replicaSet.externalAccess.service.type=LoadBalancer

• replicaSet.externalAccess.domain=dev指定外部域名的后缀，Chart会自动生成mongodb-0.dev、mongodb-1.dev这类节点地址并注册到副本集。

方法2：自定义每个节点的外部域名 #

如果需要单独指定每个节点的外部域名（比如后缀不一致），用以下命令：

helm upgrade mongodb bitnami/mongodb --version 13.3.1 \
  --set replicaSet.externalAccess.enabled=true \
  --set replicaSet.externalAccess.nodes[0].host=mongodb-0.dev \
  --set replicaSet.externalAccess.nodes[1].host=mongodb-1.dev \
  --set replicaSet.externalAccess.nodes[2].host=mongodb-2.dev \
  --set replicaSet.externalAccess.service.type=LoadBalancer

验证配置生效 #

1. 进入集群内的MongoDB主节点，执行：

mongosh --authenticationDatabase admin -u root -p root1234
rs.conf()

2. 查看输出中members数组的每个节点host字段，确认已经变成你配置的外部域名（如mongodb-0.dev:27017）。

测试外部连接 #

配置完成后，用原有的副本集连接字符串即可正常连接：

mongosh mongodb://mongodb-0.dev:27017,mongodb-1.dev:27017,mongodb-2.dev:27017?replicaSet=rs0 --authenticationDatabase admin -u root -p root1234

原理说明 #

开启replicaSet.externalAccess后，Bitnami Chart会自动修改MongoDB副本集的配置文档，将每个节点的host字段替换为指定的外部域名。这样MongoDB返回给外部客户端的节点地址都是可正常解析的外部DNS，无需客户端做任何DNS或hosts的额外配置。

内容的提问来源于stack exchange，提问作者mrk