注意：这是python官方镜像的windows-amd64架构构建的“按架构”仓库——更多信息，请参见官方镜像文档中的“非amd64架构？”和官方镜像FAQ中的“Git中的镜像源已更改，该怎么办？”。

快速参考

• 维护者：
  Docker社区

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及对应的Dockerfile链接

（参见FAQ中的“‘Shared’和‘Simple’标签有什么区别？”）

Simple Tags

• 3.15.0a1-windowsservercore-ltsc2025, 3.15-rc-windowsservercore-ltsc2025

• 3.15.0a1-windowsservercore-ltsc2022, 3.15-rc-windowsservercore-ltsc2022

• 3.14.0-windowsservercore-ltsc2025, 3.14-windowsservercore-ltsc2025, 3-windowsservercore-ltsc2025, windowsservercore-ltsc2025

• 3.14.0-windowsservercore-ltsc2022, 3.14-windowsservercore-ltsc2022, 3-windowsservercore-ltsc2022, windowsservercore-ltsc2022

• 3.13.9-windowsservercore-ltsc2025, 3.13-windowsservercore-ltsc2025

• 3.13.9-windowsservercore-ltsc2022, 3.13-windowsservercore-ltsc2022

Shared Tags

• 3.15.0a1, 3.15-rc:

  • 3.15.0a1-windowsservercore-ltsc2025
  • 3.15.0a1-windowsservercore-ltsc2022

• 3.15.0a1-windowsservercore, 3.15-rc-windowsservercore:

  • 3.15.0a1-windowsservercore-ltsc2025
  • 3.15.0a1-windowsservercore-ltsc2022

• 3.14.0, 3.14, 3, latest:

  • 3.14.0-windowsservercore-ltsc2025
  • 3.14.0-windowsservercore-ltsc2022

• 3.14.0-windowsservercore, 3.14-windowsservercore, 3-windowsservercore, windowsservercore:

  • 3.14.0-windowsservercore-ltsc2025
  • 3.14.0-windowsservercore-ltsc2022

• 3.13.9, 3.13:

  • 3.13.9-windowsservercore-ltsc2025
  • 3.13.9-windowsservercore-ltsc2022

• 3.13.9-windowsservercore, 3.13-windowsservercore:

  • 3.13.9-windowsservercore-ltsc2025
  • 3.13.9-windowsservercore-ltsc2022

快速参考（续）

• 问题反馈地址：
  [***]

• 支持的架构：(更多信息)
  amd64, arm32v5, arm32v6, arm32v7, arm64v8, i386, mips64le, ppc64le, riscv64, s390x, windows-amd64

• 镜像 artifact 详情：
  repo-info 仓库的 repos/python/ 目录 (历史记录)
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/python 标签
  official-images 仓库的 library/python 文件 (历史记录)

• 本文档来源：
  docs 仓库的 python/ 目录 (历史记录)

什么是 Python？

Python是一种解释型、交互式、面向对象的开源编程语言。它集成了模块、异常处理、动态类型、非常高级的动态数据类型和类。Python将强大的功能与清晰的语法相结合。它具有许多系统调用和库的接口，以及各种窗口系统的接口，并且可以用C或C++扩展。它也可用作需要可编程接口的应用程序的扩展语言。最后，Python是可移植的：它可以在许多Unix变体、Mac以及Windows 2000及更高版本上运行。

***.org/wiki/Python_(programming_language)

!logo

如何使用本镜像

在 Python 应用项目中创建 Dockerfile

FROM winamd64/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）：

FROM winamd64/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 镜像：

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

运行单个 Python 脚本

对于许多简单的单文件项目，编写完整的 Dockerfile 可能不方便。在这种情况下，可以直接使用 Python Docker 镜像运行 Python 脚本：

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

或者（同样，如果需要使用 Python 2）：

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

镜像中的多个 Python 版本

在非 slim 变体中，除了镜像提供的 /usr/local/bin/python（默认在 $PATH 中）外，还会有一个额外的（发行版提供的）python 可执行文件位于 /usr/bin/python（和/或 /usr/bin/python3）。这是在非 slim 变体中使用 buildpack-deps 镜像的一个意外副作用（许多发行版提供的工具是基于该 Python 版本编写的，若替换可能导致工具失效，因此无法安全地删除/覆盖它）。

镜像变体

winamd64/python 镜像有多种版本，每种版本设计用于特定场景。

winamd64/python:<version>

这是默认镜像。如果不确定需求，建议使用此版本。它既可以用作临时容器（挂载源代码并启动容器以运行应用），也可以作为构建其他镜像的基础。

此标签基于 buildpack-deps。buildpack-deps 专为拥有多个镜像的普通 Docker 用户设计，它包含大量非常常见的 Debian 软件包，减少了衍生镜像需要安装的软件包数量，从而减小系统中所有镜像的总体大小。

winamd64/python:<version>-windowsservercore

此镜像基于 Windows Server Core (mcr.microsoft.com/windows/servercore)。因此，它仅在支持该基础镜像的环境中工作，例如 Windows 10 专业版/企业版（周年更新）或 Windows Server 2016。

有关如何在 Windows 上运行 Docker 的信息，请参见 Microsoft 提供的相关“快速入门”指南：

• Windows 容器快速入门

许可证

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

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

部分能够自动检测到的额外许可证信息可能位于 repo-info 仓库的 python/ 目录中。

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