MinIO 客户端

MinIO客户端
MinIO Clientmc命令行工具提供了 UNIX 命令的现代替代方案，例如ls、cat、cp、mirror，并diff支持文件系统和 Amazon S3 兼容的云存储服务。

mc命令行工具是为与 AWS S3 API 兼容而构建的，并针对预期的功能和行为使用 MinIO 和 AWS S3 进行了测试。

MinIO 不为其他 S3 兼容服务提供任何保证，因为它们的 S3 API 实现是未知的，因此不受支持。虽然mc 命令可能会像文档中描述的那样工作，但您需要自行承担任何此类使用的风险。

mc具有以下语法：

mc [GLOBALFLAGS] COMMAND –help
有关受支持命令的列表，请参阅命令快速参考。

AGPLv3

mc是AGPLv3 许可的免费开源 (FOSS) 软件。

集成mc的应用程序可能会触发 AGPLv3 合规性要求。MinIO 商业许可 是触发 AGPLv3 义务的应用程序的最佳选择，其中不能选择开源应用程序。

快速开始
1) 安装mc
将mc命令行工具安装到主机上。单击与主机操作系统或环境对应的选项卡：

Linux

以下命令将临时扩展添加到您的系统 PATH 以运行该mc实用程序。遵照您的操作系统说明对您的系统 PATH 进行永久性修改。

或者，mc通过导航到父文件夹并运行来执行./mc –help

64-bit Intel

curl https://dl.min.io/client/mc/release/linux-amd64/mc \
  --create-dirs \
  -o $HOME/minio-binaries/mc

chmod +x $HOME/minio-binaries/mc
export PATH=$PATH:$HOME/minio-binaries/

mc --help

注意：可先网页下载到本地，上传到 /usr/local/src 目录下，也可以使用 wget 下载；

cd /usr/local/src && wget https://dl.min.io/client/mc/release/linux-amd64/mc
chmod +x mc;
mkdir -p $HOME/minio-binaries;
sudo mv mc $HOME/minio-binaries;
echo 'export PATH=$PATH:$HOME/minio-binaries/' >>/etc/profile;
source /etc/profile;

64-bit PPC

curl https://dl.min.io/client/mc/release/linux-ppc64le/mc \
  --create-dirs \
  -o ~/minio-binaries/mc

chmod +x $HOME/minio-binaries/mc
export PATH=$PATH:$HOME/minio-binaries/

mc --help

ARM64

curl https://dl.min.io/client/mc/release/linux-arm64/mc \
  --create-dirs \
  -o ~/minio-binaries/mc

chmod +x $HOME/minio-binaries/mc
export PATH=$PATH:$HOME/minio-binaries/

mc --help

macOS

brew install minio/stable/mc
mc --help

Windows

在浏览器中打开下面地址:

https://dl.min.io/client/mc/release/windows-amd64/mc.exe

双击执行这个文件，或者在控制台执行下面命令：

\path\to\mc.exe --help

2) 为 S3 兼容服务创建别名
重要的

以下示例暂时禁用 bash 历史记录以降低身份验证凭据以纯文本形式泄漏的风险。这是一项基本的安全措施，并不能减轻所有可能的攻击媒介。在命令行上输入敏感信息时，请遵循操作系统的安全最佳实践。

使用该命令将与 Amazon S3 兼容的服务添加到配置中。mc alias setmc

bash +o history
mc alias set ALIAS HOSTNAME ACCESS_KEY SECRET_KEY
bash -o history
替换ALIAS为要关联到 S3 服务的名称。 mc命令通常需要ALIAS作为参数来标识要针对哪个 S3 服务执行。

替换HOSTNAME为 S3 服务的 URL 端点或 IP 地址。

将ACCESS_KEYand替换SECRET_KEY为 S3 服务上用户的访问密钥和秘密密钥。

用所需的值替换每个参数。仅指定 命令会启动输入提示以输入所需的值。mc config host add

以下每个选项卡都包含一个特定于提供商的示例：

MinIO服务器
mc alias set myminio https://minioserver.example.net ACCESS_KEY SECRET KEY

AWS S3 存储

谷歌云存储
3) 测试连接
使用命令测试与新添加的 MinIO 部署的连接：mc admin info

mc admin info myminio
如果成功，该命令将返回有关 S3 服务的信息。如果不成功，请检查以下各项：

主机连接到 S3 服务 URL（即使用ping 或traceroute）。

指定ACCESSKEY并SECRETKEY对应于 S3 服务上的一个用户。用户必须有权对服务执行操作。

对于 MinIO 部署，请参阅访问管理 以获取有关用户访问权限的更多信息。对于其他 S3 兼容服务，请参考该服务的文档。