系统兼容性说明

最后更新：2025年1月20日编译环境：GCC 8.5.0 / GLIBC 2.28

📋 概述

本文档说明了当前构建的二进制文件的最低兼容系统版本要求，以及各 Linux 发行版的支持情况。

🔍 glibc 依赖分析

GLIBC 版本要求

通过分析 release 目录下的二进制文件，确定以下 GLIBC 符号依赖：

# 检测 GLIBC 版本依赖
$ strings /workspace/release/ztgame/SuperServer | grep "^GLIBC_" | sort -V

GLIBC_2.2.5   # 基础要求
GLIBC_2.3
GLIBC_2.3.2
GLIBC_2.9
GLIBC_2.10
GLIBC_2.14    # ⚠️ 最高要求（关键限制）

核心限制：GLIBC ≥ 2.14

✅ 系统兼容性矩阵

RedHat/CentOS 系列

发行版	版本	GLIBC 版本	兼容性	备注
CentOS 6.x	6.0-6.10	GLIBC 2.12	❌ 不兼容	GLIBC 版本过低
CentOS 7.x	7.0-7.9	GLIBC 2.17	✅ 兼容	最低版本
CentOS 8.x	8.0-8.5	GLIBC 2.28	✅ 兼容	完全支持
CentOS Stream 8	8	GLIBC 2.28	✅ 兼容	滚动更新版本
CentOS Stream 9	9	GLIBC 2.34	✅ 兼容	最新版本
RHEL 6.x	6.0-6.10	GLIBC 2.12	❌ 不兼容	GLIBC 版本过低
RHEL 7.x	7.0-7.9	GLIBC 2.17	✅ 兼容	最低版本
RHEL 8.x	8.0-8.10	GLIBC 2.28	✅ 兼容	完全支持
RHEL 9.x	9.0-9.4	GLIBC 2.34	✅ 兼容	完全支持
Rocky Linux 8	8.0-8.9	GLIBC 2.28	✅ 兼容	CentOS 替代品
Rocky Linux 9	9.0-9.3	GLIBC 2.34	✅ 兼容	最新版本
AlmaLinux 8	8.0-8.9	GLIBC 2.28	✅ 兼容	CentOS 替代品
AlmaLinux 9	9.0-9.3	GLIBC 2.34	✅ 兼容	最新版本

RedHat 系列最低版本：CentOS 7.0 / RHEL 7.0

最新版本支持：

✅ CentOS Stream 9 / RHEL 9.x / Rocky Linux 9 / AlmaLinux 9（GLIBC 2.34）
✅ CentOS 8 / RHEL 8.x / Rocky Linux 8 / AlmaLinux 8（GLIBC 2.28）

Debian/Ubuntu 系列

发行版	版本	GLIBC 版本	兼容性	备注
Debian 7	Wheezy	GLIBC 2.13	❌ 不兼容	GLIBC 版本过低
Debian 8	Jessie	GLIBC 2.19	✅ 兼容	最低版本
Debian 9	Stretch	GLIBC 2.24	✅ 兼容	完全支持
Debian 10	Buster	GLIBC 2.28	✅ 兼容	完全支持
Debian 11	Bullseye	GLIBC 2.31	✅ 兼容	完全支持
Debian 12	Bookworm	GLIBC 2.36	✅ 兼容	完全支持
Ubuntu 10.04	Lucid	GLIBC 2.12	❌ 不兼容	已停止支持
Ubuntu 12.04	Precise	GLIBC 2.15	✅ 兼容	最低版本
Ubuntu 14.04	Trusty	GLIBC 2.19	✅ 兼容	完全支持
Ubuntu 16.04	Xenial	GLIBC 2.23	✅ 兼容	完全支持
Ubuntu 18.04	Bionic	GLIBC 2.27	✅ 兼容	完全支持
Ubuntu 20.04+	Focal及以上	≥2.31	✅ 兼容	完全支持

Debian 系列最低版本：Debian 8 (Jessie)

Ubuntu 系列最低版本：Ubuntu 12.04 (Precise)

🔧 动态库依赖

必需的动态链接库

$ ldd /workspace/release/ztgame/SuperServer | grep -E "GLIBC|libstdc\+\+|libmysql|libxml2|libpthread"

  libpthread.so.0      # POSIX 线程库
  libmysqlclient.so.18 # MySQL 客户端库
  libxml2.so.2         # XML 解析库
  libstdc++.so.6       # C++ 标准库
  libc.so.6            # C 标准库 (GLIBC)
  libdl.so.2           # 动态链接库
  libgcc_s.so.1        # GCC 运行时
  liblzma.so.5         # LZMA 压缩库
  libm.so.6            # 数学库
  libz.so.1            # zlib 压缩库

libstdc++ 要求

$ strings /workspace/release/ztgame/SuperServer | grep "^GLIBCXX_" | sort -V

GLIBCXX_3.4
GLIBCXX_3.4.2
GLIBCXX_3.4.9
GLIBCXX_3.4.11
GLIBCXX_3.4.15
GLIBCXX_3.4.20    # ⚠️ 需要 GCC 4.9+
GLIBCXX_3.4.21

要求：GCC 4.9+ 的 libstdc++

📊 系统要求总结

✅ 推荐部署环境

发行版系列	最低版本	GLIBC 要求	状态
CentOS	7.0+	GLIBC ≥ 2.17	✅ 推荐
CentOS Stream	8 / 9	GLIBC ≥ 2.28	✅ 推荐
RHEL	7.0+	GLIBC ≥ 2.17	✅ 推荐
Rocky Linux	8 / 9	GLIBC ≥ 2.28	✅ 推荐
AlmaLinux	8 / 9	GLIBC ≥ 2.28	✅ 推荐
Debian	8+	GLIBC ≥ 2.19	✅ 推荐
Ubuntu	12.04+	GLIBC ≥ 2.15	✅ 推荐

❌ 不支持的系统

发行版系列	版本	原因
CentOS/RHEL	6.x	GLIBC 2.12 < 2.14
Debian	7 (Wheezy)	GLIBC 2.13 < 2.14
Ubuntu	10.04 (Lucid)	GLIBC 2.12 < 2.14

🔬 检测方法

方法1：使用 `file` 命令

$ file /workspace/release/ztgame/SuperServer

SuperServer: ELF 64-bit LSB executable, x86-64, version 1 (GNU/Linux),
dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2,
for GNU/Linux 3.2.0

方法2：使用 `readelf` 检查 ABI 版本

$ readelf -n /workspace/release/ztgame/SuperServer | grep -A 2 "NT_GNU_ABI_TAG"

  GNU                  0x00000010  NT_GNU_ABI_TAG (ABI version tag)
    OS: Linux, ABI: 3.2.0

方法3：检查 GLIBC 版本依赖

$ strings /workspace/release/ztgame/SuperServer | grep "^GLIBC_" | sort -V

GLIBC_2.2.5
GLIBC_2.3
GLIBC_2.3.2
GLIBC_2.9
GLIBC_2.10
GLIBC_2.14

方法4：检查动态库依赖

$ ldd /workspace/release/ztgame/SuperServer | grep NEEDED

  NEEDED               ld-linux-x86-64.so.2
  NEEDED               libc.so.6
  NEEDED               libdl.so.2
  NEEDED               libgcc_s.so.1
  NEEDED               liblzma.so.5
  NEEDED               libm.so.6
  NEEDED               libmysqlclient.so.18
  NEEDED               libpthread.so.0
  NEEDED               libstdc++.so.6
  NEEDED               libxml2.so.2
  NEEDED               libz.so.1

🛠️ 兼容性解决方案

方案1：升级操作系统（推荐）

CentOS 6 → CentOS 7 升级

# 检查当前版本
$ cat /etc/redhat-release
CentOS release 6.10 (Final)

# 升级到 CentOS 7（需重新安装）
# 备份数据后，使用 CentOS 7 安装介质重新部署

Debian 7 → Debian 8 升级

# 检查当前版本
$ cat /etc/debian_version
7.11

# 升级到 Debian 8
$ sudo apt-get update
$ sudo apt-get install debian-archive-keyring
$ sudo sed -i 's/wheezy/jessie/g' /etc/apt/sources.list
$ sudo apt-get update
$ sudo apt-get dist-upgrade

方案2：使用 Docker 容器部署

如果必须在老系统上运行，可以使用 Docker 容器：

# Dockerfile
FROM centos:7

# 安装必需的库
RUN yum install -y \
    libstdc++ \
    libxml2 \
    mysql \
    zlib

# 复制二进制文件
COPY release/ztgame/ /opt/ztgame/

# 设置工作目录
WORKDIR /opt/ztgame

# 启动服务
CMD ["./SuperServer"]

构建和运行：

$ docker build -t zebra-server .
$ docker run -d --name zebra-server zebra-server

方案3：在老系统上重新编译

如果必须在老系统上运行，可以在目标系统上重新编译：

# 在 CentOS 6 上编译（需要 GCC 4.9+）
$ sudo yum install gcc49-c++ libxml2-devel mysql-devel
$ export CC=gcc49
$ export CXX=g++49
$ make clean
$ make release

注意： 这需要确保老系统上有 GCC 4.9+ 编译器。

📌 关键依赖库版本要求

库名称	最低版本	说明
GLIBC	2.14	核心限制
libstdc++	3.4.20 (GCC 4.9+)	C++ 运行时
libmysqlclient	5.5+ (so.18)	MySQL 客户端
libxml2	2.7+	XML 解析
libz	1.2+	zlib 压缩
libpthread	2.0+	POSIX 线程

🚀 部署建议

📚 参考资料

📝 更新日志

日期	版本	更新内容
2025-01-15	1.0	初始版本，基于 GCC 8.5.0 编译环境分析
2025-01-16	1.1	新增aarch64 CentOS Stream 8/9、RHEL 9.x、Rocky Linux 8/9、AlmaLinux 8/9 支持

📧 技术支持

如有兼容性问题，请提供以下信息：

# 系统信息
$ cat /etc/os-release

# GLIBC 版本
$ ldd --version

# 二进制文件信息
$ file /path/to/SuperServer
$ ldd /path/to/SuperServer
$ strings /path/to/SuperServer | grep "^GLIBC_"

文档维护：Zebra 开发团队

📋 概述​

🔍 glibc 依赖分析​

GLIBC 版本要求​

✅ 系统兼容性矩阵​

RedHat/CentOS 系列​

Debian/Ubuntu 系列​

🔧 动态库依赖​

必需的动态链接库​

libstdc++ 要求​

📊 系统要求总结​

✅ 推荐部署环境​

❌ 不支持的系统​

🔬 检测方法​

方法1：使用 file 命令​

方法2：使用 readelf 检查 ABI 版本​

方法3：检查 GLIBC 版本依赖​

方法4：检查动态库依赖​

🛠️ 兼容性解决方案​

方案1：升级操作系统（推荐）​

方案2：使用 Docker 容器部署​

方案3：在老系统上重新编译​

📌 关键依赖库版本要求​

🚀 部署建议​

推荐配置​

📚 参考资料​

📝 更新日志​

📧 技术支持​