MinIO客户端快速入门指南

MinIO Client（简称mc）是UNIX命令（如ls、cat、cp等）的现代替代工具，支持本地文件系统和兼容Amazon S3的云存储服务（AWS Signature v2和v4）。

核心命令列表

alias       设置、移除和列出配置文件中的别名
ls          列出桶和对象
mb          创建桶
rb          删除桶
cp          复制对象
mirror      将对象同步到远程站点
cat         显示对象内容
head        显示对象的前n行内容
pipe        将标准输入流传输到对象
share       生成对象的临时访问URL
find        搜索对象
sql         对对象运行SQL查询
stat        显示对象元数据
mv          移动对象
tree        以树形结构列出桶和对象
du          递归汇总磁盘使用情况
retention   设置对象的保留策略
legalhold   为对象设置法律保留
diff        列出两个桶之间对象名称、大小和日期的差异
rm          删除对象
encrypt     管理桶加密配置
event       管理对象通知
watch       监听对象通知事件
undo        撤销PUT/DELETE操作
policy      管理桶和对象的匿名访问权限
tag         管理桶和对象的标签
ilm         管理桶生命周期
version     管理桶版本控制
replicate   配置服务端桶复制
admin       管理MinIO服务器
update      将mc更新到最新版本

安装与部署

Docker容器安装

稳定版

docker pull minio/mc
docker run minio/mc ls play  # 默认连接MinIO play测试环境

边缘版（开发中版本）

docker pull minio/mc:edge
docker run minio/mc:edge ls play

注意：上述示例默认连接MinIO play测试环境。若要连接其他S3兼容服务，需先进入容器交互模式：

docker run -it --entrypoint=/bin/sh minio/mc

再执行mc config命令配置连接。

GitLab CI中使用

在GitLab CI中使用Docker容器时，需将entrypoint设为空字符串：

deploy:
  image:
    name: minio/mc
    entrypoint: ['']  # 覆盖镜像默认entrypoint
  stage: deploy
  before_script:
    - mc alias set minio $MINIO_HOST $MINIO_ACCESS_KEY $MINIO_SECRET_KEY  # 配置服务别名
  script:
    - mc cp <源文件> <目标路径>  # 执行文件复制等操作

macOS安装（Homebrew）

通过Homebrew安装：

brew install minio/stable/mc
mc --help  # 验证安装

GNU/Linux安装（二进制下载）

以64位Intel为例：

wget [***] +x mc  # 添加执行权限
./mc --help  # 验证安装

Windows安装（二进制下载）

下载后直接运行：

mc.exe --help  # 验证安装

源码安装（适用于开发者）

需先配置Golang环境（最低版本go1.13）：

GO111MODULE=on go get github.com/minio/mc

添加云存储服务

若仅使用本地文件系统，可跳过此步骤。如需连接S3兼容服务，通过mc alias set命令配置，信息存储在~/.mc/config.json中。

命令格式：

mc alias set <别名> <S3服务地址> <访问密钥> <密钥> --api <签名版本> --path <桶路径模式>

• <别名>：服务的简短标识（自定义）。
• --api：可选，签名版本（默认S3v4）。
• --path：可选，桶路径模式（on/off，默认auto自动检测）。

示例：连接MinIO服务

假设MinIO服务器地址为`[] alias set minio [] BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12

### 示例：连接Amazon S3服务
需先获取AWS访问密钥（参考AWS凭证指南）：
```bash
mc alias set s3 [***] BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12

注意：IAM用户需配置权限策略（示例，限制访问指定桶）：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowBucketStat",
            "Effect": "Allow",
            "Action": ["s3:HeadBucket"],
            "Resource": "*"
        },
        {
            "Sid": "AllowThisBucketOnly",
            "Effect": "Allow",
            "Action": "s3:*",
            "Resource": [
                "arn:aws:s3:::<your-restricted-bucket>/*",
                "arn:aws:s3:::<your-restricted-bucket>"
            ]
        }
    ]
}

示例：连接Google Cloud Storage

获取访问密钥后（参考Google凭证指南）：

mc alias set gcs [***] BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12

测试配置

mc默认预配置了MinIO play测试环境（别名play），可直接测试基本功能。

列出桶

mc ls play  # 列出play环境中的所有桶
# 输出示例：
# [2016-03-22 19:47:48 PDT]     0B my-bucketname/
# [2016-03-22 22:01:07 PDT]     0B mytestbucket/

创建桶

用mb命令创建桶：

mc mb play/mybucket  # 在play环境创建mybucket桶
# 输出：Bucket created successfully `play/mybucket`.

复制对象

用cp命令复制本地文件到桶：

mc cp myobject.txt play/mybucket  # 将本地myobject.txt复制到play/mybucket
# 输出示例：myobject.txt:    14 B / 14 B  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓  100.00 % 41 B/s 0

日常使用技巧

Shell别名替换

可将mc命令别名设置为常用Unix命令，直接替换原生工具：

alias ls='mc ls'       # 用mc ls替换系统ls
alias cp='mc cp'       # 用mc cp替换系统cp
alias cat='mc cat'     # 用mc cat替换系统cat
alias mkdir='mc mb'    # 用mc mb替换系统mkdir
alias find='mc find'   # 用mc find替换系统find

Shell自动补全

mc内置bash、zsh、fish的自动补全功能，安装方法：

mc --autocompletion  # 安装补全配置

重启Shell后，输入mc 并按Tab键即可自动补全命令：

mc <TAB>  # 按Tab键显示可选命令
# 输出示例：admin    config   diff     find     ls       mirror   policy   session  sql      update   watch...

深入了解

• MinIO客户端完整指南
• MinIO快速入门指南
• MinIO文档官网

参与贡献

请参考MinIO 贡献者指南。

许可协议

mc的使用受GNU AGPLv3许可协议约束，详见LICENSE文件。