Docker Compose部署MongoDB集群外部连接失败问题求助

看起来你遇到的是外部客户端无法连接Docker部署的Mongo分片集群，但容器内部操作正常的问题。结合你提供的docker-compose.yaml和报错信息，我整理了几个关键排查方向和解决方案：

1. 检查端口映射与宿主机端口状态 #

首先确认宿主机的27017端口是否正常被Docker代理监听：

# 查看端口占用情况（Linux/macOS）
netstat -tulpn | grep 27017
# 或者用ss命令
ss -tulpn | grep 27017

如果输出中没有docker-proxy相关的监听记录，说明：

• Router容器可能没有正常启动，执行docker-compose ps router查看容器状态；
• 如果容器状态异常，查看日志定位问题：docker-compose logs router，常见报错是无法连接配置服务器。

2. 验证外部网络与防火墙设置 #

• 本地连接：确认宿主机防火墙（如ufw、iptables）没有拦截27017端口的入站请求，执行sudo ufw allow 27017临时开放端口测试；同时检查是否有其他程序占用了27017端口（比如本地安装的MongoDB服务）。
• 远程连接：确保宿主机的局域网/公网IP可访问，并且云服务商的安全组/路由器端口转发规则已开放27017端口。

3. 检查Docker外部网络配置 #

你的集群使用了外部网络my-mongo-cluster，先确认这个网络是否存在：

docker network ls | grep my-mongo-cluster

如果网络不存在，需要先创建：

docker network create my-mongo-cluster

创建完成后重启所有容器：docker-compose down && docker-compose up -d

4. 确认Mongo集群的初始化状态 #

由于集群半年前可用，现在无法连接，大概率是容器重启后分片集群的复制集没有正常恢复：

步骤1：初始化配置服务器复制集 #

进入config01容器，连接Mongo并初始化复制集：

docker-compose exec config01 mongo

在Mongo Shell中执行：

rs.initiate({
  _id: "configserver",
  configsvr: true,
  members: [
    { _id: 0, host: "config01:27017" },
    { _id: 1, host: "config02:27017" },
    { _id: 2, host: "config03:27017" }
  ]
})
# 检查复制集状态，确保所有节点处于健康状态
rs.status()

步骤2：初始化各个分片的复制集 #

以shard01为例，进入shard01a容器：

docker-compose exec shard01a mongo --port 27018

执行初始化命令：

rs.initiate({
  _id: "shard01",
  members: [
    { _id: 0, host: "shard01a:27018" },
    { _id: 1, host: "shard01b:27018" }
  ]
})
rs.status()

按照同样的方式初始化shard02和shard03的复制集。

步骤3：重启Router并添加分片 #

重启Router容器，让mongos重新连接配置服务器：

docker-compose restart router

进入Router容器，添加分片到集群：

docker-compose exec router mongo

在Mongo Shell中执行：

sh.addShard("shard01/shard01a:27018,shard01b:27018")
sh.addShard("shard02/shard02a:27019,shard02b:27019")
sh.addShard("shard03/shard03a:27020,shard03b:27020")
# 验证分片状态
sh.status()

5. 优化Router启动顺序（可选） #

depends_on仅保证容器启动顺序，不保证服务就绪。可以给Router添加启动等待逻辑，确保配置服务器就绪后再启动mongos：
修改docker-compose.yaml中router的command：

router:
  image: mongo
  command: bash -c "until mongo --host config01:27017 --eval 'print(\"connected\")'; do sleep 2; done; mongos --port 27017 --configdb configserver/config01:27017,config02:27017,config03:27017"
  ports:
    - "27017:27017"
  volumes:
    - ./scripts:/scripts
  networks:
    - backend
  depends_on:
    - config01
    - config02
    - config03
    - shard01a
    - shard01b
    - shard02a
    - shard02b
    - shard03a
    - shard03b

完成以上步骤后，再尝试用外部客户端连接mongodb://127.0.0.1:27017，应该就能正常访问了。

内容的提问来源于stack exchange，提问作者Manuel V.