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 --json | JSON 输出,便于脚本处理 | |
mc alias remove prod | 删除别名 | |
mc admin info prod | 查看节点数、驱动数、在线状态与容量 | |
mc admin info prod --json | JSON 输出用于监控采集 | |
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 查生效策略 | |
SignatureDoesNotMatch | AK/SK 不匹配或时钟偏差,检查 NTP 同步 | |
RequestTimeTooSkewed | 客户端与服务端时间差超过 15 分钟 | |
NoSuchBucket | 桶不存在或别名指向了别的集群 | |
NoSuchKey | 对象不存在,注意前缀与大小写 | |
The specified bucket does not exist | 桶名拼错或已被删除 | |
connection refused | endpoint 端口错误、服务未启动或网络不通 | |
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 500mc 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 状态异常说明后台任务卡住
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 兼容接口对接、桶与对象权限治理、目录与桶数据搬迁、版本控制与生命周期分层、镜像与跨集群复制、容量配额与加密合规、监控自愈与故障定位,以及存储运维与面试复习。