cdrx/pyinstaller-windows

PyInstaller Docker镜像（Windows版）

cdrx/pyinstaller-windows 是一个Docker容器镜像，通过在Ubuntu中运行Wine模拟Windows环境，帮助开发者将Python应用编译为Windows可执行文件（.exe）。它与cdrx/pyinstaller-linux配合，满足跨平台编译需求，当前使用PyInstaller 3.6版本。

核心功能

• 支持Python 2.7（:python2标签）和Python 3.7（:python3标签，:latest默认指向此版本）
• 自动检测并安装项目根目录下requirements.txt中的Python依赖
• 允许自定义安装系统级依赖（如wget等）
• 支持通过环境变量配置PyPI镜像源
• 可直接调用PyInstaller生成.spec文件

使用场景

• 开发者在Linux/macOS环境下生成Windows平台的Python应用可执行文件
• 标准化编译环境，避免本地环境差异导致的编译问题
• 批量编译多个Python项目为Windows可执行文件

配置说明

标签选择

• cdrx/pyinstaller-windows:python2：Python 2.7环境
• cdrx/pyinstaller-windows:python3：Python 3.7环境（默认latest）

部署示例

1. 编译项目为Windows exe

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

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

结果输出到dist/windows/，exe文件名与.spec一致。

2. 生成.spec文件

若无.spec文件，运行：

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

3. 安装系统依赖

需安装额外系统包（如wget）时：

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

4. 使用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-windows

5. 修改PyInstaller版本

在requirements.txt添加：

txt
pyinstaller==3.1.1

已知问题

无

历史版本

• [1.0] 2016-08-26：首次发布
• [1.1] 2016-12-13：添加Windows Python3.4支持
• [1.2] 2016-12-13：添加Windows Python3.5支持
• [1.3] 2017-01-23：升级PyInstaller到3.2.1，支持自定义PyPI源
• [1.4] 2017-01-26：修复入口命令拼接bug
• [1.5] 2017-09-29：默认PyInstaller更新为3.3
• [1.6] 2017-11-06：添加Windows Python3.6支持
• [1.7] 2018-10-02：Linux Python版本升级到3.6
• [1.8] 2019-01-15：使用旧版glibc提升兼容性，PyInstaller到3.4
• [1.9] 2020-01-14：添加32位包支持，PyInstaller到3.6

许可证

MIT