在运维工作中，MinIO 基本操作速查.

1. 别名管理

# 添加别名（连接 MinIO 服务端）
mc alias set myminio http://IP:端口 minioadmin minioadmin

# 查看所有别名
mc alias list

# 删除别名
mc alias rm myminio

2. 桶（Bucket）管理

# 列出所有桶
mc ls myminio

# 创建桶
mc mb myminio/mybucket

# 删除空桶
mc rb myminio/mybucket

# 删除非空桶（强制）
mc rb --force myminio/mybucket

# 查看桶大小
mc du myminio/mybucket

3. 文件/对象操作

# 上传单个文件
mc cp localfile.txt myminio/mybucket/

# 上传整个目录（递归）
mc cp -r localdir/ myminio/mybucket/

# 同步本地到远端（只传变化的）
mc sync localdir/ myminio/mybucket/

# 下载文件
mc cp myminio/mybucket/file.txt ./

# 下载整个目录
mc cp -r myminio/mybucket/ ./

# 列出桶内文件
mc ls myminio/mybucket/

# 递归列出
mc ls --recursive myminio/mybucket/

# 删除单个文件
mc rm myminio/mybucket/file.txt

# 递归删除目录
mc rm -r myminio/mybucket/dir/

# 移动/重命名（桶内或跨桶）
mc mv myminio/mybucket/old.txt myminio/mybucket/new.txt

4. 管理员操作

# 查看集群状态
mc admin info myminio

# 查看服务端配置
mc admin config get myminio

# 重启服务
mc admin service restart myminio

# 停止服务
mc admin service stop myminio

# 数据修复扫描
mc admin heal -r myminio

# 查看用户列表
mc admin user list myminio

# 创建用户
mc admin user add myminio newuser newpassword

# 禁用/启用用户
mc admin user disable myminio newuser
mc admin user enable myminio newuser

# 查看策略列表
mc admin policy list myminio

# 创建策略
mc admin policy add myminio readonly readonly.json

5. 访问策略（Policy）

# 查看桶的访问策略
mc anonymous get myminio/mybucket

# 设置桶为公开读
mc anonymous set download myminio/mybucket

# 设置桶为公开读写
mc anonymous set public myminio/mybucket

# 取消公开访问
mc anonymous set none myminio/mybucket

6. 事件通知

# 查看桶的事件通知配置
mc event list myminio/mybucket

# 添加 AMQP 事件通知（上传/删除时触发）
mc event add myminio/mybucket arn:minio:sqs::1:amqp --event put,delete

# 删除事件通知
mc event rm myminio/mybucket arn:minio:sqs::1:amqp

7. 版本管理

# 开启版本控制
mc version enable myminio/mybucket

# 关闭版本控制
mc version suspend myminio/mybucket

# 查看版本状态
mc version info myminio/mybucket

8. 生命周期规则

# 设置过期规则（30天后自动删除）
mc ilm add --expiry-days 30 myminio/mybucket

# 设置前缀过期规则
mc ilm add --expiry-days 90 --prefix "logs/" myminio/mybucket

# 查看生命周期规则
mc ilm ls myminio/mybucket

9. 常用查询

# 查看磁盘使用量
mc admin info myminio          # 集群级别
mc du myminio/                 # 全量
mc du myminio/mybucket         # 单桶

# 查看文件详情（大小、类型、修改时间）
mc stat myminio/mybucket/file.txt

# 查看存储分类
mc admin info myminio --json

最常用 5 条

mc ls myminio/                         # 看有哪些桶
mc cp file.txt myminio/bucket/         # 上传文件
mc cp -r myminio/bucket/ ./            # 下载目录
mc admin info myminio                  # 看集群健康
mc admin heal -r myminio              # 修复数据

---