docker compose一键拉起mongodb副本集需在docker-compose.yml中明确节点角色、网络互通、安全认证和数据持久：统一replset名（如rs0）、自定义bridge网络、不同宿主机端口映射、共享400权限keyfile（uid/gid 999）、显式command含--bind_ip_all与--keyfile、挂载数据目录及初始化环境变量，启动后须手动执行rs.initiate初始化副本集。
用 Docker Compose 一键拉起多副本 MongoDB 分布式底座，核心是把“节点角色、网络互通、安全认证、数据持久”四件事写进 docker-compose.yml，而不是靠手动逐台启停或反复连 shell 配 replica set。
明确副本角色与通信基础
一个最小可用的分布式副本集至少含 1 主 + 1 从 + 1 仲裁（或 3 全数据节点），所有节点必须：
- 使用相同
--replSet名称（如rs0），且该名称需全局一致 - 通过自定义 bridge 网络互通，避免依赖默认网络带来的 DNS 解析不确定性
- 绑定宿主机不同端口（如 27017/27018/27019）便于本地调试，但容器内统一用 27017
- 共享同一份 keyfile（权限必须为
400，属主 UID/GID 设为 999）用于内部节点认证
关键配置项不能漏
每个服务块中，以下字段直接影响副本集能否自动发现和选举：
-
command：必须显式带--bind_ip_all --replSet rs0 --keyFile /data/mongodb/keyfile -
volumes：数据目录（/data/db）和 keyfile 路径需挂载，且 keyfile 文件本身要提前生成并设好权限 -
environment：设置TZ和初始化账号密码（MONGO_INITDB_ROOT_USERNAME/PASSWORD），避免时区错乱或无管理员无法登录 -
restart：建议用unless-stopped，保证意外退出后自动恢复
启动后必须初始化副本集
Compose 只负责拉起容器，不执行 MongoDB 内部命令。首次启动后需人工或脚本触发初始化：
- 进入主节点容器：
docker exec -it mongo1 mongo --port 27017 - 执行：
rs.initiate({_id:"rs0", members:[{_id:0,host:"mongo1:27017"},{_id:1,host:"mongo2:27017"},{_id:2,host:"mongo3:27017"}]}) - 确认状态：
rs.status()应显示"stateStr" : "PRIMARY"和两个"SECONDARY" - 如需仲裁节点，初始化时将对应成员加
"arbiterOnly":true
让底座真正“持久可用”
光有副本不算底座，还要支撑真实业务流转：
- 数据卷用命名卷（如
mongodb_data_1）而非相对路径，避免误删或跨项目污染 - 日志输出重定向到
/var/log/mongodb并挂载宿主机目录，方便排查选举失败原因 - 对外暴露端口仅限必要节点（通常只开主+从，仲裁不暴露），应用连接串用
mongodb://mongo1:27017,mongo2:27017,mongo3:27017/?replicaSet=rs0 - 生产环境建议加
healthcheck检查mongosh --eval "db.runCommand({ping:1})"，供编排层感知存活
