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

TiProxy 部署拓扑

· 52CE 我爱测

# TiProxy 部署拓扑 本文介绍在部署最小拓扑集群的基础上,部署 TiProxy 的拓扑结构。 其他部署方式,请参考以下文档: - 使用 TiDB Operator 部署 TiProxy,请参见 TiDB Operator 文档。 - 使用 TiUP 本地快速部署 TiProxy,请参见部署 TiProxy。 - 使用 TiUP 部署 TiProxy,请参见 TiProxy 安装和使用。 TiProxy 是 TiDB 的 L7 代

TiProxy 部署拓扑

本文介绍在部署最小拓扑集群的基础上,部署 TiProxy 的拓扑结构。

其他部署方式,请参考以下文档:

TiProxy 是 TiDB 的 L7 代理,可以平衡连接并迁移会话。

拓扑信息

实例 个数 物理机配置 IP 配置
TiDB 3 16 VCore 32GB * 3 10.0.1.4
10.0.1.5
10.0.1.6
默认端口
全局目录配置
PD 3 4 VCore 8GB * 3 10.0.1.1
10.0.1.2
10.0.1.3
默认端口
全局目录配置
TiKV 3 16 VCore 32GB 2TB (nvme ssd) * 3 10.0.1.7
10.0.1.8
10.0.1.9
默认端口
全局目录配置
TiProxy 2 4 VCore 8 GB * 1 10.0.1.11
10.0.1.12
默认端口
全局目录配置
Monitoring & Grafana 1 4 VCore 8GB * 1 500GB (ssd) 10.0.1.13 默认端口
全局目录配置

注意:

该表中拓扑实例的 IP 为示例 IP。在实际部署时,请替换为实际的 IP。

拓扑模版

简单 TiProxy 配置模版

# # Global variables are applied to all deployments and used as the default value of
# # the deployments if a specific deployment value is missing.
global:
  user: "tidb"
  ssh_port: 22
  deploy_dir: "/tidb-deploy"
  data_dir: "/tidb-data"
component_versions:
  tiproxy: "v1.3.3"
server_configs:
  tidb:
    graceful-wait-before-shutdown: 30
  tiproxy:
    ha.virtual-ip: "10.0.1.10/24"
    ha.interface: "eth0"
    graceful-wait-before-shutdown: 15

pd_servers:
  - host: 10.0.1.1
  - host: 10.0.1.2
  - host: 10.0.1.3

tidb_servers:
  - host: 10.0.1.4
  - host: 10.0.1.5
  - host: 10.0.1.6

tikv_servers:
  - host: 10.0.1.7
  - host: 10.0.1.8
  - host: 10.0.1.9

tiproxy_servers:
  - host: 10.0.1.11
    deploy_dir: "/tiproxy-deploy"
    port: 6000
    status_port: 3080
    config:
      labels: { zone: "east" }
  - host: 10.0.1.12
    deploy_dir: "/tiproxy-deploy"
    port: 6000
    status_port: 3080
    config:
      labels: { zone: "west" }

monitoring_servers:
  - host: 10.0.1.13

grafana_servers:
  - host: 10.0.1.13

alertmanager_servers:
  - host: 10.0.1.13

以上 TiDB 集群拓扑文件中,详细的配置项说明见通过 TiUP 部署 TiDB 集群的拓扑文件配置。

关键参数介绍

  • tiproxy_servers 实例级别配置 "-host" 目前只支持 IP,不支持域名。
  • TiProxy 具体的参数配置介绍可参考 TiProxy 参数配置。

注意:

  • 无需手动创建配置文件中的 tidb 用户,TiUP cluster 组件会在目标主机上自动创建该用户。可以自定义用户,也可以和中控机的用户保持一致。
  • 如果部署目录配置为相对路径,会部署在用户的 Home 目录下。

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

资料来源与适用范围

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

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

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