GeekIt

MinIO mc命令速查

别名配置、桶与对象操作、镜像同步、版本与生命周期、用户策略、匿名访问、复制多站点、监控自愈与报错排查等 165 条命令

共 165 条命令 · 12 类场景 · 点击右侧图标可复制

命令 / 配置说明复制
mc --version查看 mc 客户端版本
mc --help查看全部子命令
mc update升级 mc 到最新版本
curl -O https://dl.min.io/client/mc/release/linux-amd64/mc && chmod +x mc下载并赋可执行权限
mc --config-dir /etc/mc alias set prod http://10.0.0.11:9000 admin password指定配置目录,多租户运维常用
~/.mc/config.json别名与凭据存储位置,权限应为 600
export MC_HOST_prod=http://admin:password@10.0.0.11:9000用环境变量定义别名,避免落盘凭据
mc admin info prod连接验证:查看集群节点与容量
mc admin service restart prod重启 MinIO 服务
mc admin config get prod导出全部服务端配置
mc admin config set prod api requests_max=1600动态修改服务端配置
mc admin config reset prod api恢复某个配置块的默认值
mc admin update prod在线升级服务端(谨慎,注意版本兼容)
命令 / 配置说明复制
mc alias set prod http://10.0.0.11:9000 admin password添加别名,等价于保存一组 endpoint + 凭据
mc alias set prod https://s3.example.com AK SK --api S3v4对接兼容 S3 的对象存储
mc alias set prod https://s3.example.com AK SK --insecure跳过证书校验(仅测试环境)
mc alias list列出所有别名与 endpoint
mc alias list --jsonJSON 输出,便于脚本处理
mc alias remove prod删除别名
mc admin info prod查看节点数、驱动数、在线状态与容量
mc admin info prod --jsonJSON 输出用于监控采集
mc admin trace prod --verbose实时打印 API 调用与耗时,排障利器
mc admin trace prod --status-code 500只看 5xx 请求
mc admin top locks prod查看当前锁与阻塞情况
mc admin logs prod拉取服务端日志(需服务端支持)
mc admin prometheus generate prod生成 Prometheus 抓取配置
命令 / 配置说明复制
mc mb prod/data创建桶
mc mb --with-versioning prod/data创建桶并开启版本控制
mc mb --with-lock prod/audit创建支持对象锁定的桶(合规场景)
mc ls prod列出全部桶
mc ls prod/data列出桶内对象
mc ls --recursive --summarize prod/data递归统计对象数与总容量
mc du prod/data统计桶占用空间
mc stat prod/data/object.log查看对象大小、ETag、存储类与元数据
mc rb prod/data删除空桶
mc rb --force --dangerous prod/data强制删除桶及全部对象(危险)
mc tree prod/data --depth 2以树形展示桶内目录结构
mc event add prod/data arn:minio:sqs::1:webhook --event put配置桶事件通知
mc event ls prod/data查看桶的事件订阅
桶名必须全局唯一且符合 DNS 规则大写字母与下划线都会导致创建失败
命令 / 配置说明复制
mc cp app.tar.gz prod/data/releases/上传文件到桶内路径
mc cp --recursive ./logs prod/data/logs/递归上传目录
mc cp --recursive --preserve ./etc prod/backup/保留权限与时间戳
mc cp --attr "Cache-Control=max-age=3600" index.html prod/web/上传时设置对象元数据
mc cp --storage-class REDUCED_REDUNDANCY big.bin prod/data/指定存储类(兼容 S3 时使用)
mc cp --encrypt-key "prod/data/=32byteslongsecretkey" a.txt prod/data/客户端加密上传(SSE-C)
mc cp prod/data/app.tar.gz ./下载对象到本地
mc cp --recursive prod/data/logs/ ./logs/递归下载
mc cat prod/data/config.yaml直接输出对象内容,不落盘
mc head -n 20 prod/data/app.log查看对象前 20 行
mc pipe prod/data/dump.gz < backup.sql.gz从标准输入流式上传
mc mv prod/tmp/a.log prod/data/a.log移动或重命名对象
mc rm prod/data/old.log删除单个对象
mc rm --recursive --force --older-than 7d prod/data/logs/按时间批量清理
mc find prod/data --name "*.log" --older-than 30d按条件查找对象,配合 rm 做生命周期清理
mc diff ./local prod/data/backup对比本地与远端差异,只上传变化部分
命令 / 配置说明复制
mc mirror ./site prod/web把本地目录同步到桶
mc mirror prod/data /backup/data把桶同步到本地目录
mc mirror --overwrite --remove prod/src prod/dst源端删除也同步到目标端(严格一致)
mc mirror --watch ./site prod/web持续监听变化实时同步
mc mirror --preserve --attr ./data prod/backup保留元数据与权限
mc mirror --exclude "*.tmp" --exclude ".git/*" ./site prod/web排除不需要同步的文件
mc mirror --newer-than 24h prod/logs /backup/logs只同步最近 24 小时变化
mc mirror --summary ./site prod/web只输出同步统计,不实际传输
mc replicate add prod/data --remote-bucket http://10.0.0.12:9000/data --replicate delete,delete-marker配置桶级复制到另一集群
mc replicate status prod/data查看复制状态与延迟
mc replicate resync start prod/data触发全量重新同步
mc mirror 与 replicate 的区别mirror 是客户端拉取,replicate 是服务端异步复制
命令 / 配置说明复制
mc version enable prod/data开启桶版本控制
mc version info prod/data查看版本控制状态
mc version suspend prod/data暂停版本控制(历史版本仍保留)
mc ls --versions prod/data/app.log列出对象的所有版本
mc rm --versions prod/data/app.log删除对象全部版本(彻底清理)
mc ilm rule add --expire-days 30 --prefix logs/ prod/data为 logs/ 前缀添加 30 天过期规则
mc ilm rule add --noncurrent-expire-days 7 prod/data非当前版本 7 天后清理
mc ilm rule add --transition-days 60 --transition-tier COLDTIER prod/data分层转储到低频存储
mc ilm rule ls prod/data查看生命周期规则
mc ilm rule rm --id "cm9vdA" prod/data删除指定规则
mc ilm export prod/data导出规则做备份或迁移
mc ilm import prod/data < lifecycle.json导入规则
mc retention set --default GOVERNANCE --default-days 30 prod/audit设置默认对象锁定保留策略
mc retention info prod/audit/file.log查看对象保留状态与到期时间
mc legalhold set --on prod/audit/file.log开启法律保留,阻止删除
命令 / 配置说明复制
mc admin user add prod app "Str0ng!Pass"创建用户
mc admin user list prod列出用户与启用状态
mc admin user info prod app查看用户所属策略
mc admin user disable prod app禁用用户(保留配置)
mc admin user enable prod app启用用户
mc admin user remove prod app删除用户
mc admin user svcacct add prod app --access-key appkey --secret-key appsecret为用户创建服务账号(长期凭据)
mc admin user svcacct ls prod app列出服务账号
mc admin user svcacct rm prod <access-key>删除服务账号
mc admin policy create prod readonly /etc/minio/readonly.json用 JSON 创建自定义策略
mc admin policy list prod列出内置与自定义策略
mc admin policy info prod readonly查看策略内容
mc admin policy attach prod readonly --user app把策略绑定到用户
mc admin policy detach prod readonly --user app解绑策略
mc admin policy entities prod --user app查看某用户生效的全部策略
最小权限原则:按桶前缀授权不要直接给 consoleAdmin,避免误删
命令 / 配置说明复制
mc admin group add prod devs app1 app2创建用户组并添加成员
mc admin group list prod列出用户组
mc admin group info prod devs查看组成员与状态
mc admin group enable prod devs启用组
mc admin group disable prod devs禁用组,组内成员随之失效
mc admin group rm prod devs删除组
mc admin policy attach prod readonly --group devs给组绑定策略
mc anonymous get prod/web查看桶的匿名访问策略
mc anonymous set download prod/web开启匿名只读下载(静态站点常用)
mc anonymous set upload prod/inbox允许匿名上传(谨慎)
mc anonymous set none prod/web关闭匿名访问
mc share download --expire 7d prod/data/report.pdf生成 7 天有效的临时下载链接
mc share upload prod/inbox生成临时上传链接
mc share list upload查看已生成的临时上传链接
命令 / 配置说明复制
mc replicate add prod/data --remote-bucket backup/data --replicate delete桶级复制到远端
mc replicate ls prod/data查看复制规则
mc replicate status prod/data查看复制进度与失败数
mc replicate resync start prod/data重新全量同步历史对象
mc replicate rm prod/data --id <rule-id>删除复制规则
mc admin replicate add site-a site-b site-c多站点复制(集群级双向复制)
mc admin replicate info site-a查看站点复制状态
mc admin replicate rm site-a site-b移除站点复制关系
mc admin bucket remote ls prod/data查看桶的远端目标
跨集群复制依赖服务端版本一致版本差异过大可能导致复制规则不生效
命令 / 配置说明复制
mc admin info prod集群节点、驱动与容量总览
mc admin trace prod --verbose实时 API 调用链与耗时
mc admin trace prod --status-code 404只看特定状态码,排查 403/404
mc admin top locks prod查看锁冲突,定位对象被占用
mc admin heal prod/data --recursive触发数据自愈,修复缺失或损坏对象
mc admin heal prod/data --dry-run只检查不修复
mc admin scanner info prod查看后台扫描任务状态
mc admin prometheus generate prod生成抓取配置,接入监控
mc admin config get prod notify_webhook查看事件通知配置
mc watch prod/data监听桶内对象变化
mc admin logs prod --limit 50查看最近服务端日志
mc support diagnostics prod生成诊断包(需订阅版本支持)
命令 / 配置说明复制
mc quota set --size 10GiB prod/data限制桶容量配额
mc quota set --size 1GiB prod/data/user-a按前缀限制配额
mc quota info prod/data查看配额使用情况
mc quota clear --size prod/data取消容量配额
mc encrypt set sse-s3 prod/data开启服务端加密(SSE-S3)
mc encrypt set sse-kms my-key-id prod/data使用 KMS 密钥加密
mc encrypt info prod/data查看桶加密配置
mc encrypt clear prod/data关闭服务端加密(已加密对象仍保留)
mc tag set prod/data/app.log "env=prod&owner=ops"给对象打标签,便于检索与计费
mc tag list prod/data/app.log查看对象标签
mc retention set --default COMPLIANCE --default-days 180 prod/audit合规模式保留,任何账号都无法提前删除
mc legalhold clear prod/audit/file.log解除法律保留后才可以删除
加密与对象锁都需要版本控制未开启版本控制时相关功能会直接报错
命令 / 配置说明复制
Access Denied凭据错误或策略未授权,先 mc admin policy entities 查生效策略
SignatureDoesNotMatchAK/SK 不匹配或时钟偏差,检查 NTP 同步
RequestTimeTooSkewed客户端与服务端时间差超过 15 分钟
NoSuchBucket桶不存在或别名指向了别的集群
NoSuchKey对象不存在,注意前缀与大小写
The specified bucket does not exist桶名拼错或已被删除
connection refusedendpoint 端口错误、服务未启动或网络不通
x509: certificate signed by unknown authority自签证书需加 --insecure 或安装 CA
Unable to initialize new alias地址格式错误或凭据无效,先 curl 探活
Insufficient permissions策略缺少对应 action,检查策略 JSON
Object lock configuration is not enabled桶未开启对象锁定,需重建桶并加 --with-lock
Versioning is not enabled开启版本控制后才能用版本与合规功能
SlowDown服务端限流或负载过高,降低并发重试
mc mirror 卡住不动检查带宽、对象数量与是否被限流,可加 --summary 观察
复制状态长期 pending远端不可达或版本不兼容,先 replicate status 看错误
InvalidObjectName对象名含非法字符或超长,避免空格与控制字符
磁盘写满导致写入失败mc admin info 看剩余容量,及时扩容或清理

运维常用组合

连接自检mc alias set → mc alias list → mc admin info → mc admin trace --status-code 500
业务接入mc mb → mc anonymous set download(静态站) → mc admin user add → policy attach → mc cp 验证
数据搬迁mc mirror --summary 预演 → mc mirror --overwrite --remove → mc diff 校验 → 切换读流量
长期归档mc mb --with-lock → mc version enable → mc retention set --default → mc ilm rule add 分层
故障排查mc admin info 看容量 → mc admin trace 看请求 → mc admin top locks 看锁 → mc admin heal 自愈
多站点容灾mc replicate add 桶级复制 → mc replicate status 看延迟 → mc admin replicate add 站点级 → 定期 resync 校验

常见问题排查

1. 别名就是连接配置

mc alias 保存 endpoint 与凭据,后续命令只需别名;CI 里用 MC_HOST_ 环境变量更安全

2. cp 与 mirror 怎么选

单次搬运用 cp,目录或桶整体同步用 mirror,需要持续同步加 --watch

3. mirror --remove 要谨慎

加 --remove 会删除目标端多余对象,误用可能造成数据丢失,先加 --summary 预演

4. 版本控制是合规前提

对象锁、加密、跨站点复制都依赖版本控制,建桶时就规划好

5. 权限按前缀最小化

策略里用 resource 限定到桶或前缀,不要给 consoleAdmin 这类全量权限

6. 自愈与扫描要定期看

mc admin heal 修复缺失副本,scanner 状态异常说明后台任务卡住

共 165 条 MinIO mc 命令 · 示例中的别名 prod、桶 data 与地址请替换为实际环境

关于MinIO mc命令速查

在线 MinIO mc 客户端命令速查手册,按安装与配置、别名与连接诊断、桶管理、对象上传下载、镜像与增量同步、版本生命周期与保留、用户与策略、分组与匿名访问、复制与多站点、监控审计与运维、配额加密与合规、常见报错与排查等 12 类场景整理 150+ 条常用命令,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 mc --version/update 与 --config-dir 与 ~/.mc/config.json 与 MC_HOST_ 环境变量、mc alias set/list/remove 与 --api S3v4/--insecure、mc admin info/trace/top locks/logs/prometheus generate/service restart/config get|set|reset/update、mc mb 的 --with-versioning/--with-lock 与 mc ls/du/stat/rb --force --dangerous/tree/event add|ls、mc cp 的 --recursive/--preserve/--attr/--storage-class/--encrypt-key 与 mc cat/head/pipe/mv/rm --recursive --force --older-than、mc find 按名称与时间过滤、mc diff 差异对比、mc mirror 的 --overwrite/--remove/--watch/--preserve/--exclude/--newer-than/--summary、mc version enable/info/suspend 与 mc ls --versions 与 mc rm --versions、mc ilm rule add 的 --expire-days/--noncurrent-expire-days/--transition-days 与 ilm rule ls/rm/export/import、mc retention set 的 GOVERNANCE/COMPLIANCE 与 mc legalhold set/clear、mc admin user add/list/info/disable/enable/remove 与 user svcacct add/ls/rm、mc admin policy create/list/info/attach/detach/entities 与 admin group add/list/info/enable/disable/rm、mc anonymous get/set download|upload|none 与 mc share download/upload/list、mc replicate add/status/resync/rm 与 mc admin replicate add/info/rm 与 bucket remote ls、mc admin heal --recursive/--dry-run 与 scanner info 与 mc watch、mc quota set --size/info/clear、mc encrypt set sse-s3/sse-kms/info/clear、mc tag set/list,以及 Access Denied、SignatureDoesNotMatch、RequestTimeTooSkewed、NoSuchBucket、NoSuchKey、x509 unknown authority、Object lock not enabled、Versioning not enabled、SlowDown、InvalidObjectName 等报错排查。适用于 MinIO 对象存储日常运维、S3 兼容接口对接、桶与对象权限治理、目录与桶数据搬迁、版本控制与生命周期分层、镜像与跨集群复制、容量配额与加密合规、监控自愈与故障定位,以及存储运维与面试复习。

核心能力

  • 涵盖 mc --version/update 与 --config-dir 与 ~/.mc/config.json 与 MC_HOST_ 环境变量、mc alias set/list/remove 与 --api S3v4/--insecure、mc admin info/trace/top locks/logs/prometheus generate/service restart/config get|set|reset/update、mc mb 的 --with-versioning/--with-lock 与 mc ls/du/stat/rb --force --dangerous/tree/event add|ls、mc cp 的 --recursive/--preserve/--attr/--storage-class/--encrypt-key 与 mc cat/head/pipe/mv/rm --recursive --force --older-than、mc find 按名称与时间过滤、mc diff 差异对比、mc mirror 的 --overwrite/--remove/--watch/--preserve/--exclude/--newer-than/--summary、mc version enable/info/suspend 与 mc ls --versions 与 mc rm --versions、mc ilm rule add 的 --expire-days/--noncurrent-expire-days/--transition-days 与 ilm rule ls/rm/export/import、mc retention set 的 GOVERNANCE/COMPLIANCE 与 mc legalhold set/clear、mc admin user add/list/info/disable/enable/remove 与 user svcacct add/ls/rm、mc admin policy create/list/info/attach/detach/entities 与 admin group add/list/info/enable/disable/rm、mc anonymous get/set download|upload|none 与 mc share download/upload/list、mc replicate add/status/resync/rm 与 mc admin replicate add/info/rm 与 bucket remote ls、mc admin heal --recursive/--dry-run 与 scanner info 与 mc watch、mc quota set --size/info/clear、mc encrypt set sse-s3/sse-kms/info/clear、mc tag set/list,以及 Access Denied、SignatureDoesNotMatch、RequestTimeTooSkewed、NoSuchBucket、NoSuchKey、x509 unknown authority、Object lock not enabled、Versioning not enabled、SlowDown、InvalidObjectName 等报错排查

适用场景

适用于 MinIO 对象存储日常运维、S3 兼容接口对接、桶与对象权限治理、目录与桶数据搬迁、版本控制与生命周期分层、镜像与跨集群复制、容量配额与加密合规、监控自愈与故障定位,以及存储运维与面试复习。MinIO mc命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

MinIO mc命令速查是免费的吗?需要注册或安装吗?
MinIO mc命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
MinIO mc命令速查支持哪些功能?
涵盖 mc --version/update 与 --config-dir 与 ~/.mc/config.json 与 MC_HOST_ 环境变量、mc alias set/list/remove 与 --api S3v4/--insecure、mc admin info/trace/top locks/logs/prometheus generate/service restart/config get|set|reset/update、mc mb 的 --with-versioning/--with-lock 与 mc ls/du/stat/rb --force --dangerous/tree/event add|ls、mc cp 的 --recursive/--preserve/--attr/--storage-class/--encrypt-key 与 mc cat/head/pipe/mv/rm --recursive --force --older-than、mc find 按名称与时间过滤、mc diff 差异对比、mc mirror 的 --overwrite/--remove/--watch/--preserve/--exclude/--newer-than/--summary、mc version enable/info/suspend 与 mc ls --versions 与 mc rm --versions、mc ilm rule add 的 --expire-days/--noncurrent-expire-days/--transition-days 与 ilm rule ls/rm/export/import、mc retention set 的 GOVERNANCE/COMPLIANCE 与 mc legalhold set/clear、mc admin user add/list/info/disable/enable/remove 与 user svcacct add/ls/rm、mc admin policy create/list/info/attach/detach/entities 与 admin group add/list/info/enable/disable/rm、mc anonymous get/set download|upload|none 与 mc share download/upload/list、mc replicate add/status/resync/rm 与 mc admin replicate add/info/rm 与 bucket remote ls、mc admin heal --recursive/--dry-run 与 scanner info 与 mc watch、mc quota set --size/info/clear、mc encrypt set sse-s3/sse-kms/info/clear、mc tag set/list,以及 Access Denied、SignatureDoesNotMatch、RequestTimeTooSkewed、NoSuchBucket、NoSuchKey、x509 unknown authority、Object lock not enabled、Versioning not enabled、SlowDown、InvalidObjectName 等报错排查。
MinIO mc命令速查适合哪些场景使用?
适用于 MinIO 对象存储日常运维、S3 兼容接口对接、桶与对象权限治理、目录与桶数据搬迁、版本控制与生命周期分层、镜像与跨集群复制、容量配额与加密合规、监控自愈与故障定位,以及存储运维与面试复习。