MinIO 运维命令 100 条

本文使用官方 MinIO Client mc，整理对象、Bucket、版本、生命周期、复制、IAM、监控和集群管理的 100 条命令。示例别名为 myminio，生产环境应使用 TLS、最小权限账号，并避免在 Shell 历史中暴露密钥。

2026年8月19日阅读—点赞—收藏—

dba100minio墨力计划

前言

本文使用官方 MinIO Client mc，整理对象、Bucket、版本、生命周期、复制、IAM、监控和集群管理的 100 条命令。示例别名为 myminio，生产环境应使用 TLS、最小权限账号，并避免在 Shell 历史中暴露密钥。

mc admin 只适用于 MinIO 部署；rm、rb、匿名访问、保留策略、复制和服务重启均可能产生重大影响。

一、安装、别名与连接

1. 查看 mc 版本

Bash

1mc --version

2. 查看帮助

Bash

1mc --help

3. 配置服务别名

Bash

1mc alias set myminio https://minio.example.com ACCESS_KEY SECRET_KEY

4. 查看全部别名

Bash

1mc alias list

5. 查看指定别名

Bash

1mc alias list myminio

6. 导出别名

Bash

1mc alias export myminio > myminio-alias.json

7. 导入别名

Bash

1mc alias import myminio-alias.json

8. 删除别名

Bash

1mc alias remove oldminio

9. 测试服务连通性

Bash

1mc ping myminio

10. 检查集群读写就绪

Bash

1mc ready myminio

二、Bucket 管理

11. 列出 Bucket

Bash

1mc ls myminio

12. 创建 Bucket

Bash

1mc mb myminio/app-data

13. 创建启用对象锁的 Bucket

Bash

1mc mb --with-lock myminio/archive

14. 查看 Bucket 详情

Bash

1mc stat myminio/app-data

15. 查看 Bucket 容量

Bash

1mc du myminio/app-data

16. 递归列出对象

Bash

1mc ls --recursive myminio/app-data

17. 以 JSON 输出

Bash

1mc --json ls myminio

18. 查看目录树

Bash

1mc tree --files myminio/app-data

19. 删除空 Bucket

Bash

1mc rb myminio/old-bucket

20. 强制删除 Bucket

Bash

1mc rb --force myminio/old-bucket

该命令会删除其中对象，生产环境慎用。

三、对象上传、下载与查看

21. 上传单个文件

Bash

1mc put report.csv myminio/app-data/reports/report.csv

22. 递归上传目录

Bash

1mc cp --recursive ./data/ myminio/app-data/

23. 下载对象

Bash

1mc get myminio/app-data/report.csv ./report.csv

24. 复制对象

Bash

1mc cp myminio/app-data/a.txt myminio/app-data/b.txt

25. 跨服务复制

Bash

1mc cp myminio/app-data/a.txt backup/app-data/a.txt

26. 移动对象

Bash

1mc mv myminio/app-data/tmp/a.txt myminio/app-data/archive/a.txt

27. 流式上传

Bash

1printf 'hello\n' | mc pipe myminio/app-data/hello.txt

28. 输出对象内容

Bash

1mc cat myminio/app-data/app.conf

29. 查看对象前十行

Bash

1mc head --lines 10 myminio/app-data/app.log

30. 查看对象元数据

Bash

1mc stat myminio/app-data/report.csv

四、搜索、同步与删除

31. 按名称查找对象

Bash

1mc find myminio/app-data --name '*.log'

32. 查找七天前对象

Bash

1mc find myminio/app-data --older-than 7d

33. 比较两个 Bucket

Bash

1mc diff myminio/app-data backup/app-data

34. 单向镜像

Bash

1mc mirror ./data myminio/app-data

35. 持续镜像

Bash

1mc mirror --watch ./data myminio/app-data

36. 覆盖目标差异

Bash

1mc mirror --overwrite ./data myminio/app-data

37. 预演删除

Bash

1mc rm --recursive --dry-run myminio/app-data/tmp/

38. 删除单个对象

Bash

1mc rm myminio/app-data/tmp/a.txt

39. 递归删除前缀

Bash

1mc rm --recursive --force myminio/app-data/tmp/

40. 清理未完成分片

Bash

1mc rm --incomplete --recursive --force myminio/app-data

五、版本与恢复

41. 查看版本状态

Bash

1mc version info myminio/app-data

42. 启用版本控制

Bash

1mc version enable myminio/app-data

43. 暂停版本控制

Bash

1mc version suspend myminio/app-data

44. 列出全部版本

Bash

1mc ls --versions myminio/app-data/report.csv

45. 下载指定版本

Bash

1mc cp --version-id VERSION_ID myminio/app-data/report.csv ./report-old.csv

46. 查看指定版本

Bash

1mc stat --version-id VERSION_ID myminio/app-data/report.csv

47. 删除指定版本

Bash

1mc rm --version-id VERSION_ID myminio/app-data/report.csv

48. 回退最近删除

Bash

1mc undo myminio/app-data/report.csv

49. 回退到指定时间

Bash

1mc undo --recursive --force --last 1h myminio/app-data/

50. 列出删除标记

Bash

1mc ls --versions --recursive myminio/app-data | grep DELETE

六、匿名访问、标签与链接

51. 查看匿名策略

Bash

1mc anonymous get myminio/public

52. 设置只读匿名访问

Bash

1mc anonymous set download myminio/public

53. 禁止匿名访问

Bash

1mc anonymous set none myminio/public

54. 列出匿名访问点

Bash

1mc anonymous links myminio/public

55. 创建临时下载链接

Bash

1mc share download --expire 1h myminio/app-data/report.csv

56. 创建临时上传链接

Bash

1mc share upload --expire 1h myminio/inbox/new.bin

57. 查看共享链接

Bash

1mc share ls download

58. 设置对象标签

Bash

1mc tag set myminio/app-data/report.csv 'env=prod&team=dba'

59. 查看对象标签

Bash

1mc tag list myminio/app-data/report.csv

60. 删除对象标签

Bash

1mc tag remove myminio/app-data/report.csv

七、生命周期、保留与加密

61. 查看生命周期规则

Bash

1mc ilm rule ls myminio/app-data

62. 添加过期规则

Bash

1mc ilm rule add --expire-days 30 myminio/app-data

63. 导出生命周期配置

Bash

1mc ilm rule export myminio/app-data > ilm.json

64. 导入生命周期配置

Bash

1mc ilm rule import myminio/app-data < ilm.json

65. 删除生命周期规则

Bash

1mc ilm rule rm --id RULE_ID myminio/app-data

66. 查看保留策略

Bash

1mc retention info myminio/archive

67. 设置治理保留

Bash

1mc retention set --default GOVERNANCE 30d myminio/archive

68. 设置对象法律保留

Bash

1mc legalhold set myminio/archive/report.pdf

69. 查看法律保留

Bash

1mc legalhold info myminio/archive/report.pdf

70. 查看默认加密

Bash

1mc encrypt info myminio/app-data

八、复制与事件

71. 查看复制规则

Bash

1mc replicate ls myminio/app-data

72. 添加双向复制

Bash

1mc replicate add myminio/app-data --remote-bucket https://ACCESS:SECRET@backup.example.com/replica --replicate delete,delete-marker,existing-objects

73. 查看复制状态

Bash

1mc replicate status myminio/app-data

74. 查看复制积压

Bash

1mc replicate backlog myminio/app-data

75. 导出复制配置

Bash

1mc replicate export myminio/app-data > replication.json

76. 删除复制规则

Bash

1mc replicate rm --id RULE_ID myminio/app-data

77. 查看事件通知

Bash

1mc event ls myminio/app-data

78. 添加 Kafka 通知

Bash

1mc event add myminio/app-data arn:minio:sqs::PRIMARY:kafka --event put

79. 删除事件通知

Bash

1mc event rm myminio/app-data arn:minio:sqs::PRIMARY:kafka

80. 实时观察对象事件

Bash

1mc watch --recursive myminio/app-data

九、用户与策略

81. 查看集群信息

Bash

1mc admin info myminio

82. 列出用户

Bash

1mc admin user list myminio

83. 创建用户

Bash

1mc admin user add myminio appuser STRONG_SECRET

84. 禁用用户

Bash

1mc admin user disable myminio appuser

85. 启用用户

Bash

1mc admin user enable myminio appuser

86. 删除用户

Bash

1mc admin user remove myminio appuser

87. 列出策略

Bash

1mc admin policy list myminio

88. 创建策略

Bash

1mc admin policy create myminio app-readonly readonly.json

89. 绑定用户策略

Bash

1mc admin policy attach myminio app-readonly --user appuser

90. 查看用户实体策略

Bash

1mc admin policy entities myminio --user appuser

十、监控、诊断与服务

91. 查看实时 API 调用

Bash

1mc admin trace myminio

92. 仅查看错误请求

Bash

1mc admin trace --errors myminio

93. 查看 Prometheus 指标

Bash

1mc admin prometheus metrics myminio

94. 查看磁盘健康

Bash

1mc admin info myminio --json | jq

95. 查看配置键

Bash

1mc admin config get myminio

96. 查看指定配置

Bash

1mc admin config get myminio api

97. 查看服务日志

Bash

1mc admin logs --last 100 myminio

98. 查看扫描器状态

Bash

1mc admin scanner status myminio

99. 重启集群服务

Bash

1mc admin service restart myminio

100. 获取集群诊断摘要

Bash

1{ mc ready myminio; mc admin info myminio; mc admin scanner status myminio; } | tee minio-check.txt

总结

MinIO 运维的核心是对象安全、版本与生命周期、IAM、复制状态和磁盘健康。客户端与服务端版本应尽量接近，密钥应通过安全方式注入，任何批量删除和权限放开都应先预演并保留审计记录。