大网数据广告活动
数据库部署与 SQL 参考

TiDB 中文参考:tiup mirror genkey

· 52CE 我爱测

由于修改文件需要相关的管理员进行签名,因此管理员必须拥有自己的私钥。命令 就是用于生成私钥的。

tiup mirror genkey

在 TiUP 镜像的定义中,有三类角色:

  • 镜像管理员:拥有 root.json、index.json、snapshot.json 以及 timestamp.json 的修改权限
  • 组件管理员:拥有相关组件的修改权限
  • 普通用户:可以下载并使用组件

由于修改文件需要相关的管理员进行签名,因此管理员必须拥有自己的私钥。命令 tiup mirror genkey 就是用于生成私钥的。

警告:

请勿通过网络传输私钥。

语法

tiup mirror genkey [flags]

选项

-n, --name

  • 密钥的名字,该名字决定最终生成的文件名。生成的私钥文件路径为:${TIUP_HOME}/keys/{name}.json,其中 TIUP_HOME 为 TiUP 的 Home 目录,默认路径为 $HOME/.tiup,name 为 -n/--name 指定的密钥名字。
  • 数据类型:STRING
  • 如果不指定该选项,密钥名默认为 private。

-p, --public

  • 显示当前私钥对应的公钥,当前私钥名字由 -n/--name 选项指定。
  • 当指定了 -p/--public 时,不会创建新的私钥。若 -n/--name 指定的私钥不存在,则报错。
  • 数据类型:BOOLEAN
  • 该选项默认关闭,默认值为 false。在命令中添加该选项,并传入 true 值或不传值,均可开启此功能。

--save

  • 将公钥信息储存为文件放置于当前目录,文件名称为 {hash-prefix}-public.json,其中 hash-prefix 为该密钥 ID 的前 16 位。
  • 数据类型:BOOLEAN
  • 该选项默认关闭,默认值为 false。在命令中添加该选项,并传入 true 值或不传值,均可开启此功能。

输出

  • 若未指定 -p/--public:
    • 若指定的密钥已存在:Key already exists, skipped
    • 若指定的密钥不存在:private key have been write to ${TIUP_HOME}/keys/{name}.json
  • 若指定 -p/--public:
    • 若指定的密钥不存在:Error: open ${TIUP_HOME}/keys/{name}.json: no such file or directory
    • 若指定的密钥存在:输出该密钥对应的公钥内容

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。