文档

mc alias set

语法

mc alias set 命令将别名添加到本地 mc 配置中或更新该别名。

以下命令为在 URL https://myminio.example.net 上运行的 MinIO 部署 myminio 添加一个 别名mc 使用指定的用户名和密码对 MinIO 部署进行身份验证

mc alias set myminio https://myminio.example.net minioadminuser minioadminpassword

如果 myminio 别名已存在,则该命令将使用新的 URL、访问密钥和密钥秘密覆盖该别名。

mc alias set 命令具有以下语法

mc [GLOBALFLAGS] alias set \
                 [--api "string"]                           \
                 [--path "string"]                          \
                 ALIAS                                      \
                 URL                                        \
                 ACCESSKEY                                  \
                 SECRETKEY
  • 方括号 [] 表示可选参数。

  • 共享同一行的参数是相互依赖的。

  • 使用管道 | 运算符分隔的参数是相互排斥的。

将示例复制到文本编辑器中,并在终端/shell中运行命令之前根据需要修改。

参数

别名

必需与 S3 兼容的服务关联的名称。别名区分大小写,必须满足以下要求

  • 仅包含 ASCII 小写字母 (a-z)、大写字母 (A-Z)、数字 ([0-9])、连字符 (-) 或下划线 (_)。

  • 长度至少为 2 个字符。

  • 第一个字符必须是字母。

在版本 RELEASE.2024-01-11T05-49-32Z 中更改: 别名也可以是一个字母 (a-zA-Z)。

一些有效的别名值示例包括

  • myminio

  • Test-1

  • A

  • a

网址

必需与 S3 兼容的服务端点的网址。例如

https://minio.example.net

访问密钥

必需

用于对 S3 服务进行身份验证的访问密钥。

密钥

必需

用于对 S3 服务进行身份验证的密钥。

--api

可选

指定连接到 S3 兼容服务时使用的签名计算方法。支持以下值

  • S3v4 (默认)

  • S3v2

注意

AWS 签名 V2 被 AWS 视为 已弃用mc alias set 仅包含此选项,用于仍然依赖签名 V2 的 S3 存储桶或服务。

除非 S3 兼容服务明确要求,否则使用 S3v4。MinIO 服务器不依赖也不需要 S3v2,而且并非所有 API 操作都可以在 S3v2 上使用。

--path

可选

指定服务器使用的存储桶路径查找设置。支持以下值

  • "auto" (默认)

  • "on"

  • "off"

全局标志

此命令支持任何 全局标志

示例

添加或更新 MinIO 部署的别名

使用 mc alias set 添加与 S3 兼容的服务以供 mc 使用

以下命令创建一个名为 myminio 的新别名,该别名指向位于 https://minio.example.net 的 MinIO 部署。该别名使用 miniouserminiopassword 凭据对部署执行操作。

mc alias set myminio https://minio.example.net miniouser miniopassword

如果 myminio 别名已存在,则 mc alias set 命令将使用指定的参数覆盖该别名。

mc alias set ALIAS HOSTNAME ACCESSKEY SECRETKEY
  • 别名 替换为与 MinIO 服务关联的名称。

  • 主机名 替换为 MinIO 部署中任何节点的 URL。您也可以指定用于管理与 MinIO 部署连接的负载均衡器或反向代理的 URL。

  • 访问密钥密钥 替换为 MinIO 部署中用户的凭据。

行为

S3 兼容性

mc 命令行工具是为与 AWS S3 API 兼容而构建的,并经过 MinIO 和 AWS S3 的测试,以确保预期的功能和行为。

MinIO 不对其他 S3 兼容服务提供任何保证,因为它们的 S3 API 实现未知,因此不受支持。虽然 mc 命令可能按文档工作,但任何此类使用风险自负。

必需的凭据和访问控制

mc alias set 需要为 S3 兼容主机指定访问密钥和相应的密钥。mc 功能受与指定凭据关联的策略的限制。例如,如果指定的凭据对特定存储桶没有读写访问权限,则 mc 无法对该存储桶执行读写操作。

有关 MinIO 访问控制的更多信息,请参见 访问管理

有关 S3 访问控制的更完整文档,请参见 Amazon S3 安全

对于所有其他 S3 兼容服务,请参考该服务的文档。

证书

MinIO 客户端获取对等证书,计算公钥指纹,并询问用户是否接受部署的证书。

如果受信任,MinIO 客户端会自动将证书颁发机构添加到

  • ~/.mc/certs/CAs/ 在 Linux 和其他类 Unix 系统上。

  • C:\Users\[username]\mc\certs\CAs\ 在 Windows 系统上。