MongoDB分片集群Docker部署核心是配置服务器、分片节点与mongos路由的协作：需统一使用7.0 LTS镜像，创建命名卷，通过docker-compose定义三类服务（config server用--configsvr、shard用--shardsvr、mongos通过--configdb连接），按顺序初始化副本集并添加分片，最后启用数据库与集合分片。
用 Docker 部署 MongoDB 分片集群，核心是理清三类服务的协作关系：配置服务器（config server）、分片节点（shard）、路由服务（mongos）。整个过程不复杂但容易忽略版本一致性、网络互通和初始化顺序。
环境与镜像准备
确保宿主机已安装 Docker（≥24.0.0）和 Docker Compose（≥v2.26.1），执行 docker --version 和 docker compose version 验证。
- 统一使用 MongoDB 6.0 或 7.0 镜像（推荐 7.0 LTS 版本），避免混用大版本，否则 config server 协议不兼容
- 拉取镜像：docker pull mongo:7.0
- 为数据持久化提前创建命名卷：
docker volume create mongo-configdb
docker volume create mongo-shard1
docker volume create mongo-shard2
docker volume create mongo-shard3
编写 docker-compose.yml 定义集群拓扑
一个最小可用分片集群包含：1 组 config server（至少 1 节点，生产建议 3 节点副本集）、3 个独立 shard（每 shard 可单节点测试，生产应为副本集）、1 个 mongos。
- config server 使用 --configsvr 启动，绑定端口如 27019，replSet 名设为 configReplSet
- 每个 shard 使用 --shardsvr 启动，各自定义独立 replSet 名（如 shard1ReplSet），端口错开（27018/27017/27016）
- mongos 不存数据，仅转发请求，通过 --configdb configReplSet/config1:27019 指向配置服务
- 所有服务需声明相同自定义网络（如 mongo-net），确保容器间 DNS 可解析
启动并初始化分片集群
先启动全部服务，再按顺序初始化：
- 进入 config server 容器：docker exec -it mongo_config1 mongosh --port 27019，执行 rs.initiate() 初始化配置副本集
- 依次进入各 shard 容器（如 mongo_shard1），运行 rs.initiate() 初始化对应副本集
- 连接 mongos：docker exec -it mongo_mongos mongosh，依次执行：
sh.addShard("shard1ReplSet/shard1:27018")
sh.addShard("shard2ReplSet/shard2:27017")
sh.addShard("shard3ReplSet/shard3:27016") - 对目标数据库启用分片：sh.enableSharding("mydb")，再对集合指定分片键：sh.shardCollection("mydb.mycoll", { _id: "hashed" })
验证与日常维护要点
验证是否生效，可在 mongos 中运行 sh.status() 查看分片分布、chunk 均衡状态及各节点角色。
- 若添加分片失败，优先检查网络连通性（ping shard1）和端口是否被占用
- 生产环境务必启用 keyfile 认证：生成 6–1024 字符的密钥文件，挂载进所有容器，并在启动命令中加 --keyFile /path/to/key
- 副本集初始化后，不要手动修改 rs.conf() 中的 host 名；Docker 容器重启 IP 可能变化，应使用服务名（如 shard1）作为 hostname
- 定期备份 config server 数据卷（mongo-configdb），它是整个分片集群的元数据中枢
