mc license register

描述

mc license register 命令会将你的部署与 MinIO SUBNET 账户关联。

注册后,你可以使用 mc support diag 命令将部署健康报告直接上传到 SUBNET。

以下示例将 minio alias 注册到 MinIO SUBNET

mc license register minio

命令语法如下:

mc [GLOBALFLAGS] license register ALIAS                      \
                         [--airgap]                          \
                         [--api-key <string>]                \
                         [--license <path to license file>]  \
                         [--name <value>]

参数

ALIAS

mc-cmd

Required

MinIO 部署的 alias

--airgap

mc-cmd

Optional

用于无法访问 SUBNET 网络的环境(例如 airgapped、受防火墙限制或类似配置)。

说明请参见 airgap 示例

如果部署处于 airgapped 环境,但你运行 minio client 的本地设备可以访问网络,则无需使用 --airgap 标志。

--api-key

mc-cmd

SUBNET 上账户的 API key。

对应环境变量 MC_SUBNET_API_KEY

获取 API key 的步骤:

  1. 登录 MinIO SUBNET
  2. 进入 Deployments 选项卡
  3. 在页面顶部、账户统计信息框右侧,选择 API Key 按钮
  4. 选择 key 字段右侧的复制按钮,将 key 值复制到剪贴板
--license

mc-cmd

Optional

用于注册部署的 license 文件路径。

你必须先从 MinIO SUBNET 下载该账户的 license 文件。

  1. 登录 MinIO SUBNET
  2. 进入 Deployments 选项卡
  3. 在页面顶部、账户统计信息框右侧,选择 License 按钮
  4. 选择 license 字段右侧的复制按钮,将 key 值复制到剪贴板,或 选择 Download 按钮将 license 的 txt 文件保存到本地
--name

mc-cmd

Optional

指定一个不同于 alias 的名称,用于在 SUBNET 中关联该 MinIO 部署。

使用 --name <value>,将 <value> 替换为你希望在 SUBNET 上为该部署使用的名称。

示例

使用部署名称注册部署

将 alias 为 minio1 的 MinIO 部署注册到 SUBNET,并使用 minio1 作为部署名称:

mc license register minio1

如果尚未注册,系统会提示输入该部署的 SUBNET 凭证。

使用账户的 License 文件注册部署

将 alias 为 minio5 的新 MinIO 部署注册到 SUBNET,并使用为该账户下载的 license 文件:

mc license register minio5 /path/to/minio.license

如果尚未下载,你可以从 SUBNET 下载 license 文件。

  1. 登录 MinIO SUBNET
  2. 进入 Deployments 选项卡
  3. 在页面顶部、账户统计信息框右侧,选择 License 按钮
  4. 选择 Download 按钮将 license 的 txt 文件保存到本地

使用不同的部署名称注册部署

将 alias 为 minio2 的 MinIO 部署注册到 SUBNET,并使用 second-deployment 作为名称:

mc license register minio2 --name second-deployment

在无法直接访问互联网时注册部署

将 alias 为 minio3 的 MinIO 部署注册到 SUBNET;该部署由于防火墙、airgap 或类似原因无法直接访问互联网。

mc license register minio3 --airgap
  1. 运行命令,返回带有 token 的注册链接

  2. 在 Web 浏览器中打开复制的注册链接,并登录 SUBNET

  3. 选择部署 License 编号右侧的 ? 按钮

  4. 在弹窗中选择下载链接,并将 key 保存到你有访问权限的路径

  5. 在命令行中运行以下命令

    mc license update minio3 <path-to-file>
    

    <path-to-file> 替换为你从 SUBNET 下载的文件路径。

语法

命令语法如下:

mc [GLOBALFLAGS] license register       \
                         ALIAS          \
                         [--name value] \
                         [--airgap]

全局标志

此命令支持 全局标志 中的任意选项。

行为

自动更新 License

注册到 MinIO SUBNET 后,MinIO 会每月自动检查并更新 license。

在 airgapped 或其他服务器无法直接访问互联网的环境中,使用带文件路径的 mc license update 来更新注册。

最后修改 August 2, 2026: init commit (8338d5b)

本页部分内容改编自 MinIO 对象存储文档,© 2020–至今 MinIO, Inc.,依据 CC BY 4.0 授权,由 Silo 项目转换与维护。归属与署名

本页为非官方中文翻译。如与英文原文有出入,以英文原文为准。