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

TSO 配置参数

· 52CE 我爱测

+ 当前 TSO 节点的名字。 + 默认: + 如果你需要启动多个 TSO 节点,建议为不同 TSO 节点设置不同的名字,以方便区分。

TSO 配置参数

TSO 节点用于提供 PD 的 tso 微服务。你可以通过命令行参数或环境变量配置 TSO 节点。

--advertise-listen-addr

  • 用于外部访问 TSO 节点的 URL。
  • 默认:${listen-addr}
  • 在某些情况下,例如 Docker 或者 NAT 网络环境,客户端并不能通过 TSO 节点自己监听的地址来访问 TSO 节点。此时,你可以设置 --advertise-listen-addr 来让客户端访问。
  • 例如,Docker 内部 IP 地址为 172.17.0.1,而宿主机的 IP 地址为 192.168.100.113 并且设置了端口映射 -p 3379:3379,那么可以设置 --advertise-listen-addr="http://192.168.100.113:3379",然后客户端就可以通过 http://192.168.100.113:3379 来找到这个服务。

--backend-endpoints

  • TSO 节点监听其他 TSO 节点的 URL 列表。
  • 默认:http://127.0.0.1:2379

--cacert

  • CA 文件路径,用于开启 TLS。
  • 默认:""

--cert

  • 包含 X.509 证书的 PEM 文件路径,用于开启 TLS。
  • 默认:""

--config

  • 配置文件。
  • 默认:""
  • 如果你指定了配置文件,TSO 节点会首先读取配置文件的配置。然后如果对应的配置在命令行参数里面也存在,TSO 节点就会使用命令行参数的配置来覆盖配置文件里面的配置。

--data-dir

  • TSO 节点上的数据存储路径。
  • 默认:default.${name}

--key

  • 包含 X.509 key 的 PEM 文件路径,用于开启 TLS。
  • 默认:""

--listen-addr

  • TSO 节点监听的客户端 URL。
  • 默认:http://127.0.0.1:3379
  • 部署集群时,--listen-addr 必须指定当前主机的 IP 地址,例如 http://192.168.100.113:3379。如果运行在 Docker 中,则需要指定为 http://0.0.0.0:3379。

--log-file

  • Log 文件。
  • 默认:""
  • 如果未设置该参数,log 会默认输出到 "stderr"。如果设置了该参数,log 将输出到指定的文件。

--name 从 v8.3.0 版本开始引入

  • 当前 TSO 节点的名字。
  • 默认:"tso-${hostname}"
  • 如果你需要启动多个 TSO 节点,建议为不同 TSO 节点设置不同的名字,以方便区分。

-L

  • Log 级别。
  • 默认:"info"
  • 可选:"debug","info","warn","error","fatal"

-V, --version

  • 输出版本信息并退出。

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

资料来源与适用范围

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

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

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