cdrx/pyinstaller-linux

PyInstaller Docker镜像（Linux版）

cdrx/pyinstaller-linux 是一款Docker容器镜像，旨在简化Python应用程序到Linux平台可执行二进制文件的编译过程。配合对应的Windows版镜像，可满足跨平台打包需求。当前默认使用PyInstaller 3.6版本。

核心功能

• 支持双Python版本：:python2标签对应Python 2.7，:python3标签对应Python 3.7（:latest默认指向此版本）
• 自动处理依赖：检测并安装requirements.txt中的Python包
• 灵活扩展：允许自定义安装系统级库（如通过apt-get添加依赖）
• 镜像源支持：可指定PyPI镜像加速包安装
• 快速生成配置：直接生成PyInstaller所需的.spec文件

使用场景

• 将Python脚本打包为Linux独立运行的二进制文件
• 避免本地环境与目标运行环境的依赖冲突
• 自动化批量构建Python应用分发包

配置说明与示例

标签选择

• cdrx/pyinstaller-linux:python2：基于Python 2.7
• cdrx/pyinstaller-linux:python3：基于Python 3.7（默认latest）

基础打包命令

在包含源代码、.spec文件和requirements.txt的目录下执行：

bash
docker run -v "$(pwd):/src/" cdrx/pyinstaller-linux

打包结果将输出到dist/linux/目录，二进制文件名与.spec文件同名。

生成.spec文件

若未生成.spec文件，可通过以下命令生成：

bash
docker run -v "$(pwd):/src/" cdrx/pyinstaller-linux "pyinstaller your-script.py"

安装系统级依赖

如需添加系统库（如wget），可自定义入口命令：

bash
docker run -v "$(pwd):/src/" --entrypoint /bin/sh cdrx/pyinstaller-linux -c "apt-get update -y && apt-get install -y wget && /entrypoint.sh"

更换PyInstaller版本

在requirements.txt中指定版本，例如：

txt
pyinstaller=3.1.1

使用PyPI镜像源

通过环境变量指定镜像地址（以阿里云镜像为例）：

bash
docker run -v "$(pwd):/src/" -e PYPI_URL=https://mirrors.aliyun.com/pypi/simple/ -e PYPI_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/ cdrx/pyinstaller-linux

已知问题

暂无

版本历史

• [1.0] 2016-08-26：首次发布
• [1.3] 2017-01-23：升级PyInstaller至3.2.1，支持自定义PyPI源
• [1.8] 2019-01-15：使用旧版glibc提升兼容性，PyInstaller升级至3.4
• [1.9] 2020-01-14：添加32位包支持，PyInstaller升级至3.6

许可证

MIT