hzdyjs/docs/部署文档/生产环境双机部署方案/MinIO主从配置快速指南.md

MinIO主从配置快速指南

🎯 配置目标

• 67机器: MinIO主节点（数据源）
• 68机器: MinIO从节点（数据同步目标）
• 同步方式: 实时同步（watch模式）

---

⚡ 快速配置（3步完成）

第一步：确保两台机器MinIO服务运行

# 在67机器上
/path/to/67\ 机器的minio-start.sh
ps aux | grep minio  # 确认服务运行

# 在68机器上
/path/to/68\ 机器的minio-start.sh
ps aux | grep minio  # 确认服务运行

---

第二步：在68机器上执行配置脚本

# 进入部署脚本目录
cd /path/to/部署文档/生产环境双机部署方案/部署脚本/

# 执行配置脚本
chmod +x setup-minio-replication.sh
./setup-minio-replication.sh

脚本会自动完成：

• ✅ 安装MinIO客户端（mc）
• ✅ 测试网络连通性
• ✅ 配置MinIO别名
• ✅ 创建同步脚本和服务

---

第三步：启动同步服务

# 执行初始同步（一次性，同步现有数据）
mc mirror --remove --overwrite minio-master/ minio-slave/

# 启动实时同步服务
systemctl start minio-sync
systemctl enable minio-sync

# 查看服务状态
systemctl status minio-sync

---

✅ 验证配置

# 在67机器上上传测试文件
echo "test sync" > test.txt
mc cp test.txt minio-master/ruoyi/

# 在68机器上检查（等待5-10秒）
mc ls minio-slave/ruoyi/ | grep test.txt

# 查看同步日志
tail -f /var/log/minio-sync.log

---

📋 配置信息

当前配置参数

• 主节点IP: 172.16.0.67
• 从节点IP: 172.16.0.68
• 端口: 9000
• 用户名: minioadmin
• 密码: minioadmin@123456

重要文件位置

• 同步脚本: /opt/minio-sync.sh
• 同步服务: /etc/systemd/system/minio-sync.service
• 同步日志: /var/log/minio-sync.log
• MinIO客户端: /usr/local/bin/mc

---

🔧 常用命令

# 服务管理
systemctl start minio-sync      # 启动
systemctl stop minio-sync       # 停止
systemctl restart minio-sync    # 重启
systemctl status minio-sync     # 状态

# 日志查看
tail -f /var/log/minio-sync.log
journalctl -u minio-sync -f

# 手动同步
mc mirror --remove --overwrite minio-master/ minio-slave/

# 检查数据一致性
mc du minio-master/
mc du minio-slave/

---

⚠️ 注意事项

1. 同步脚本必须在68机器上执行
2. 确保两台机器网络互通
3. 确保9000端口可访问
4. 初始同步可能需要较长时间（取决于数据量）
5. 实时同步有秒级延迟，属于正常现象

---

📚 详细文档

• 基于现有启动脚本的MinIO主从配置.md - 完整配置指南
• MinIO高可用配置指南.md - 高可用方案对比

---

📝 文档版本: v1.0
🔄 最后更新: 2025-01-27