stairwaytowonderland/cpython

🐳 快速参考

• 维护者：
  https://github.com/andrewhaller
• 许可证：
  https://github.com/stairwaytowonderland/cpython/blob/main/LICENSE

支持的标签及对应的Docker Hub链接

标签遵循格式 <python-version>[-<变体(ext|perf)>][-<基础镜像引用>]。

ℹ️ 注意：如果基础镜像的变体为 latest，则 <base-image-ref> 指基础镜像的名称；否则，<base-image-ref> 指基础镜像的变体。

示例：

• 若基础镜像为 ubuntu:latest，则 <base-image-ref> 为 ubuntu（基础镜像名称）。
• 若基础镜像为 debian:bookworm-slim，则 <base-image-ref> 为 bookworm-slim（基础镜像变体）。

标准镜像

加固镜像

快速参考（续）

• 源码Dockerfile：
  https://github.com/stairwaytowonderland/cpython/blob/main/docker/Dockerfile
• GitHub仓库：
  https://github.com/stairwaytowonderland/cpython
• Docker Hub：
  https://hub.docker.com/r/stairwaytowonderland/cpython

支持的平台

• linux/amd64
• linux/arm64

基础镜像

所有镜像均基于Debian系基础镜像构建，默认基础镜像为 ubuntu:latest。

ℹ️ 注意：Dockerfile要求基于Debian系镜像。可通过 IMAGE_NAME 和 VARIANT 构建参数使用其他Debian衍生发行版。

如何使用此镜像

在Dockerfile中使用

将已发布的镜像作为应用镜像的基础：

dockerfile
FROM stairwaytowonderland/cpython:3

WORKDIR /usr/src/myapp

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD [ "python", "./your-daemon-or-script.py" ]

构建镜像

克隆仓库并使用项目根目录提供的构建脚本：

bash
# 构建默认Python版本（最新版），目标为基础阶段
./docker/bin/build.sh cpython .

# 构建特定Python版本
./docker/bin/build.sh cpython \
  --build-arg PYTHON_VERSION=3.14 \
  .

# 构建启用PGO优化的版本
./docker/bin/build.sh cpython \
  --build-arg PYTHON_VERSION=3.14 \
  --build-arg ENABLE_OPTIMIZATIONS=true \
  .

或直接使用docker build构建：

bash
docker build \
  --build-arg PYTHON_VERSION=3.14 \
  --target base \
  -t cpython:3.14-ubuntu \
  -f docker/Dockerfile \
  .

运行Python命令

使用镜像运行一次性Python命令：

bash
docker run --rm stairwaytowonderland/cpython:3.14-ubuntu python3 --version

运行交互式Python shell：

bash
docker run -it --rm stairwaytowonderland/cpython:3.14-ubuntu python3

运行单个Python脚本

bash
docker run --rm \
  -v "$(pwd)":/usr/src/myapp \
  -w /myapp \
  stairwaytowonderland/cpython:3.14-ubuntu \
  python3 your-daemon-or-script.py

镜像变体 - 标准

cpython:<version>-ubuntu

默认镜像。基于 https://hub.docker.com/_/ubuntu 构建。Ubuntu是广泛使用、支持良好的Debian系发行版，拥有庞大的软件包生态，是大多数工作负载的通用选择。

cpython:<version>-bookworm-slim

基于 https://hub.docker.com/_/debian 构建。Debian Bookworm Slim是精简的Debian 12镜像，移除了非必要软件包以减小镜像体积，适合对镜像大小有要求且无需Ubuntu特定工具的场景。

cpython:<version>-perf-<base-image-ref>

性能优化构建，启用配置文件引导优化（PGO）（ENABLE_OPTIMIZATIONS=true）。PGO利用构建过程中收集的运行时分析数据生成更快的CPython二进制文件，推荐用于CPU性能关键的生产工作负载。支持ubuntu和bookworm-slim基础变体。

cpython:<version>-ext-<base-image-ref>

开发导向构建，包含扩展工具（PYTHON_DEV=true）。适用于开发环境和开发容器，需额外构建工具和库的场景。支持ubuntu和bookworm-slim基础变体。

镜像变体 - 加固版（DHI）

cpython:<version>-bookworm-debian12-dev

基于 dhi.io/debian-base:bookworm-debian12-dev 构建。这是项目的默认基础镜像——由dhi.io维护的定制Debian 12（Bookworm）基础镜像，专为Debian系容器工作流设计。预安装常用工具，提供精简、开发友好的基础，适合开发和CI环境。

项目介绍

一个自维护的Python Docker镜像，基于Debian系（Debian或Ubuntu）基础镜像从源码构建https://github.com/python/cpython%E3%80%82%E8%AE%BE%E8%AE%A1%E7%94%A8%E4%BA%8E%E5%AE%B9%E5%99%A8%E5%8C%96%E5%B7%A5%E4%BD%9C%E6%B5%81%E4%B8%AD%E7%9A%84%E8%BD%BB%E9%87%8F%E7%BA%A7%E3%80%81%E5%8F%AF%E5%AE%9A%E5%88%B6Python%E8%BF%90%E8%A1%8C%E6%97%B6%E3%80%82

灵感来源于对生产级、基于Ubuntu的Python"基础"镜像的个人需求。

🌐 https://github.com/stairwaytowonderland/cpython

!https://raw.githubusercontent.com/stairwaytowonderland/cpython/refs/heads/main/docs/assets/beesmall.png

许可证

本项目采用MIT许可证——允许自由使用、修改和分发，需保留署名。

完整许可证文本见https://github.com/stairwaytowonderland/cpython/blob/main/LICENSE%E6%96%87%E4%BB%B6%E3%80%82