minidocks/pyinstaller Docker镜像文档

镜像概述和主要用途

minidocks/pyinstaller是基于PyInstaller的Docker镜像，用于将Python应用程序打包（冻结）为独立可执行文件。其主要用途是帮助开发者将Python代码转换为无需依赖Python解释器即可运行的可执行文件，便于在不同操作系统环境中分发和部署。

核心功能和特性

核心功能

• 应用打包：将Python应用程序及其依赖项打包为单个独立可执行文件，无需目标环境安装Python解释器。
• 跨平台支持：支持生成Windows、GNU/Linux、Mac OS X、FreeBSD、Solaris和AIX等操作系统的可执行文件。

镜像特性

• 最小化设计：基于"Minimal pyinstaller images"理念，镜像体积精简，适合快速部署和资源受限场景。
• 版本标签：提供多个稳定版本标签（如latest、6、5），适配不同PyInstaller版本需求。
• 生态兼容：与minidocks/python镜像兼容，可无缝集成Python开发环境。

使用场景和适用范围

适用场景

• Python应用分发：开发者需向用户分发Python应用，且不希望用户手动安装Python及依赖。
• 跨平台部署：需要在多个操作系统（如Windows、Linux、macOS）上提供统一的可执行文件。
• CI/CD集成：在持续集成/持续部署流程中自动化打包Python应用，生成可执行文件产物。

适用范围

• 个人开发者或企业团队的Python应用打包需求。
• 中小型Python项目（无复杂C扩展依赖的场景）。

标签信息

使用方法和配置说明

基本使用（docker run）

通过docker run命令挂载Python代码目录，执行pyinstaller命令打包应用。基本语法如下：

docker run --rm -v $(pwd):/app -w /app minidocks/pyinstaller pyinstaller [选项] 入口文件.py

示例：打包当前目录的Python文件

假设当前目录存在main.py（应用入口文件），执行以下命令生成可执行文件：

# 使用latest标签
docker run --rm -v $(pwd):/app -w /app minidocks/pyinstaller pyinstaller --onefile main.py

# 使用指定版本标签（如6）
docker run --rm -v $(pwd):/app -w /app minidocks/pyinstaller:6 pyinstaller --onefile main.py

执行后，可执行文件将生成在当前目录的dist/文件夹中（与本地目录挂载对应）。

常用PyInstaller选项说明

打包时可通过pyinstaller命令选项自定义行为，常用选项包括：

• --onefile：生成单个可执行文件（默认生成多个文件）。
• --name：指定输出可执行文件的名称。
• --hidden-import：显式指定隐藏的依赖模块（当自动检测依赖失败时使用）。
• --distpath：指定输出目录（默认./dist）。

相关镜像

• Python：minidocks提供的Python基础镜像，可用于开发环境搭建。

替代方案

• pyinstaller-alpine：基于Alpine Linux的PyInstaller镜像，体积更小但可能存在兼容性限制。