MongoDB 3节点副本集( Docker )

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. 踩坑清单

  1. keyfile权限报错 :chmod 400 + chown 999:999,linux下权限600/700直接启动失败
  2. 初始化超时/找不到节点:必须用compose自定义bridge网络,不要用默认bridge
  3. MONGO_INITDB_ROOT_USERNAME 不生效 :开启replSet+keyfile后,初始化副本集之后再建用户,启动阶段的环境变量只在单节点无replSet时生效
  4. 跨机器部署:host改成宿主机内网IP,端口放行27017,keyfile同步到所有机器
  5. 如需仲裁节点arbiter :arbiter不存数据,投票用,host单独加一条,arbiterOnly:true
相关推荐
星落梦生4 小时前
Docker学习(11)
学习·docker·容器
byte轻骑兵20 小时前
如何为你的 Web 应用添加文档编辑能力:ONLYOFFICE 文档集成实战
docker·私有化部署·系统集成·在线协作·wsl2·onlyoffice docs
好用斋1 天前
内网测速 LibreSpeed:网页版 Docker 测速服务
运维·docker·容器
菜地里的小菜鸟1 天前
Docker 19.03.8 升级到 20.10.24
docker·云原生·容器·docker19038升级到201024
lambo mercy2 天前
01初识docker
运维·docker·容器
时间的拾荒人2 天前
Docker 容器、仓库与数据管理实战
docker·容器·eureka
时间的拾荒人2 天前
Docker 入门实战:从核心概念、安装配置到镜像操作与 Dockerfile 定制
运维·docker·容器·eureka
时间的拾荒人2 天前
Docker Compose 编排实战:从命令详解到 Redis Cluster 三主三从部署
docker·部署·集群
AI开源软件3 天前
Kubernetes 网络实战:打通 Pod、Service 与集群外任务调度器的双向调用
docker·nacos·kubernetes·xxl-job·calico·微服务部署·ruoyi office