Skip to content

Update OS recommendations based on upstream EOL info #21042

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 4, 2025
Merged

Update OS recommendations based on upstream EOL info #21042

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b866398
Update hardware-and-software-requirements.md
hfxsd Nov 3, 2025
f30430e
Update wording
lilin90 Nov 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 8 additions & 12 deletions hardware-and-software-requirements.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,34 +20,30 @@ summary: TiDB 是一款开源的一站式实时 HTAP 数据库，支持部署在

| 操作系统 | 支持的 CPU 架构 |
| :--- | :--- |
| Red Hat Enterprise Linux 8.4 及以上的 8.x 版本 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Red Hat Enterprise Linux 8.6 及以上的 8.x 版本 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Amazon Linux 2 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Amazon Linux 2023 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Rocky Linux 9.1 及以上的版本 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| 银河麒麟 V10 SP1/SP2/SP3（从 v7.5.5 开始支持 SP3） | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| 统信操作系统 (UOS) V20 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| openEuler 22.03 LTS SP1/SP3 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| macOS 13 (Ventura) 及以上的版本 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| openEuler 24.03 LTS SP4 及以上的版本 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| macOS 14 (Sonoma) 及以上的版本 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Oracle Enterprise Linux 8 及以上的版本 | x86_64 |
| Ubuntu LTS 22.04 及以上的版本 | x86_64 |
| CentOS 9 Stream | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Debian 11 (Bullseye) 及以上的版本 | x86_64 |
| Fedora 40 及以上的版本 | x86_64 |
| CentOS Stream 9 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Debian 12 (Bookworm) 及以上的版本 | x86_64 |
| Fedora 42 及以上的版本 | x86_64 |
| openSUSE Leap 15.6 以上的版本（不包含 Tumbleweed） | x86_64 |
| SUSE Linux Enterprise Server 15.6 | x86_64 |
| SUSE Linux Enterprise Server 15.6 及以上的版本 | x86_64 |

> **警告：**
>
> - 根据 [CentOS Linux EOL](https://www.centos.org/centos-linux-eol/)，CentOS Linux 7 的上游支持已于 2024 年 6 月 30 日终止。从 v8.4.0 版本开始，TiDB 已结束对 CentOS 7 的支持，建议使用 Rocky Linux 9.1 及以上的版本。如果将运行在 CentOS 7 上的 TiDB 集群升级到 v8.4.0 或之后版本，将导致集群不可用。升级 TiDB 前，请务必检查你的操作系统版本。
> - 根据 [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata/#Life_Cycle_Dates)，Red Hat Enterprise Linux 7 的 Maintenance Support 已于 2024 年 6 月 30 日终止。从 v8.4.0 版本开始，TiDB 已结束对 Red Hat Enterprise Linux 7 的支持，建议使用 Rocky Linux 9.1 及以上的版本。如果将运行在 Red Hat Enterprise Linux 7 上的 TiDB 集群升级到 v8.4.0 或之后版本，将导致集群不可用。升级 TiDB 前，请务必检查你的操作系统版本。
> - 对于以上表格中所列操作系统的 32 位版本，TiDB 在这些 32 位操作系统以及对应的 CPU 架构上**不保障**可编译、可构建以及可部署，或 TiDB 不主动适配这些 32 位的操作系统。
> - TiDB 要求使用 64 位 CPU 架构。
> - 以上未提及的操作系统版本**也许可以**运行 TiDB，但尚未得到 TiDB 官方支持。

> **注意：**
>
> - TiDB 只支持 Red Hat 兼容内核 (RHCK) 的 Oracle Enterprise Linux，不支持 Oracle Enterprise Linux 提供的 Unbreakable Enterprise Kernel。
> - CentOS Linux 8 的上游支持已于 2021 年 12 月 31 日终止，但 CentOS 将继续提供对 CentOS Stream 8 的支持。
> - TiDB 将不再支持 Ubuntu 16.04。强烈建议升级到 Ubuntu 18.04 或更高版本。
> - 从 v8.4.0 开始，TiDB 依赖 glibc 2.28。如果 glibc 版本不满足要求，建议使用上述表格中支持的操作系统，或将操作系统升级到支持 glibc 2.28 的版本。

### 编译和运行 TiDB 所依赖的库
Expand Down