支持 v8.5 / v8.1 / v7.5,三种部署模式,MySQL 协议兼容
生产级 TiDB 分布式数据库部署脚本,支持 Playground、生产集群、HTAP 混合三种部署模式。基于 TiUP 封装,自动生成拓扑配置并部署集群,支持 TiFlash 列存分析,开箱即用。
封装 TiUP 工具链,单条命令完成集群拓扑生成、部署、启动全流程
完整兼容 MySQL 协议和语法,现有 MySQL 应用无缝接入,迁移零成本
TiKV 基于 Raft 协议实现数据多副本强一致性,保障金融级数据安全
内置 TiFlash 列式存储引擎,实时 HTAP 分析,无需额外 ETL 流程
计算/存储分离架构,在线水平扩缩容,业务无感知滚动升级
兼容 RHEL/CentOS/Rocky/openEuler/麒麟/Ubuntu/Debian 等主流操作系统
根据集群规模自动调优 RocksDB、Raft、调度器等关键参数
一键部署 Prometheus + Grafana 监控栈,数百项指标开箱即用
覆盖从开发体验到生产 HTAP 的全部场景
适用于快速体验和功能验证。一键启动本地 TiDB Playground,包含 TiDB/TiKV/PD 最小集群,快速上手。
适用于生产环境。自动生成 topology.yaml 拓扑文件,通过 TiUP 部署多节点 TiDB/TiKV/PD 集群。
适用于需要实时分析的场景。在生产集群基础上额外部署 TiFlash 节点,实现行存+列存 HTAP 能力。
覆盖国内外主流 Linux 发行版
| 类别 | 操作系统 | 支持版本 |
|---|---|---|
| 企业级 Linux | RHEL | 789 |
| CentOS | 78 | |
| Rocky Linux | 89 | |
| AlmaLinux | 89 | |
| Oracle Linux | 789 | |
| 国产操作系统 | openEuler | 20.0322.03 |
| Kylin (麒麟) | V10 | |
| Anolis OS | 8 | |
| Debian 系 | Ubuntu | 20.0422.04 |
| Debian | 1112 |
三步完成 TiDB 集群部署
开通会员后,在页面顶部点击「下载脚本」按钮获取部署包
脚本自动安装 TiUP、生成拓扑配置、部署集群并启动服务
chmod +x TiDBShellInstall && ./TiDBShellInstall --helpbash TiDBShellInstall --mode single --tidb-version v8.5
bash TiDBShellInstall \ --mode single \ --tidb-version v8.5 \ --password 'YourPass123!' \ --tidb-port 4000 \ --deploy-dir /tidb-deploy \ --data-dir /tidb-data \ --enable-monitoring Y
bash TiDBShellInstall \ --mode cluster \ --tidb-version v8.5 \ --password 'YourPass123!' \ --tidb-nodes 192.168.1.10,192.168.1.11 \ --tikv-nodes 192.168.1.12,192.168.1.13,192.168.1.14 \ --pd-nodes 192.168.1.10,192.168.1.12,192.168.1.14 \ --ssh-user tidb --ssh-password 'RootPass'
bash TiDBShellInstall \ --mode hybrid \ --tidb-version v8.5 \ --password 'YourPass123!' \ --tidb-nodes 192.168.1.10,192.168.1.11 \ --tikv-nodes 192.168.1.12,192.168.1.13,192.168.1.14 \ --pd-nodes 192.168.1.10,192.168.1.12,192.168.1.14 \ --tiflash-nodes 192.168.1.15,192.168.1.16 \ --tiflash-replicas 1 \ --ssh-user tidb --ssh-password 'RootPass'
bash TiDBShellInstall \ --mode cluster \ --tidb-version v8.5 \ --password 'YourPass123!' \ --tidb-nodes 192.168.1.10,192.168.1.11 \ --tikv-nodes 192.168.1.12,192.168.1.13,192.168.1.14 \ --pd-nodes 192.168.1.10,192.168.1.12,192.168.1.14 \ --ssh-user tidb --ssh-password 'RootPass' \ --enable-cdc Y \ --cdc-nodes 192.168.1.10,192.168.1.11 \ --cdc-downstream-type mysql \ --cdc-downstream-uri 'mysql://root:pass@10.0.2.1:3306'
bash TiDBShellInstall \ --mode cluster \ --tidb-version v8.5 \ --password 'YourPass123!' \ --tidb-nodes 192.168.1.10,192.168.1.11 \ --tikv-nodes 192.168.1.12,192.168.1.13,192.168.1.14 \ --pd-nodes 192.168.1.10,192.168.1.12,192.168.1.14 \ --ssh-user tidb --ssh-password 'RootPass' \ --enable-cdc Y \ --cdc-nodes 192.168.1.10,192.168.1.11 \ --cdc-downstream-type kafka \ --cdc-downstream-uri 'kafka://10.0.3.1:9092/topic-name'
bash TiDBShellInstall \ --mode cluster \ --tidb-version v8.5 \ --password 'YourPass123!' \ --tidb-nodes 192.168.1.10,192.168.1.11 \ --tikv-nodes 192.168.1.12,192.168.1.13,192.168.1.14 \ --pd-nodes 192.168.1.10,192.168.1.12,192.168.1.14 \ --ssh-user tidb --ssh-password 'RootPass' \ --enable-dm Y \ --dm-master-nodes 192.168.1.10,192.168.1.12,192.168.1.14 \ --dm-worker-nodes 192.168.1.10,192.168.1.11 \ --dm-source-host 10.0.2.1 \ --dm-source-user root \ --dm-source-password 'SrcPass!' \ --dm-source-id mysql-replica-01 \ --dm-task-mode all \ --dm-task-name migrate-prod
按需配置参数,一键生成部署命令
./TiDBShellInstall脚本支持的所有命令行参数说明
| 参数 | 描述 | 默认值 | 适用模式 |
|---|---|---|---|
| --tidb-version | TiDB 版本 | v8.5 | 单机 |
| --tidb-port | TiDB 端口 | 4000 | 单机 |
| --tikv-port | TiKV 端口 | 20160 | 单机 |
| --pd-port | PD 端口 | 2379 | 单机 |
| --cluster-name | 集群名称 | tidb-cluster | 单机 |
| --password | root 密码(可选) | — | 单机 |
| --deploy-dir | 部署目录 | /tidb-deploy | 单机 |
| --data-dir | 数据目录 | /tidb-data | 单机 |
| --enable-firewall | 自动配置防火墙 | Y | 单机 |
| --enable-monitoring | 部署监控(Prometheus+Grafana) | Y | 单机 |
| --monitor-node | Prometheus 节点 IP | — | 单机 |
| --grafana-node | Grafana 节点 IP | — | 单机 |
| --tidb-nodes | TiDB 节点 IP | — | 集群 |
| --tikv-nodes | TiKV 节点 IP | — | 集群 |
| --pd-nodes | PD 节点 IP | — | 集群 |
| --ssh-port | SSH 端口 | 22 | 集群 |
| --ssh-user | SSH 用户 | tidb | 集群 |
| --ssh-password | 节点 root 密码(自动密钥分发) | — | 集群 |
| --enable-cdc | 启用 TiCDC | N | 集群 |
| --cdc-nodes | TiCDC 节点 IP | — | 集群 |
| --cdc-port | TiCDC 端口 | 8300 | 集群 |
| --cdc-downstream-type | 下游类型 | mysql | 集群 |
| --cdc-downstream-uri | 下游连接 URI | — | 集群 |
| --cdc-changefeed-name | Changefeed 名称 | — | 集群 |
| --cdc-sink-config | Sink 配置文件路径(可选) | — | 集群 |
| --enable-dm | 启用 DM 迁移 | N | 集群 |
| --dm-master-nodes | DM-Master 节点 IP | — | 集群 |
| --dm-worker-nodes | DM-Worker 节点 IP | — | 集群 |
| --dm-master-port | DM-Master 端口 | 8261 | 集群 |
| --dm-worker-port | DM-Worker 端口 | 8262 | 集群 |
| --dm-cluster-name | DM 集群名称 | dm-cluster | 集群 |
| --dm-source-host | MySQL 源库地址 | — | 集群 |
| --dm-source-port | MySQL 源库端口 | 3306 | 集群 |
| --dm-source-user | MySQL 源库用户 | — | 集群 |
| --dm-source-password | MySQL 源库密码 | — | 集群 |
| --dm-source-id | 源标识 (Source ID) | mysql-replica-01 | 集群 |
| --dm-task-mode | 迁移模式 | all | 集群 |
| --dm-task-name | 迁移任务名称 | — | 集群 |
| --dm-target-db | 目标数据库(过滤) | — | 集群 |
| --tiflash-nodes | TiFlash 节点 IP | — | HTAP |
| --tiflash-replicas | TiFlash 副本数 | 1 | HTAP |
| --tiflash-data-dir | TiFlash 数据目录 | — | HTAP |
显示 42 / 42 条参数
以下 31 个场景均在物理环境中完成真实安装测试,100% 通过验证。覆盖单机、集群、HTAP、TiCDC、DM 迁移及边界条件。
| ID | 测试场景 | 模式 | 版本 | 安装方式 | 节点 | 耗时 | 状态 |
|---|---|---|---|---|---|---|---|
| T-1 | 单机 Playground (v8.5.0) | 单机 | v8.5.0 | — | 1 | 85s | |
| T-2 | 三节点生产集群 (v8.5.0, 9 组件) | 集群 | v8.5.0 | — | 3 | 91s | |
| T-3 | HTAP 混合集群 + TiFlash (v8.5.0) | 集群 | v8.5.0 | — | 3 | 240s | |
| T-4 | 单机 Playground (v7.5.0 LTS) | 单机 | v7.5.0 | — | 1 | 87s | |
| T-5 | 生产集群 + 在线扩缩容 (v8.5.0) | 集群 | v8.5.0 | — | 3 | 210s | |
| T-6 | 单机 Playground (v8.1.0) | 单机 | v8.1.0 | — | 1 | 89s | |
| T-7 | TiCDC -> MySQL 下游实时同步 | CDC 同步 | v8.5.0 | — | 3 | — | |
| T-8 | TiCDC -> TiDB 下游实时同步 | CDC 同步 | v8.5.0 | — | 3 | — | |
| T-9 | TiCDC 仅部署(无 changefeed) | CDC 同步 | v8.5.0 | — | 3 | — | |
| T-10 | DM 全量+增量迁移 (all 模式) | DM 迁移 | v8.5.0 | — | 3 | — | |
| T-11 | DM 仅全量迁移 (full 模式) | DM 迁移 | v8.5.0 | — | 3 | — | |
| T-12 | DM 仅增量同步 (incremental 模式) | DM 迁移 | v8.5.0 | — | 3 | — | |
| T-13 | DM 仅部署集群(不配源库) | DM 迁移 | v8.5.0 | — | 3 | — | |
| T-14 | CDC single 模式拒绝(预期失败) | 边界校验 | v8.5.0 | — | 1 | — | |
| T-15 | DM 缺少必需参数(预期失败) | 边界校验 | v8.5.0 | — | 1 | — | |
| T-16 | CDC 无效下游类型(预期失败) | 边界校验 | v8.5.0 | — | 1 | — | |
| T-17 | DM 无效任务模式(预期失败) | 边界校验 | v8.5.0 | — | 1 | — | |
| T-18 | 自定义端口 + 自定义目录 (single) | 边界校验 | v8.5.0 | — | 1 | — | |
| T-19 | 特殊字符密码验证 | 边界校验 | v8.5.0 | — | 1 | — | |
| T-20 | 幂等性 — Playground 重复执行 | 边界校验 | v8.5.0 | — | 1 | — | |
| T-21 | 集群 + 自定义集群名/目录 + 禁用监控 | 集群 | v8.5.0 | — | 3 | — | |
| T-22 | 幂等性 — Cluster 重复执行检测 | 边界校验 | v8.5.0 | — | 3 | — | |
| T-23 | CDC + DM 同时启用 | CDC 同步 | v8.5.0 | — | 3 | — | |
| T-24 | 自定义 SSH 端口 + CDC/DM 端口 | 集群 | v8.5.0 | — | 3 | — | |
| T-25 | hybrid 模式 + 自定义 TiFlash 数据目录 | 集群 | v8.5.0 | — | 3 | — | |
| T-26 | 参数校验:cluster 模式缺少 --pd-nodes | 边界校验 | v8.5.1 | — | 1 | — | |
| T-27 | 参数校验:无效版本号格式 | 边界校验 | v99.99.99 | — | 1 | — | |
| T-28 | 权限校验:非 root 用户执行 | 边界校验 | v8.5.1 | — | 1 | — | |
| T-29 | 参数校验:single 模式忽略集群参数 | 边界校验 | v8.5.1 | — | 1 | — | |
| T-30 | Cluster 模式 v7.5.0 LTS 三节点部署 | 集群 | v7.5.0 | — | 3 | — | |
| T-31 | Hybrid 模式 v8.5.1 + TiFlash 部署 | 集群 | v8.5.1 | — | 3 | — |
所有测试在 RHEL 8.10 (x86_64) 环境下执行,集群模式使用三节点 ESXi VM
TiDB 完整兼容 MySQL 5.7/8.0 协议和语法,现有 MySQL 应用几乎无需修改即可接入 TiDB。TiDB 在此基础上提供水平弹性伸缩、分布式事务、HTAP 实时分析等能力。
Playground 是本地一键体验模式,所有组件运行在单机上,适合学习和功能验证。生产集群将 TiDB/TiKV/PD 分布在多台服务器上,提供真正的高可用和水平扩展能力。
推荐最小配置:3 台 TiKV(数据存储)、3 台 PD(元数据管理)、2 台 TiDB(SQL 计算层)。TiKV 和 PD 可混部,最少 3 台即可。每台建议 8GB+ 内存、SSD 存储。
TiFlash 是 TiDB 的列式存储引擎,实时同步 TiKV 行存数据并转为列存格式,适合 OLAP 分析查询。如果你有实时报表、大数据分析等需求,部署 HTAP 混合模式即可。
脚本是对 TiUP 的自动化封装。TiUP 是 PingCAP 官方的集群管理工具,脚本在此基础上自动生成拓扑配置、处理系统依赖、调优参数,简化部署流程。
支持。TiDB 集群部署后,可以通过 TiUP 在线添加或移除 TiDB/TiKV/TiFlash 节点,数据自动平衡迁移,业务无需停机。
同系列 Oracle 数据库一键安装脚本,支持 19c / 21c
同系列 MySQL 数据库一键安装脚本,支持 5.7 / 8.0 / 8.4 / 9.0
同系列金仓 KingbaseES 一键安装脚本,支持 V8R6 / V8R3