1. 目录准备 & 生成keyfile(副本集内部通信密钥)
bash
mkdir -p mongo-rs/{data1,data2,data3,keyfile}
cd mongo-rs
# 生成密钥,所有节点共用,权限必须 400,否则mongodb启动失败
openssl rand -base64 756 > keyfile/mongodb-keyfile
chmod 400 keyfile/mongodb-keyfile
# 容器内mongodb用户uid=999,宿主机权限要给到
chown 999:999 keyfile/mongodb-keyfile
2. docker-compose.yml
yaml
version: '3.8'
services:
mongo1:
image: mongo:7.0
container_name: mongo1
hostname: mongo1
ports:
- "27017:27017"
volumes:
- ./data1:/data/db
- ./keyfile/mongodb-keyfile:/data/keyfile/mongodb-keyfile:ro
environment:
MONGO_INITDB_ROOT_USERNAME: root
MONGO_INITDB_ROOT_PASSWORD: Root@123456
command: mongod --replSet rs0 --keyFile /data/keyfile/mongodb-keyfile --bind_ip_all
restart: always
networks:
mongo-net:
aliases:
- mongo1
mongo2:
image: mongo:7.0
container_name: mongo2
hostname: mongo2
ports:
- "27018:27017"
volumes:
- ./data2:/data/db
- ./keyfile/mongodb-keyfile:/data/keyfile/mongodb-keyfile:ro
environment:
MONGO_INITDB_ROOT_USERNAME: root
MONGO_INITDB_ROOT_PASSWORD: Root@123456
command: mongod --replSet rs0 --keyFile /data/keyfile/mongodb-keyfile --bind_ip_all
restart: always
networks:
mongo-net:
aliases:
- mongo2
mongo3:
image: mongo:7.0
container_name: mongo3
hostname: mongo3
ports:
- "27019:27017"
volumes:
- ./data3:/data/db
- ./keyfile/mongodb-keyfile:/data/keyfile/mongodb-keyfile:ro
environment:
MONGO_INITDB_ROOT_USERNAME: root
MONGO_INITDB_ROOT_PASSWORD: Root@123456
command: mongod --replSet rs0 --keyFile /data/keyfile/mongodb-keyfile --bind_ip_all
restart: always
networks:
mongo-net:
aliases:
- mongo3
networks:
mongo-net:
driver: bridge
3. 启动集群
bash
docker compose up -d
# 等待10s,等三个mongod全部启动就绪
sleep 10
4. 初始化副本集(关键!只执行一次)
bash
docker exec -it mongo1 mongosh -u root -p Root@123456 --authenticationDatabase admin --eval "
rs.initiate({
_id: 'rs0',
members: [
{_id:0, host:'mongo1:27017'},
{_id:1, host:'mongo2:27017'},
{_id:2, host:'mongo3:27017'}
]
})
"
⚠️ 注意:host 写容器内hostname+端口,不要写127.0.0.1,容器之间DNS通过自定义bridge网络解析
5. 查看状态、等待选举
bash
# 进入主节点
docker exec -it mongo1 mongosh -u root -p Root@123456 --authenticationDatabase admin
rs.status()
rs.isMaster()
stateStr: "PRIMARY"主节点(可写)stateStr: "SECONDARY"从节点(只读)
刚初始化完会有几十秒选举等待,正常现象
6. 连接串(应用程序使用)
mongodb://root:Root@123456@127.0.0.1:27017,127.0.0.1:27018,127.0.0.1:27019/?replicaSet=rs0&authSource=admin
Java SpringBoot / Python 直接用这个连接串,自动识别主从、故障转移
7. 常用运维命令
bash
# 重新配置副本集(节点变更)
rs.reconfig(...)
# 手动降级主节点(维护用)
rs.stepDown()
# 查看 oplog 大小(同步日志)
rs.printReplicationInfo()
# 停止集群
docker compose down
# 停止并清空数据(谨慎!)
docker compose down -v
8. 踩坑清单
- keyfile权限报错 :
chmod 400+chown 999:999,linux下权限600/700直接启动失败 - 初始化超时/找不到节点:必须用compose自定义bridge网络,不要用默认bridge
- MONGO_INITDB_ROOT_USERNAME 不生效 :开启replSet+keyfile后,初始化副本集之后再建用户,启动阶段的环境变量只在单节点无replSet时生效
- 跨机器部署:host改成宿主机内网IP,端口放行27017,keyfile同步到所有机器
- 如需仲裁节点arbiter :arbiter不存数据,投票用,host单独加一条,
arbiterOnly:true