运维,数据库··约 6 分钟读完·478 次观看

MongoDB 副本集搭建完整指南:从零到生产可用的7个关键步骤

MongoDB副本集搭建教程:手把手教你完成环境配置、keyfile认证、副本集初始化与高可用测试,掌握自动故障转移与读写分离配置,快速构建生产级数据库集群。立即开始学习!
数据库mongodb

MongoDB 副本集从零搭建到生产可用

两台服务器:一台物理机跑主库,一台 Docker 跑从库,实现数据库高可用


一、为什么需要副本集?

mermaid
      
        
          1
          
          graph LR
        
          2
          
              A[客户端] --> B[主库 PRIMARY]
        
          3
          
              B -->|自动同步| C[从库 SECONDARY]
        
          4
          
              B --x|主库挂了| D[自动选举 - 从库变主库]
        
      
    

副本集解决的核心问题:

  • 主库宕机 → 从库自动顶上(无需人工干预)
  • 数据冗余 → 主库磁盘坏了,从库还有数据
  • 读写分离 → 主库写,从库读,分担压力

二、环境准备

角色部署方式IP端口MongoDB 版本
Primary物理机192.168.1.100270173.6
SecondaryDocker192.168.1.10127017(映射8017)3.6

主库配置(物理机)

mongod.conf:

yaml
      
        
          1
          
          net:
        
          2
          
            port: 27017
        
          3
          
            bindIp: 0.0.0.0
        
          4
          
          
        
          5
          
          replication:
        
          6
          
            replSetName: rs0
        
          7
          
          
        
          8
          
          security:
        
          9
          
            keyFile: /data/mongodb.key
        
          10
          
          
        
          11
          
          storage:
        
          12
          
            dbPath: /data/mongo/db
        
      
    

生成 Keyfile(节点间认证用)

bash
      
        
          1
          
          # 在主库生成
        
          2
          
          openssl rand -base64 756 > /data/mongodb.key
        
          3
          
          chmod 400 /data/mongodb.key
        
          4
          
          chown 999:999 /data/mongodb.key
        
          5
          
          
        
          6
          
          # 复制到从库
        
          7
          
          scp /data/mongodb.key root@192.168.1.101:/data/mongodb.key
        
      
    

三、部署步骤

主库初始化

bash
      
        
          1
          
          # 启动 MongoDB
        
          2
          
          mongod -f /etc/mongod.conf
        
          3
          
          
        
          4
          
          # 初始化副本集
        
          5
          
          mongo 127.0.0.1:27017/admin --eval '
        
          6
          
            rs.initiate({
        
          7
          
              _id: "rs0",
        
          8
          
              members: [{ _id: 0, host: "192.168.1.100:27017" }]
        
          9
          
            })
        
          10
          
          '
        
      
    

从库部署(Docker)

bash
      
        
          1
          
          # 启动容器
        
          2
          
          docker run -d --name mongo_node1 --restart always \
        
          3
          
            -p 8017:27017 \
        
          4
          
            -v /data/mongo/sec:/data/db \
        
          5
          
            -v /data/mongodb.key:/data/mongodb.key:ro \
        
          6
          
            mongo:3.6.23 \
        
          7
          
            mongod --replSet rs0 --bind_ip_all --keyFile /data/mongodb.key
        
          8
          
          
        
          9
          
          # 加入副本集(在主库执行)
        
          10
          
          mongo 127.0.0.1:27017/admin --eval 'rs.add("192.168.1.101:8017")'
        
      
    

验证

javascript
      
        
          1
          
          rs.status()
        
          2
          
          // 应看到:
        
          3
          
          // PRIMARY  health: 1  stateStr: "PRIMARY"
        
          4
          
          // SECONDARY health: 1  stateStr: "SECONDARY"
        
      
    

四、创建用户与开启认证

bash
      
        
          1
          
          # 创建管理员
        
          2
          
          mongo 127.0.0.1:27017/admin --eval '
        
          3
          
            db.createUser({
        
          4
          
              user: "admin",
        
          5
          
              pwd: "123456",
        
          6
          
              roles: [{ role: "root", db: "admin" }]
        
          7
          
            })
        
          8
          
          '
        
      
    

之后连接必须带用户名密码:

bash
      
        
          1
          
          mongo 192.168.1.100:27017/admin -u admin -p 123456
        
      
    

五、测试高可用

bash
      
        
          1
          
          # 在主库写入测试数据
        
          2
          
          mongo 192.168.1.100:27017/test -u admin -p 123456 \
        
          3
          
            --eval 'db.test.insert({msg: "副本集测试"})'
        
          4
          
          
        
          5
          
          # 模拟主库故障
        
          6
          
          systemctl stop mongod
        
          7
          
          
        
          8
          
          # 等待几秒,查看从库状态
        
          9
          
          docker exec mongo_node1 mongo --eval 'rs.status()'
        
          10
          
          # 从库自动变成 PRIMARY
        
          11
          
          
        
          12
          
          # 恢复主库后,它会作为从库重新加入
        
          13
          
          systemctl start mongod
        
      
    

六、应用连接

javascript
      
        
          1
          
          // Node.js
        
          2
          
          const uri = 'mongodb://admin:密码@192.168.1.100:27017,192.168.1.101:8017/mydb?replicaSet=rs0';
        
          3
          
          
        
          4
          
          // Java
        
          5
          
          MongoClientURI uri = new MongoClientURI(
        
          6
          
            "mongodb://admin:密码@192.168.1.100:27017,192.168.1.101:8017/mydb?replicaSet=rs0"
        
          7
          
          );
        
      
    

七、总结

text
      
        
          1
          
          ✅ 主从自动同步
        
          2
          
          ✅ 主库挂了自动切换
        
          3
          
          ✅ 节点间加密通信
        
          4
          
          ✅ 客户端认证保护
        
          5
          
          ❌ 注意版本统一(主从必须兼容)
        
      
    

这篇文章对你有帮助吗?