batonogov/pyinstaller-windows

PyInstaller Docker Images

https://github.com/batonogov/docker-pyinstaller

镜像概述与主要用途

本Docker镜像包含PyInstaller工具，旨在提供一个隔离、一致的环境，帮助开发者在Linux系统中为Linux、Windows和OSX（实验性）平台构建Python应用程序的可执行文件。通过Docker容器化PyInstaller，可避免因本地环境差异导致的打包问题，简化跨平台Python应用的分发流程。

核心功能与特性

• 多平台支持：可在Linux环境下为Linux、Windows平台构建可执行文件，同时提供对OSX平台的实验性支持。
• 环境隔离：通过Docker容器隔离打包环境，确保不同项目的依赖和配置互不干扰。
• 简化打包流程：集成PyInstaller及必要依赖，无需本地安装配置，直接通过容器命令完成打包。
• 兼容性：支持主流Python版本（具体版本可参考GitHub仓库说明），适配常见Python项目结构。

使用场景与适用范围

• Python开发者：需要为多平台（Linux、Windows、OSX实验性）分发Python应用的开发者。
• CI/CD集成：可嵌入持续集成/持续部署流程，实现自动化打包。
• 环境一致性要求：避免因本地Python版本、库依赖差异导致的打包失败问题。
• 跨平台测试：在单一Linux环境中验证多平台可执行文件的构建效果。

使用方法与配置说明

基本使用示例

通过docker run命令启动容器，挂载本地Python项目目录至容器内的/src路径，执行PyInstaller命令打包应用。

为Linux平台打包

bash
docker run --rm -v "$(pwd):/src" batonogov/pyinstaller --onefile my_script.py

• --rm：打包完成后自动删除容器。
• -v "$(pwd):/src"：将当前目录（包含Python项目）挂载到容器内的/src目录。
• --onefile：PyInstaller参数，生成单个可执行文件。
• my_script.py：待打包的Python入口脚本。

为Windows平台打包

需指定Windows目标平台，通过PyInstaller的交叉编译支持：

bash
docker run --rm -v "$(pwd):/src" batonogov/pyinstaller --onefile --platform win32 my_script.py

为OSX平台打包（实验性）

OSX支持为实验性功能，使用时需注意兼容性：

bash
docker run --rm -v "$(pwd):/src" batonogov/pyinstaller --onefile --platform darwin my_script.py

高级配置

• 指定Python版本：部分镜像标签可能对应特定Python版本（如py39表示Python 3.9），可通过镜像标签选择：

  bash
  docker run --rm -v "$(pwd):/src" batonogov/pyinstaller:py39 --onefile my_script.py
  

• 自定义输出目录：通过-o参数指定可执行文件输出路径：

  bash
  docker run --rm -v "$(pwd):/src" batonogov/pyinstaller --onefile -o /src/dist/myapp my_script.py
  

注意事项

• OSX平台支持为实验性，可能存在部分功能限制或兼容性问题。
• 复杂依赖项目（如包含C扩展的Python库）可能需要额外配置，建议参考https://github.com/batonogov/docker-pyinstaller%E8%8E%B7%E5%8F%96%E8%AF%A6%E7%BB%86%E8%AF%B4%E6%98%8E%E3%80%82
• 确保本地项目路径权限正确，避免容器挂载时出现读写错误。