如何构建兼容多Linux发行版的Python独立可执行文件？

问题场景 #

要构建能在Ubuntu 16.x~22.x、RedHat 7.2上运行的单文件Python可执行程序，当前在Ubuntu 22.04用「PyInstaller生成单文件+staticx静态链接」的流程打包，但在Ubuntu 16.04运行时触发报错：

/lib/x86_64-linux-gnu/libc.so.6: version 'GLIBC_2.34' not found (required by /tmp/_MEIvDsZl/libgcc_s.so.1)

尝试用staticx的-l参数添加构建机的libc.so.6无效，以下是针对问题的解决方案：

1. 修复staticx打包的兼容问题 #

核心逻辑：必须在最低版本的目标系统环境中打包。高版本系统（比如Ubuntu22.04）的系统库依赖更高版本的GLIBC符号，强行用staticx捆绑这些库到低版本系统里必然触发版本不兼容——这也是-l参数无效的原因：你加的libc.so.6本身就依赖GLIBC_2.34，低版本系统根本不认。

有两种可行实现方式：

• 直接在旧系统实体机构建
  选Ubuntu 16.04或RedHat 7.2作为构建机，安装好依赖后执行原有打包流程：

  # Ubuntu16.04下安装依赖
  sudo apt update && sudo apt install python3-pip patchelf binutils
  pip3 install pyinstaller staticx
  
  # 生成PyInstaller单文件
  pyinstaller --onefile your_app.py
  
  # staticx静态处理
  staticx dist/your_app dist/your_app_static
  

  用旧系统打包出来的二进制，依赖的GLIBC版本是旧系统的版本，自然能兼容所有更高版本的目标系统。

• 用容器模拟旧系统构建
  不想装实体机的话，用Docker拉取旧系统镜像，在容器内完成打包：

  # 拉取Ubuntu16.04镜像
  docker pull ubuntu:16.04
  
  # 启动容器并挂载本地代码目录
  docker run -it -v /本地代码路径:/app ubuntu:16.04
  
  # 容器内重复上面的安装和打包步骤即可
  

2. staticx的替代工具 #

AppImage

专门做跨Linux发行版的可执行包，支持捆绑依赖和第三方二进制工具。搭配PyInstaller的使用步骤：

1. 用PyInstaller生成非单文件的目录包：pyinstaller your_app.py
2. 按照AppImage的规范创建AppDir结构，把PyInstaller生成的dist目录内容移入，再添加.desktop启动配置文件和图标
3. 用appimagetool打包成AppImage文件，这个文件可以直接在Ubuntu16.x~22.x、RedHat7.2等几乎所有主流Linux发行版上运行。

Nuitka

把Python代码编译成C代码再生成二进制，支持减少系统库依赖的编译选项。尝试静态编译模式打包：

pip install nuitka
nuitka --standalone --static-libpython=no your_app.py

注：--static-libpython=no是因为Python本身很难完全静态编译，但Nuitka会打包必要的依赖库，生成的二进制兼容性较好，同样建议在旧系统环境构建来保证跨版本兼容。

cxfreeze

和PyInstaller类似的打包工具，支持生成独立可执行文件，自动打包依赖库。同样遵循「旧系统构建」原则，就能生成兼容目标系统的程序，也可以配合静态链接工具进一步优化兼容性。

内容的提问来源于stack exchange，提问作者quite68