# MinIO主从配置快速指南

## 🎯 配置目标

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

---

## ⚡ 快速配置（3步完成）

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

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

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

---

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

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

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

**脚本会自动完成**：
- ✅ 安装MinIO客户端（mc）
- ✅ 测试网络连通性
- ✅ 配置MinIO别名
- ✅ 创建同步脚本和服务

---

### 第三步：启动同步服务

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

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

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

---

## ✅ 验证配置

```bash
# 在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`

---

## 🔧 常用命令

```bash
# 服务管理
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) - 完整配置指南
- [MinIO高可用配置指南.md](./MinIO高可用配置指南.md) - 高可用方案对比

---

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