前置要求Linux服务器Ubuntu/CentOS/Debian等已安装Docker和Docker Compose服务器开放9000和9001端口或自定义端口方法一使用Docker命令直接运行推荐快速测试1. 拉取MinIO镜像docker pull minio/minio2. 创建数据目录mkdir -p /opt/minio/data mkdir -p /opt/minio/config3. 运行MinIO容器docker run -d \ --name minio \ --restartalways \ -p 9000:9000 \ -p 9001:9001 \ -e MINIO_ROOT_USERminio123 \ -e MINIO_ROOT_PASSWORDminio123 \ -v /opt/minio/data:/data \ -v /opt/minio/config:/root/.minio \ minio/minio server /data \ --console-address :9001参数说明-d: 后台运行--name minio: 容器名称--restartalways: 开机自启-p 9000:9000: API端口映射-p 9001:9001: 控制台端口映射-e MINIO_ROOT_USER: 管理员用户名-e MINIO_ROOT_PASSWORD: 管理员密码-v /opt/minio/data:/data: 数据目录挂载--console-address :9001: 控制台访问地址方法二使用Docker Compose推荐生产环境1. 创建docker-compose.yml文件mkdir -p /opt/minio cd /opt/minio vim docker-compose.yml2. docker-compose.yml内容version: 3.8 ​ services: minio: image: minio/minio:latest container_name: minio restart: always ports: - 9000:9000 # API端口 - 9001:9001 # 控制台端口 environment: MINIO_ROOT_USER: minio123 MINIO_ROOT_PASSWORD: minio123 volumes: - ./data:/data - ./config:/root/.minio command: server /data --console-address :9001 healthcheck: test: [CMD, curl, -f, http://localhost:9000/minio/health/live] interval: 30s timeout: 20s retries: 33. 启动MinIO# 创建数据目录 mkdir -p data config​ # 启动服务 docker-compose up -d ​ # 查看日志 docker-compose logs -f minio4. 停止和重启# 停止 docker-compose down ​ # 重启 docker-compose restart ​ # 查看状态 docker-compose ps方法三使用自定义配置生产环境推荐1. 创建配置文件mkdir -p /opt/minio/{data,config}2. 运行容器自定义端口和路径docker run -d \ --name minio \ --restartalways \ -p 9000:9000 \ -p 9001:9001 \ -e MINIO_ROOT_USER你的用户名 \ -e MINIO_ROOT_PASSWORD你的强密码 \ -v /opt/minio/data:/data \ -v /opt/minio/config:/root/.minio \ minio/minio server /data \ --console-address :9001 \ --address :9000访问MinIOAPI访问地址http://你的服务器IP:9000控制台访问地址http://你的服务器IP:9001使用配置的用户名和密码登录控制台。与项目配置对接根据您的application.yml配置确保以下设置minio: endpoint: http://132.232.198.207:9000 # 修改为你的服务器IP accessKey: minio123 # 与MINIO_ROOT_USER一致 secretKey: minio123 # 与MINIO_ROOT_PASSWORD一致 bucketName: zhiyan usePathStyleAccess: true enable: true创建存储桶Bucket方法1通过控制台创建访问http://你的服务器IP:9001登录后点击Create Bucket输入桶名称zhiyan设置访问策略如果需要公开访问方法2使用MinIO客户端mc# 下载mc客户端 wget https://dl.min.io/client/mc/release/linux-amd64/mc chmod x mc mv mc /usr/local/bin/ # 配置MinIO服务器 mc alias set myminio http://你的服务器IP:9000 minio123 minio123 # 创建存储桶 mc mb myminio/zhiyan # 设置存储桶策略公开读 mc anonymous set download myminio/zhiyan # 列出存储桶 mc ls myminio防火墙配置CentOS/RHEL# 开放端口 firewall-cmd --permanent --add-port9000/tcp firewall-cmd --permanent --add-port9001/tcp firewall-cmd --reloadUbuntu/Debian# 使用ufw ufw allow 9000/tcp ufw allow 9001/tcp ufw reload数据备份MinIO的数据存储在挂载的目录中定期备份/opt/minio/data目录即可# 备份示例 tar -czf minio-backup-$(date %Y%m%d).tar.gz /opt/minio/data常用管理命令# 查看容器状态 docker ps | grep minio # 查看日志 docker logs -f minio # 进入容器 docker exec -it minio sh # 停止容器 docker stop minio # 启动容器 docker start minio # 删除容器注意不会删除数据 docker rm minio # 查看资源使用 docker stats minio故障排查1. 端口被占用# 检查端口占用 netstat -tulpn | grep 9000 lsof -i:9000 # 修改端口映射 # 将 -p 9000:9000 改为 -p 其他端口:90002. 权限问题# 确保数据目录有写权限 chmod -R 777 /opt/minio/data chown -R 1000:1000 /opt/minio/data # MinIO默认使用UID 10003. 无法访问控制台检查防火墙设置确认控制台端口映射正确应该是9001检查容器日志docker logs minio4. 连接超时检查网络连接验证endpoint地址是否正确检查防火墙和SELinux设置生产环境建议使用强密码不要使用默认的minio123改为复杂密码启用SSL/TLS生产环境建议配置HTTPS定期备份设置自动备份任务监控资源监控磁盘空间和容器资源使用日志管理配置日志轮转避免日志文件过大多节点部署生产环境考虑MinIO分布式部署验证安装安装完成后运行以下命令验证# 检查容器状态 docker ps | grep minio # 测试API curl http://localhost:9000/minio/health/live # 访问控制台 curl -I http://localhost:9001如果都能正常响应说明MinIO安装成功