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

PD 配置参数

· 52CE 我爱测

+ 用于外部访问 PD 的 URL 列表。 + 默认: + 在某些情况下,例如 Docker 或者 NAT 网络环境,客户端并不能通过 PD 自己监听的 client URLs 来访问到 PD,这时候,你就可以设置 advertise URLs 来让客户端访问。 + 例如,Docker 内部 IP 地址为 ,而宿主机的 IP 地址为 并且设置了端口映射 ,那么可以设置为 ,客户端可以通过 来找到这个服务。

PD 配置参数

PD 可以通过命令行参数或环境变量配置。

--advertise-client-urls

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

--advertise-peer-urls

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

--client-urls

  • PD 监听的客户端 URL 列表。
  • 默认:http://127.0.0.1:2379
  • 如果部署一个集群,--client-urls 必须指定当前主机的 IP 地址,例如 http://192.168.100.113:2379",如果是运行在 Docker 则需要指定为 http://0.0.0.0:2379。

--peer-urls

  • PD 节点监听其他 PD 节点的 URL 列表。
  • 默认:http://127.0.0.1:2380
  • 如果部署一个集群,--peer-urls 必须指定当前主机的 IP 地址,例如 http://192.168.100.113:2380,如果是运行在 Docker 则需要指定为 http://0.0.0.0:2380。

--config

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

--data-dir

  • PD 存储数据路径。
  • 默认:default.${name}

--initial-cluster

  • 初始化 PD 集群配置。
  • 默认:"{name}=http://{advertise-peer-url}"
  • 例如,如果 name 是 "pd",并且 advertise-peer-urls 是 http://192.168.100.113:2380,那么 initial-cluster 就是 pd=http://192.168.100.113:2380。
  • 如果你需要启动三台 PD,那么 initial-cluster 可能就是 pd1=http://192.168.100.113:2380, pd2=http://192.168.100.114:2380, pd3=192.168.100.115:2380。

--join

  • 动态加入 PD 集群。
  • 默认:""
  • 如果你想动态将一台 PD 加入集群,你可以使用 --join="${advertise-client-urls}",advertise-client-url 是当前集群里面任意 PD 的 advertise-client-url,你也可以使用多个 PD 的,需要用逗号分隔。

-L

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

--log-file

  • Log 文件。
  • 默认:""
  • 如果没设置这个参数,log 会默认输出到 "stderr",如果设置了,log 就会输出到对应的文件里面。

--log-rotate

  • 是否开启日志切割。
  • 默认:true
  • 当值为 true 时,按照 PD 配置文件中 [log.file] 信息执行。

--name

  • 当前 PD 的名字。
  • 默认:"pd-${hostname}"
  • 如果你需要启动多个 PD,一定要给 PD 使用不同的名字

--cacert

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

--cert

  • 包含 X509 证书的 PEM 文件路径,用户开启 TLS。
  • 默认:""

--key

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

--metrics-addr

  • 指定 Prometheus Pushgateway 的地址。
  • 默认:""
  • 如果留空,则不开启 Prometheus Push。

--force-new-cluster

  • 强制使用当前节点创建新的集群。
  • 默认:false
  • 仅用于在 PD 丢失多数副本的情况下恢复服务,可能会产生部分数据丢失。

-V, --version

  • 输出版本信息并退出。

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

资料来源与适用范围

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

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

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