Linux Minio怎么排查

在 Linux 上排查 MinIO 问题，一般从 服务状态、日志、端口、磁盘、权限、配置、客户端 这几个方向入手。下面给你一套实用排查清单，从最常见到进阶。

一、确认 MinIO 服务状态

1️⃣ 如果用 systemd

systemctl status minio
journalctl -u minio -f

常见状态：

• active (running) ✅
• failed ❌（看日志）

2️⃣ 如果是 Docker 运行

docker ps -a
docker logs minio

二、查看 MinIO 日志（最重要）

本地启动（前台）

minio server /data

systemd 环境

journalctl -u minio -n 100

Docker

docker logs -f minio

重点看：

• ERROR
• Unable to initialize backend
• disk is full
• permission denied
• port already in use

三、端口与网络排查

1️⃣ 确认端口是否监听

ss -lntp | grep 9000
ss -lntp | grep 9001

默认：

• 9000：API
• 9001：Console（新版）

2️⃣ 测试端口是否通

curl http://127.0.0.1:9000/minio/health/live

返回：

OK

✅ 说明服务正常

四、磁盘与权限问题（非常常见）

1️⃣ 磁盘是否挂载 / 满了

df -h
lsblk

MinIO 不支持磁盘满运行。

2️⃣ 数据目录权限

ls -ld /data

MinIO 启动用户必须能写：

chown -R minio-user:minio-user /data
chmod -R 755 /data

⚠️ 不要用 root 启动 MinIO，但数据目录又没权限

五、配置文件与环境变量

常见环境变量

MINIO_ROOT_USER
MINIO_ROOT_PASSWORD
MINIO_VOLUMES
MINIO_OPTS

systemd 示例

[Service]
Environment="MINIO_ROOT_USER=minioadmin"
Environment="MINIO_ROOT_PASSWORD=minioadmin"

检查：

systemctl cat minio

六、客户端 mc 排查

1️⃣ 配置 host

mc alias set local http://127.0.0.1:9000 minioadmin minioadmin

2️⃣ 测试连通

mc admin info local
mc ls local

错误示例：

• Access Denied → 用户名/密码错误
• Connection refused → 服务没起来

七、常见错误速查表

八、SELinux / 防火墙（出现概率高）

SELinux

getenforce
setenforce 0   # 临时关闭测试

防火墙

firewall-cmd --list-ports
firewall-cmd --add-port=9000/tcp --permanent
firewall-cmd --add-port=9001/tcp --permanent
firewall-cmd --reload

九、快速自检命令（推荐直接跑）

systemctl status minio
journalctl -u minio -n 50
ss -lntp | grep 9000
df -h
mc admin info local

十、如果你愿意，我可以进一步帮你

你可以直接贴：

1. 启动方式（systemd / docker / 二进制）
2. 报错日志
3. minio server 的完整启动命令
4. df -h 输出

我可以 直接帮你定位是哪一步出问题 ✅