TiDB 软件和硬件环境需求 本文介绍 TiDB 数据库对软件和硬件环境的需求。TiDB 作为一款开源一栈式实时 HTAP 数据库，可以很好地部署和运行在 Intel 架构服务器环境、ARM 架构的服务器环境及主流虚拟化环境，并支持绝大多数的主流硬件网络。作为一款高性能数据库系统，TiDB 支持主流的 Linux 操作系统环境。
操作系统及平台要求 在 v8.5 LTS 版本中，针对不同操作系统和 CPU 架构的组合，TiDB 提供不同级别质量标准的支持。
经过测试和验证的平台 ：对于以下操作系统和 CPU 架构组合，每个 TiDB 版本均会通过 PingCAP 的系统性测试矩阵进行验证。这些组合推荐用于生产环境部署。
操作系统 支持的 CPU 架构 Red Hat Enterprise Linux 9.4 及以上的 9.x 版本 Red Hat Enterprise Linux 8.6 及以上的 8.x 版本 Amazon Linux 2 Amazon Linux 2023 Rocky Linux 9.1 及以上的版本 银河麒麟 V10 SP1/SP2/SP3（从 v7.5.5 开始支持 SP3） 统信操作系统 (UOS) V20 openEuler 22.03 LTS SP1/SP3
警告
根据 CentOS Linux EOL ，CentOS Linux 7 的上游支持已于 2024 年 6 月 30 日终止。升级 TiDB 前，请务必检查你的操作系统版本。TiDB 在 v8.4.0 DMR 和 v8.5.0 版本中移除了对 glibc 2.17 的适配，以及对 CentOS Linux 7 的兼容性测试和支持，建议使用 Rocky Linux 9.1 及以上的版本。如果在使用 CentOS Linux 7 的情况下将 TiDB 升级到 v8.4.0 DMR 或 v8.5.0 版本，将存在导致集群不可用的风险。 为了更好地服务仍在使用 CentOS Linux 7 的用户，TiDB 从 v8.5.1 版本起重新适配 glibc 2.17，恢复了对 CentOS Linux 7 的兼容性支持和测试。然而，由于 CentOS Linux 7 已到达 EOL，强烈建议用户参考该系统的官方声明和安全建议 ，将生产环境迁移到 TiDB 支持的操作系统版本，如 Rocky Linux 9.1 及以上版本。 根据 Red Hat Enterprise Linux Life Cycle ，Red Hat Enterprise Linux 7 的 Maintenance Support 于 2024 年 6 月 30 日终止。从 8.4 DMR 版本开始，TiDB 已结束对 Red Hat Enterprise Linux 7 的支持，建议使用 Rocky Linux 9.1 及以上的版本。如果将运行在 Red Hat Enterprise Linux 7 上的 TiDB 集群升级到 v8.4.0 或之后版本，将存在导致集群不可用的风险。升级 TiDB 前，请务必检查你的操作系统版本。 注意
对 Red Hat Enterprise Linux 9.x 版本的支持从 TiUP v1.16.5 开始。
兼容平台 ：在以下组合中，TiDB 可以进行编译、构建和部署，并支持 OLTP、OLAP 和数据工具。这些组合未纳入每个版本的系统性测试矩阵；其兼容性通过编译构建、部署验证以及 TiDB 用户的实际使用得到确认。如需在这些平台上进行生产部署，请联系 PingCAP，以确认你的订阅服务是否涵盖相应支持。
操作系统 支持的 CPU 架构 macOS 12 (Monterey) 及以上的版本 Oracle Enterprise Linux 8 及以上的版本 x86_64 Ubuntu LTS 20.04 及以上的版本 x86_64 CentOS Stream 8 Debian 10 (Buster) 及以上的版本 x86_64 Fedora 38 及以上的版本 x86_64 openSUSE Leap 15.5 以上的版本（不包含 Tumbleweed） x86_64 SUSE Linux Enterprise Server 15 x86_64
注意
TiDB 只支持 Red Hat 兼容内核 (RHCK) 的 Oracle Enterprise Linux，不支持 Oracle Enterprise Linux 提供的 Unbreakable Enterprise Kernel。 TiDB 将不再支持 Ubuntu 16.04。为满足 TiDB 的操作系统兼容性要求，强烈建议使用 Ubuntu 20.04 LTS 或更高的 LTS 版本。 CentOS Stream 8 已于 2024 年 5 月 31 日 End of Builds 。 对于以上两个表格中所列操作系统的 32 位版本，TiDB 在这些 32 位操作系统以及对应的 CPU 架构上不保障 可编译、可构建以及可部署，或 TiDB 不主动适配这些 32 位的操作系统。
以上未提及的操作系统版本也许可以 运行 TiDB，但尚未得到 TiDB 官方支持。
编译和运行 TiDB 所依赖的库 编译和构建 TiDB 所需的依赖库 版本 Golang 1.25 及以上版本 Rust nightly-2025-02-28 及以上版本 GCC 7.x LLVM 17.0 及以上版本
运行时所需的依赖库：glibc（2.28-151.el8 版本）
注意
对于 TiDB v8.5.1 及之后的 v8.5.x 版本，如果你仍在使用 CentOS Linux 7，TiDB 也支持 glibc 2.17。
Docker 镜像依赖 支持的 CPU 架构如下：
软件配置要求 中控机软件配置 软件 版本 sshpass 1.06 及以上 TiUP 1.5.0 及以上
目标主机建议配置软件 软件 版本 sshpass 1.06 及以上 numa 2.0.12 及以上 tar 任意
服务器配置要求 TiDB 支持部署和运行在 Intel x86-64 架构的 64 位通用硬件服务器平台或者 ARM 架构的硬件服务器平台。对于开发、测试及生产环境的服务器硬件配置（不包含操作系统 OS 本身的占用）有以下要求和建议：
开发及测试环境 组件 CPU 内存 本地存储 网络 实例数量(最低要求) TiDB 8 核+ 16 GB+ 存储要求 千兆网卡 1（可与 PD 同机器） PD 4 核+ 8 GB+ SAS, 200 GB+ 千兆网卡 1（可与 TiDB 同机器） TiKV 8 核+ 32 GB+ SSD, 200 GB+ 千兆网卡 3 TiFlash 32 核+ 64 GB+ SSD, 200 GB+ 千兆网卡 1 TiCDC 8 核+ 16 GB+ SAS, 200 GB+ 千兆网卡 1 TiProxy 4 核+ 8 GB+ SAS 千兆网卡 1
注意
验证测试环境中的 TiDB 和 PD 可以部署在同一台服务器上。 如进行性能相关的测试，避免采用低性能存储和网络硬件配置，防止对测试结果的正确性产生干扰。 TiKV 的 SSD 盘推荐使用 NVME 接口以保证读写更快。 如果仅验证功能，建议使用 TiDB 数据库快速上手指南 进行单机功能测试。 从 v6.3.0 开始，在 Linux AMD64 架构的硬件平台部署 TiFlash 时，CPU 必须支持 AVX2 指令集。确保命令 grep avx2 /proc/cpuinfo 有输出。而在 Linux ARM64 架构的硬件平台部署 TiFlash 时，CPU 必须支持 ARMv8 架构。确保命令 grep 'crc32' /proc/cpuinfo | grep 'asimd' 有输出。通过使用向量扩展指令集，TiFlash 的向量化引擎能提供更好的性能。 生产环境 组件 CPU 内存 硬盘类型 网络 实例数量(最低要求) TiDB 16 核+ 48 GB+ SSD 万兆网卡（2 块最佳） 2 PD 8 核+ 16 GB+ SSD 万兆网卡（2 块最佳） 3 TiKV 16 核+ 64 GB+ SSD 万兆网卡（2 块最佳） 3 TiFlash 48 核+ 128 GB+ 1 or more SSDs 万兆网卡（2 块最佳） 2 TiCDC 16 核+ 64 GB+ SSD 万兆网卡（2 块最佳） 2 监控 8 核+ 16 GB+ SAS 千兆网卡 1 TiProxy 8 核+ 16 GB+ SAS 万兆网卡（2 块最佳） 2
注意
生产环境中的 TiDB 和 PD 可以部署和运行在同一台服务器上，如对性能和可靠性有更高的要求，应尽可能分开部署。
强烈建议分别为生产环境中的 TiDB、TiKV 和 TiFlash 配置至少 8 核的 CPU。强烈推荐使用更高的配置，以获得更好的性能。
TiKV 硬盘大小配置建议 PCIe SSD 不超过 4 TB，普通 SSD 不超过 1.5 TB。
如果你在云服务商（如 AWS、Google Cloud 或 Azure）上部署 TiDB 集群，建议 TiKV 节点使用云盘，而不要使用实例存储 (Instance Store)。
实例存储的数据持久性相对较低。实例存储的生命期与虚拟机绑定，一旦实例出现重启、停止、迁移、硬件损坏、维护等，数据可能丢失。大部分云厂商明确将实例存储标记为“临时存储”，以 AWS 为例：“实例存储卷上的数据仅在关联实例的生命周期内保留；如果您停止、休眠或终止实例，则实例存储卷上的所有数据都会丢失。” 实例存储通常不支持快照、跨节点或区域复制，一旦出现损坏或者故障，无法快速恢复。 实例存储的容量与机型绑定，无法进行独立扩容。 在部署 TiFlash 之前，请注意以下事项：
TiFlash 支持多盘部署 。 TiFlash 数据目录的第一块磁盘推荐用高性能 SSD 来缓冲 TiKV 同步数据的实时写入，该盘性能应不低于 TiKV 所使用的磁盘，比如 PCIe SSD。并且该磁盘容量建议不小于总容量的 10%，否则它可能成为这个节点的能承载的数据量的瓶颈。而其他磁盘可以根据需求部署多块普通 SSD，当然更好的 PCIe SSD 硬盘会带来更好的性能。 TiFlash 推荐与 TiKV 部署在不同节点，如果条件所限必须将 TiFlash 与 TiKV 部署在相同节点，则需要适当增加 CPU 核数和内存，且尽量将 TiFlash 与 TiKV 部署在不同的磁盘，以免互相干扰。 TiFlash 硬盘总容量大致为：整个 TiKV 集群的需同步数据容量 / TiKV 副本数 * TiFlash 副本数。例如整体 TiKV 的规划容量为 1 TB、TiKV 副本数为 3、TiFlash 副本数为 2，则 TiFlash 的推荐总容量为 1024 GB / 3 * 2。用户可以选择同步部分表数据而非全部，具体容量可以根据需要同步的表的数据量具体分析。 在部署 TiCDC 时，建议在大于 500 GB 的 PCIe SSD 磁盘上部署。
网络要求 TiDB 作为开源一栈式实时 HTAP 数据库，其正常运行需要网络环境提供如下的网络端口配置要求，管理员可根据实际环境中 TiDB 组件部署的方案，在网络侧和主机侧开放相关端口：
组件 默认端口 说明 TiDB 4000 应用及 DBA 工具访问通信端口 TiDB 10080 TiDB 状态信息上报通信端口 TiKV 20160 TiKV 通信端口 TiKV 20180 TiKV 状态信息上报通信端口 PD 2379 提供 TiDB 和 PD 通信端口 PD 2380 PD 集群节点间通信端口 TiFlash 9000 TiFlash TCP 服务端口（TiFlash v7.1.0 及以上版本由 TiUP v1.12.5 及以上版本部署时默认关闭；不建议配置） TiFlash 3930 TiFlash RAFT 服务和 Coprocessor 服务端口 TiFlash 20170 TiFlash Proxy 服务端口 TiFlash 20292 Prometheus 拉取 TiFlash Proxy metrics 端口 TiFlash 8234 Prometheus 拉取 TiFlash metrics 端口 CDC 8300 CDC 通信接口 Monitoring 9090 Prometheus 服务通信端口 Monitoring 12020 NgMonitoring 服务通信端口 Node_exporter 9100 TiDB 集群每个节点的系统信息上报通信端口 Blackbox_exporter 9115 Blackbox_exporter 通信端口，用于 TiDB 集群端口监控 Grafana 3000 Web 监控服务对外服务和客户端(浏览器)访问端口 Alertmanager 9093 告警 web 服务端口 Alertmanager 9094 告警通信端口
存储要求 组件 磁盘空间要求 健康水位使用率 TiDB 低于 90% PD 数据盘和日志盘建议最少各预留 20 GB 低于 90% TiKV 数据盘和日志盘建议最少各预留 100 GB 低于 80% TiFlash 数据盘建议最少预留 100 GB，日志盘建议最少预留 30 GB 低于 80% TiUP 中控机：部署一个版本的 TiDB 集群占用不超过 1 GB 空间，部署多个版本集群所占用的空间会相应增加 部署服务器（实际运行 TiDB 各组件的机器）：TiFlash 占用约 700 MB 空间，其他组件（PD、TiDB、TiKV 等）各占用约 200 MB 空间。同时，部署过程会占用小于 1 MB 临时空间（/tmp）存放临时文件 不涉及 Ngmonitoring Conprof：3 x 1 GB x 组件数量（表示每个组件每天占用约 1 GB，总共 3 天） + 20 GB 预留空间 Top SQL：30 x 50 MB x 组件数量（每个组件每天占用约 50 MB，总共 30 天） Top SQL 和 Conprof 共享预留空间 不涉及
TiDB 支持 XFS 和 Ext4 文件系统。其他文件系统不推荐用于生产环境。
客户端 Web 浏览器要求 TiDB 提供了基于 Grafana 的技术平台，对数据库集群的各项指标进行可视化展现。采用支持 Javascript 的微软 Edge、Apple Safari、Google Chrome、Mozilla Firefox 的较新版本即可访问监控入口。
TiFlash 存算分离架构的软硬件要求 上面的 TiFlash 软硬件要求是针对存算一体架构的。从 v7.0.0 开始，TiFlash 支持存算分离架构 ，该架构下 TiFlash 分为 Write Node 和 Compute Node 两个角色，对应的软硬件要求如下：
软件：与存算一体架构一致，详见操作系统及平台要求 。 网络端口：与存算一体架构一致，详见网络要求 。 磁盘空间：TiFlash Write Node：推荐 200 GB+，用作增加 TiFlash 副本、Region 副本迁移时向 Amazon S3 上传数据前的本地缓冲区。此外，还需要一个与 Amazon S3 兼容的对象存储。 TiFlash Compute Node：推荐 100 GB+，主要用于缓存从 Write Node 读取的数据以提升性能。Compute Node 的缓存可能会被完全使用，这是正常现象。 CPU 以及内存等要求参考下文。 开发及测试环境 组件 CPU 内存 本地存储 网络 实例数量（最低要求） TiFlash Write Node 16 核+ 32 GB+ SSD, 200 GB+ 千兆网卡 1 TiFlash Compute Node 16 核+ 32 GB+ SSD, 100 GB+ 千兆网卡 0（参见下文“注意”说明）
生产环境 组件 CPU 内存 硬盘类型 网络 实例数量（最低要求） TiFlash Write Node 32 核+ 64 GB+ SSD, 200 GB+ 万兆网卡（2 块最佳） 2 TiFlash Compute Node 32 核+ 64 GB+ SSD, 100 GB+ 万兆网卡（2 块最佳） 0（参见下文“注意”说明）
注意
TiFlash Compute Node 可以使用 TiUP 等部署工具快速扩缩容，扩缩容范围是 [0, +inf]。