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

TiDB 中文参考:tiup cluster tls

· 52CE 我爱测

# tiup cluster tls 命令 用于开启集群组件之间的 TLS (Transport Layer Security),会自签发证书下发到各个节点。 ## 语法 为要启用自启的集群。 > **注意:** > > 目前, 命令仅支持对只有一个 PD 节点的集群开启或关闭 TLS。对于包含多个 PD 节点的集群,执行 命令会直接报错,因为切换 TLS 状态会导致 PD 节点之间通信异常。如需对多 PD 节点的集群开启或关闭 TLS

tiup cluster tls

命令 tiup cluster tls 用于开启集群组件之间的 TLS (Transport Layer Security),会自签发证书下发到各个节点。

语法

tiup cluster tls <cluster-name> <enable/disable> [flags]

<cluster-name> 为要启用自启的集群。

注意:

目前,tiup cluster tls 命令仅支持对只有一个 PD 节点的集群开启或关闭 TLS。对于包含多个 PD 节点的集群,执行 tiup cluster tls 命令会直接报错,因为切换 TLS 状态会导致 PD 节点之间通信异常。如需对多 PD 节点的集群开启或关闭 TLS,请先将 PD 节点 scale-in 到 1 个,再执行 tiup cluster tls 命令。

选项

--clean-certificate

  • 当 TLS 关闭时,指定此选项可清理之前生成的证书。
  • 数据类型:BOOLEAN
  • 默认值:false
  • 如果不指定该选项,之后开启 TLS 时,可能沿用旧证书。

--force

  • 强制执行开启或关闭 TLS 的流程,不管当前集群是否开启 TLS。
  • 数据类型:BOOLEAN
  • 默认值:false
  • 如果不指定该选项,开关状态相同时跳过执行。

--reload-certificate

  • 当 TLS 开启时,指定此选项可重新生成证书。
  • 数据类型:BOOLEAN
  • 默认值:false
  • 如果不指定该选项,已经生成过证书后,不会再生成新证书。

-h, --help

  • 输出帮助信息。
  • 数据类型:BOOLEAN
  • 该选项默认关闭,默认值为 false。在命令中添加该选项,并传入 true 值或不传值,均可开启此功能。

输出

tiup-cluster 的执行日志。

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

资料来源与适用范围

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

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

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