amd64/python

Python Docker镜像(amd64架构)技术文档

注意事项

本仓库是https://hub.docker.com/_/python%E7%9A%84%60amd64%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%89%88%E6%9C%AC%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84https://github.com/docker-library/official-images#architectures-other-than-amd64%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

镜像概述和主要用途

Python是一种解释型、交互式、面向对象的开源编程语言。它集成了模块、异常处理、动态类型、高级动态数据类型和类等特性。Python以强大的功能和清晰的语法著称，拥有众多系统调用、库和窗口系统接口，并可通过C或C++进行扩展。它也可用作需要可编程接口的应用程序的扩展语言。Python具有良好的可移植性，可在多种Unix变体、Mac和Windows 2000及更高版本上运行。

维护者

https://github.com/docker-library/python

获取帮助

Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及对应Dockerfile链接

参见FAQ中的https://github.com/docker-library/faq#whats-the-difference-between-shared-and-simple-tags%E3%80%82

简单标签(Simple Tags)

• https://github.com/docker-library/python/blob/303456576fd52b3e000639d5cfdf384442e730d7/3.15-rc/trixie/Dockerfile
• https://github.com/docker-library/python/blob/303456576fd52b3e000639d5cfdf384442e730d7/3.15-rc/slim-trixie/Dockerfile
• https://github.com/docker-library/python/blob/303456576fd52b3e000639d5cfdf384442e730d7/3.15-rc/bookworm/Dockerfile
• https://github.com/docker-library/python/blob/303456576fd52b3e000639d5cfdf384442e730d7/3.15-rc/slim-bookworm/Dockerfile
• https://github.com/docker-library/python/blob/303456576fd52b3e000639d5cfdf384442e730d7/3.15-rc/alpine3.22/Dockerfile
• https://github.com/docker-library/python/blob/303456576fd52b3e000639d5cfdf384442e730d7/3.15-rc/alpine3.21/Dockerfile
• https://github.com/docker-library/python/blob/a83345bce8e75b407f283511dc3128b2062d8c1e/3.14/trixie/Dockerfile
• https://github.com/docker-library/python/blob/a83345bce8e75b407f283511dc3128b2062d8c1e/3.14/slim-trixie/Dockerfile
• https://github.com/docker-library/python/blob/a83345bce8e75b407f283511dc3128b2062d8c1e/3.14/bookworm/Dockerfile
• https://github.com/docker-library/python/blob/a83345bce8e75b407f283511dc3128b2062d8c1e/3.14/slim-bookworm/Dockerfile
• https://github.com/docker-library/python/blob/a83345bce8e75b407f283511dc3128b2062d8c1e/3.14/alpine3.22/Dockerfile
• https://github.com/docker-library/python/blob/a83345bce8e75b407f283511dc3128b2062d8c1e/3.14/alpine3.21/Dockerfile

共享标签(Shared Tags)

• 3.15.0a1, 3.15-rc:

  • https://github.com/docker-library/python/blob/303456576fd52b3e000639d5cfdf384442e730d7/3.15-rc/trixie/Dockerfile

• 3.14.0, 3.14, 3, latest:

  • https://github.com/docker-library/python/blob/a83345bce8e75b407f283511dc3128b2062d8c1e/3.14/trixie/Dockerfile

• 3.13.9, 3.13:

  • https://github.com/docker-library/python/blob/3f2d7e4c339ab883455b81a873519f1d0f2cd80a/3.13/trixie/Dockerfile

• 3.12.12, 3.12:

  • https://github.com/docker-library/python/blob/e4ab0fe5ef4df797ed09883becf983a56ab97eca/3.12/trixie/Dockerfile

• 3.11.14, 3.11:

  • https://github.com/docker-library/python/blob/54a65f4ff531391810946ee17b0806accbda0fae/3.11/trixie/Dockerfile

• 3.10.19, 3.10:

  • https://github.com/docker-library/python/blob/54a65f4ff531391810946ee17b0806accbda0fae/3.10/trixie/Dockerfile

• 3.9.24, 3.9:

  • https://github.com/docker-library/python/blob/00c4cce6b91488475bfaf85921bae***a56d4a/3.9/trixie/Dockerfile

快速参考

问题反馈渠道

https://github.com/docker-library/python/issues?q=

支持的架构

(https://github.com/docker-library/official-images#architectures-other-than-amd64)
https://hub.docker.com/r/amd64/python/, https://hub.docker.com/r/arm32v5/python/, https://hub.docker.com/r/arm32v6/python/, https://hub.docker.com/r/arm32v7/python/, https://hub.docker.com/r/arm64v8/python/, https://hub.docker.com/r/i386/python/, https://hub.docker.com/r/mips64le/python/, https://hub.docker.com/r/ppc64le/python/, https://hub.docker.com/r/riscv64/python/, https://hub.docker.com/r/s390x/python/, https://hub.docker.com/r/winamd64/python/

镜像工件详情

https://github.com/docker-library/repo-info/blob/master/repos/python (https://github.com/docker-library/repo-info/commits/master/repos/python)
(包含镜像元数据、传输大小等信息)

镜像更新

https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fpython
https://github.com/docker-library/official-images/blob/master/library/python (https://github.com/docker-library/official-images/commits/master/library/python)

文档来源

https://github.com/docker-library/docs/tree/master/python (https://github.com/docker-library/docs/commits/master/python)

核心功能和特性

Python是一种解释型、交互式、面向对象的开源编程语言。它具有以下核心特性：

• 简洁清晰的语法
• 动态类型系统
• 高级动态数据类型
• 支持面向对象编程
• 模块化和异常处理机制
• 可扩展C/C++接口
• 丰富的标准库和第三方库
• 跨平台可移植性

使用场景和适用范围

Python Docker镜像适用于多种场景：

• Python应用程序的容器化部署
• 开发环境标准化
• CI/CD流程集成
• 微服务架构中的Python服务
• 快速原型开发
• 自动化脚本运行环境
• 数据科学和机器学习工作流

详细使用方法和配置说明

创建Dockerfile

在Python应用项目中创建Dockerfile：

dockerfile
FROM amd64/python:3

WORKDIR /usr/src/app

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

COPY . .

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

如需使用Python 2：

dockerfile
FROM amd64/python:2

WORKDIR /usr/src/app

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

COPY . .

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

构建并运行Docker镜像：

console
$ docker build -t my-python-app .
$ docker run -it --rm --name my-running-app my-python-app

运行单个Python脚本

对于简单的单文件项目，可直接使用Python Docker镜像运行脚本：

console
$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp amd64/python:3 python your-daemon-or-script.py

Python 2版本：

console
$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp amd64/python:2 python your-daemon-or-script.py

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  python-app:
    build: .
    image: amd64/python:3.14-slim
    volumes:
      - ./app:/usr/src/app
    working_dir: /usr/src/app
    command: python your-script.py
    environment:
      - PYTHONUNBUFFERED=1
      - PYTHONDONTWRITEBYTECODE=1

运行服务：

console
$ docker-compose up

镜像中的多个Python版本

在非slim变体中，除了镜像提供的/usr/local/bin/python（默认在$PATH中）外，还会有一个（发行版提供的）python可执行文件位于/usr/bin/python（和/或/usr/bin/python3）。这是由于在非slim变体中使用buildpack-deps镜像导致的副作用。

镜像变体

amd64/python镜像有多种变体，适用于不同场景：

amd64/python:<version>（默认版本）

这是默认镜像，适合大多数用户。它基于buildpack-deps，包含大量常用的Debian软件包，减少了衍生镜像需要安装的软件包数量，从而减小整体镜像大小。

标签中包含如bookworm或trixie等名称，这些是Debian的发行版代号，表示镜像基于哪个Debian版本构建。

amd64/python:<version>-slim（精简版本）

此镜像不包含默认标签中的常见Debian软件包，只包含运行amd64/python所需的最小Debian软件包。适用于空间受限的环境。

使用此镜像时，pip install在安装预编译的Python包时可以正常工作，但安装需要编译的源代码包时可能失败。解决方法包括：

• 使用此镜像并在运行pip install前安装所需的Debian软件包
• 使用默认镜像，它包含最常用的Debian软件包

amd64/python:<version>-alpine（轻量级版本）

此镜像基于流行的Alpine Linux项目，镜像大小非常小（约5MB），因此生成的最终镜像也更精简。

该变体适用于对最终镜像大小有严格要求的场景。注意它使用musl libc而非glibc，可能导致某些软件出现兼容性问题。

由于镜像极小，通常不包含额外工具（如git或bash），需要时可在Dockerfile中自行安装。

许可证信息

查看Python 2和Python 3的许可证信息。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能具有其他许可证（如基础发行版中的Bash等，以及主软件的任何直接或间接依赖项）。

在https://github.com/docker-library/repo-info/tree/master/repos/python%E4%B8%AD%E5%8F%AF%E4%BB%A5%E6%89%BE%E5%88%B0%E4%B8%80%E4%BA%9B%E8%83%BD%E5%A4%9F%E8%87%AA%E5%8A%A8%E6%A3%80%E6%B5%8B%E5%88%B0%E7%9A%84%E9%A2%9D%E5%A4%96%E8%AE%B8%E5%8F%AF%E8%AF%81%E4%BF%A1%E6%81%AF%E3%80%82

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用都符合其中包含的所有软件的相关许可证。