CentOS 上安装 MinIO 的常见问题与排查要点
一 端口与防火墙
- 默认监听端口为 API：9000、Console：9001，需确保云安全组与系统防火墙均已放行；使用 firewalld 的典型命令：firewall-cmd --zone=public --add-port=9000/tcp --permanent && firewall-cmd --zone=public --add-port=9001/tcp --permanent && firewall-cmd --reload。若仍无法访问，检查是否仅放行了 9000 而遗漏 9001，或云厂商安全组策略未同步生效。
二 权限与用户
- 运行身份与目录权限不匹配是高频问题：创建系统用户（如 minio-user）后，需确保数据目录（如 /mnt/data）归属该用户，例如 chown -R minio-user:minio-user /mnt/data；服务单元中的 User/Group 要与目录属主一致。若使用 root 运行，注意与最小权限原则权衡。
- SELinux 处于 enforcing 模式时，可能因权限上下文导致访问被拒；可先临时 setenforce 0 验证，再按需为目录设置正确的 SELinux 上下文或策略，避免直接永久禁用 SELinux。
三 systemd 服务与启动超时
- 服务启动超时或卡住，常见于 Type=simple 下前台进程未及时转入后台、或 ExecStartPre 校验失败导致退出；建议：使用官方推荐的 service 模板，正确设置 EnvironmentFile（如 /etc/default/minio）、WorkingDirectory、User/Group，并在 [Service] 中使用标准 ExecStart=/usr/local/bin/minio server $MINIO_OPTS $MINIO_VOLUMES；必要时调整 TimeoutStartSec/TimeoutStopSec，并通过 journalctl -u minio.service -xe 定位具体报错行。
四 代理与客户端 403
- 通过 Nginx 反向代理后，SDK/客户端使用 presigned_put_object 生成的 URL 所含 endpoint（IP:端口） 若与代理转发目标不一致，MinIO 会拒绝 PUT，返回 403 Forbidden。需在代理配置中确保 proxy_pass 的目标地址与客户端 endpoint 完全一致，并正确设置请求头（如 Host），避免签名校验失败。
五 版本兼容与日志定位
- 老旧系统（如 CentOS 7.x 早期内核/库）可能与新版本 MinIO 存在兼容性问题；建议优先使用 CentOS 7.9+ 或更高版本，并保持 MinIO 版本与系统组件匹配。排查时优先查看服务日志：journalctl -u minio.service -xe；若使用二进制或 RPM 安装，亦可在数据目录（如 /data/minio/logs）查找更详细的启动与运行日志，以快速定位配置、权限或网络问题。
