batonogov/pyinstaller-linux

PyInstaller Docker Images

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

镜像概述和主要用途

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

核心功能和特性

• 多平台支持：支持为Linux、Windows平台打包Python应用，OSX平台支持为实验性特性
• 环境隔离：基于Docker容器运行，与主机系统环境隔离，避免依赖冲突
• 工具集成：预装PyInstaller及相关依赖，可直接使用其命令进行应用打包

使用场景和适用范围

• Python开发者需要为多个操作系统打包应用程序，且希望简化跨平台打包流程
• 开发环境与目标部署环境存在差异，需要统一打包环境以确保应用兼容性
• 需快速生成可执行文件，避免手动配置PyInstaller及跨平台编译依赖

使用方法和配置说明

基本使用流程

1. 确保本地已安装Docker环境
2. 将Python项目目录挂载到容器内，执行PyInstaller打包命令

Docker Run命令示例

为Linux平台打包应用

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

• --rm：容器退出后自动删除
• -v "$(pwd):/src"：将当前目录挂载到容器内的/src目录（项目代码存放路径）
• pyinstaller --onefile your_script.py：执行PyInstaller命令，以单文件模式打包指定Python脚本

为Windows平台打包应用

bash
docker run --rm -v "$(pwd):/src" batonogov/pyinstaller pyinstaller --onefile --windowed --target-arch=win32 your_script.py

• --windowed：生成无控制台窗口的GUI应用（可选）
• --target-arch=win32：指定目标架构为32位Windows（根据需求调整为win64）

为OSX平台打包应用（实验性）

bash
docker run --rm -v "$(pwd):/src" batonogov/pyinstaller pyinstaller --onefile --target-arch=darwin your_script.py

注意：OSX平台打包功能为实验性，可能存在兼容性问题，建议参考GitHub仓库获取最新支持信息

注意事项

• 打包结果默认生成在容器内的/src/dist目录，通过挂载本地目录可在主机对应路径获取
• 复杂项目可能需要额外依赖文件，需确保相关资源文件也挂载到容器内或在项目中正确引用
• 详细配置参数及高级用法请参考PyInstaller官方文档及镜像GitHub仓库说明