246 lines
5.9 KiB
Markdown
246 lines
5.9 KiB
Markdown
# MinIO集群快速配置指南
|
||
|
||
## 🎯 配置目标
|
||
|
||
基于67和68机器的MinIO启动脚本，配置4节点MinIO分布式集群：
|
||
- **67机器**: 2个数据目录（节点1和节点2）
|
||
- **68机器**: 2个数据目录（节点3和节点4）
|
||
- **集群规模**: 4节点集群（支持1个节点故障）
|
||
|
||
---
|
||
|
||
## ⚡ 快速配置（5步完成）
|
||
|
||
### 第一步：准备数据目录
|
||
|
||
**在67机器上**：
|
||
```bash
|
||
mkdir -p /iflytek/soft/minio/data1
|
||
mkdir -p /iflytek/soft/minio/data2
|
||
chmod 755 /iflytek/soft/minio/data1 /iflytek/soft/minio/data2
|
||
```
|
||
|
||
**在68机器上**：
|
||
```bash
|
||
mkdir -p /iflytek/soft/minio/data1
|
||
mkdir -p /iflytek/soft/minio/data2
|
||
chmod 755 /iflytek/soft/minio/data1 /iflytek/soft/minio/data2
|
||
```
|
||
|
||
---
|
||
|
||
### 第二步：部署集群启动脚本
|
||
|
||
**在67机器上**：
|
||
```bash
|
||
# 复制集群启动脚本
|
||
cp "67 机器的minio-cluster-start.sh" /iflytek/soft/minio/minio-cluster-start.sh
|
||
chmod +x /iflytek/soft/minio/minio-cluster-start.sh
|
||
```
|
||
|
||
**在68机器上**：
|
||
```bash
|
||
# 复制集群启动脚本
|
||
cp "68 机器的minio-cluster-start.sh" /iflytek/soft/minio/minio-cluster-start.sh
|
||
chmod +x /iflytek/soft/minio/minio-cluster-start.sh
|
||
```
|
||
|
||
---
|
||
|
||
### 第三步：停止现有单机服务
|
||
|
||
**在67机器上**：
|
||
```bash
|
||
pkill -f 'minio server' || true
|
||
```
|
||
|
||
**在68机器上**：
|
||
```bash
|
||
pkill -f 'minio server' || true
|
||
```
|
||
|
||
---
|
||
|
||
### 第四步：启动集群（必须同时启动）
|
||
|
||
**⚠️ 重要**：MinIO集群要求所有节点**同时启动**（时间差不超过几秒）。
|
||
|
||
#### 方法1：使用快速启动脚本（推荐）
|
||
|
||
```bash
|
||
# 在任意一台机器上执行（需要SSH免密登录）
|
||
cd /path/to/部署文档/生产环境双机部署方案/部署脚本/
|
||
./start-minio-cluster.sh
|
||
```
|
||
|
||
#### 方法2：手动同时启动
|
||
|
||
**在67机器上**：
|
||
```bash
|
||
cd /iflytek/soft/minio
|
||
./minio-cluster-start.sh
|
||
```
|
||
|
||
**在68机器上**（几乎同时）：
|
||
```bash
|
||
cd /iflytek/soft/minio
|
||
./minio-cluster-start.sh
|
||
```
|
||
|
||
---
|
||
|
||
### 第五步：验证集群状态
|
||
|
||
```bash
|
||
# 使用验证脚本
|
||
cd /path/to/部署文档/生产环境双机部署方案/部署脚本/
|
||
./verify-minio-cluster.sh
|
||
```
|
||
|
||
**或手动验证**：
|
||
```bash
|
||
# 安装MinIO客户端
|
||
wget https://dl.min.io/client/mc/release/linux-amd64/mc
|
||
chmod +x mc
|
||
sudo mv mc /usr/local/bin/
|
||
|
||
# 配置集群别名
|
||
mc alias set minio-cluster http://172.16.0.67:9000 minioadmin minioadmin@123456
|
||
|
||
# 查看集群信息
|
||
mc admin info minio-cluster
|
||
|
||
# 查看集群健康状态
|
||
mc admin heal minio-cluster --dry-run
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ 配置验证清单
|
||
|
||
- [ ] 67机器数据目录已创建（data1和data2）
|
||
- [ ] 68机器数据目录已创建（data1和data2）
|
||
- [ ] 集群启动脚本已部署到两台机器
|
||
- [ ] 现有单机服务已停止
|
||
- [ ] 两台机器同时启动集群服务
|
||
- [ ] 集群节点状态正常（`mc admin info`）
|
||
- [ ] 集群健康检查通过（`mc admin heal --dry-run`）
|
||
- [ ] 测试文件上传下载成功
|
||
|
||
---
|
||
|
||
## 📋 集群配置信息
|
||
|
||
### 端点配置
|
||
|
||
**67机器端点**：
|
||
- 本地: `/iflytek/soft/minio/data1` 和 `/iflytek/soft/minio/data2`
|
||
- 远程: `http://172.16.0.68:9000/iflytek/soft/minio/data1` 和 `http://172.16.0.68:9000/iflytek/soft/minio/data2`
|
||
|
||
**68机器端点**（与67机器完全一致）：
|
||
- 远程: `http://172.16.0.67:9000/iflytek/soft/minio/data1` 和 `http://172.16.0.67:9000/iflytek/soft/minio/data2`
|
||
- 本地: `/iflytek/soft/minio/data1` 和 `/iflytek/soft/minio/data2`
|
||
|
||
### 访问信息
|
||
|
||
- **67机器控制台**: http://172.16.0.67:9001
|
||
- **68机器控制台**: http://172.16.0.68:9001
|
||
- **67机器API**: http://172.16.0.67:9000
|
||
- **68机器API**: http://172.16.0.68:9000
|
||
- **用户名**: minioadmin
|
||
- **密码**: minioadmin@123456
|
||
|
||
---
|
||
|
||
## 🔧 常用命令
|
||
|
||
### 服务管理
|
||
|
||
```bash
|
||
# 启动集群（两台机器同时执行）
|
||
./minio-cluster-start.sh
|
||
|
||
# 停止集群
|
||
pkill -f 'minio server'
|
||
|
||
# 查看日志
|
||
tail -f /iflytek/soft/minio/logs/minio.log
|
||
```
|
||
|
||
### 集群管理
|
||
|
||
```bash
|
||
# 查看集群信息
|
||
mc admin info minio-cluster
|
||
|
||
# 查看集群健康状态
|
||
mc admin heal minio-cluster --dry-run
|
||
|
||
# 修复集群数据
|
||
mc admin heal minio-cluster
|
||
|
||
# 查看集群节点状态
|
||
mc admin service status minio-cluster
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ 重要注意事项
|
||
|
||
1. **同时启动**：所有节点必须在几秒内同时启动
|
||
2. **端点一致**：所有节点必须使用完全相同的端点列表
|
||
3. **网络互通**：确保两台机器网络互通，端口9000和9001可访问
|
||
4. **数据目录**：确保数据目录路径在两台机器上完全一致
|
||
5. **权限设置**：确保MinIO进程有数据目录的读写权限
|
||
|
||
---
|
||
|
||
## 🔍 故障排查
|
||
|
||
### 集群无法启动
|
||
|
||
```bash
|
||
# 检查网络连通性
|
||
ping 172.16.0.67
|
||
ping 172.16.0.68
|
||
telnet 172.16.0.67 9000
|
||
telnet 172.16.0.68 9000
|
||
|
||
# 检查日志
|
||
tail -f /iflytek/soft/minio/logs/minio.log
|
||
```
|
||
|
||
### 节点状态异常
|
||
|
||
```bash
|
||
# 检查节点日志
|
||
tail -f /iflytek/soft/minio/logs/minio.log
|
||
|
||
# 执行集群修复
|
||
mc admin heal minio-cluster
|
||
|
||
# 重启异常节点
|
||
pkill -f 'minio server'
|
||
./minio-cluster-start.sh
|
||
```
|
||
|
||
---
|
||
|
||
## 📚 相关文档
|
||
|
||
- [MinIO集群配置指南（基于启动脚本）.md](./MinIO集群配置指南（基于启动脚本）.md) - 完整配置文档
|
||
- [MinIO集群Nginx配置指南.md](./MinIO集群Nginx配置指南.md) - **MinIO集群nginx负载均衡配置（推荐）**
|
||
- [MinIO高可用配置指南.md](./MinIO高可用配置指南.md) - 高可用方案对比
|
||
- [67 机器的minio-cluster-start.sh](./配置文件/67%20机器的minio-cluster-start.sh) - 67机器集群启动脚本
|
||
- [68 机器的minio-cluster-start.sh](./配置文件/68%20机器的minio-cluster-start.sh) - 68机器集群启动脚本
|
||
- [nginx-minio-cluster.conf](./配置文件/nginx-minio-cluster.conf) - nginx配置文件模板
|
||
- [start-minio-cluster.sh](./部署脚本/start-minio-cluster.sh) - 快速启动脚本
|
||
- [verify-minio-cluster.sh](./部署脚本/verify-minio-cluster.sh) - 集群验证脚本
|
||
|
||
---
|
||
|
||
**📝 文档版本**: v1.0
|
||
**🔄 最后更新**: 2025-01-27
|
||
**✅ 适用场景**: 67/68双机MinIO集群快速配置
|
||
|