注意：这是pypy官方镜像的arm64v8架构构建的"每架构"仓库——更多信息，请参见官方镜像文档中的"除amd64之外的架构？"和官方镜像FAQ中的"Git中的镜像源已更改，现在该怎么办？"。

快速参考

• 维护者：
  Docker社区

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

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

（参见FAQ中的"'Shared'和'Simple'标签有什么区别？"）

简单标签

• 3.11-7.3.20-trixie, 3.11-7.3-trixie, 3.11-7-trixie, 3.11-trixie, 3-7.3.20-trixie, 3-7.3-trixie, 3-7-trixie, 3-trixie, trixie

• 3.11-7.3.20-slim, 3.11-7.3-slim, 3.11-7-slim, 3.11-slim, 3-7.3.20-slim, 3-7.3-slim, 3-7-slim, 3-slim, slim, 3.11-7.3.20-slim-trixie, 3.11-7.3-slim-trixie, 3.11-7-slim-trixie, 3.11-slim-trixie, 3-7.3.20-slim-trixie, 3-7.3-slim-trixie, 3-7-slim-trixie, 3-slim-trixie, slim-trixie

• 3.11-7.3.20-bookworm, 3.11-7.3-bookworm, 3.11-7-bookworm, 3.11-bookworm, 3-7.3.20-bookworm, 3-7.3-bookworm, 3-7-bookworm, 3-bookworm, bookworm

• 3.11-7.3.20-slim-bookworm, 3.11-7.3-slim-bookworm, 3.11-7-slim-bookworm, 3.11-slim-bookworm, 3-7.3.20-slim-bookworm, 3-7.3-slim-bookworm, 3-7-slim-bookworm, 3-slim-bookworm, slim-bookworm

• 2.7-7.3.20-trixie, 2.7-7.3-trixie, 2.7-7-trixie, 2.7-trixie, 2-7.3.20-trixie, 2-7.3-trixie, 2-7-trixie, 2-trixie

• 2.7-7.3.20-slim, 2.7-7.3-slim, 2.7-7-slim, 2.7-slim, 2-7.3.20-slim, 2-7.3-slim, 2-7-slim, 2-slim, 2.7-7.3.20-slim-trixie, 2.7-7.3-slim-trixie, 2.7-7-slim-trixie, 2.7-slim-trixie, 2-7.3.20-slim-trixie, 2-7.3-slim-trixie, 2-7-slim-trixie, 2-slim-trixie

• 2.7-7.3.20-bookworm, 2.7-7.3-bookworm, 2.7-7-bookworm, 2.7-bookworm, 2-7.3.20-bookworm, 2-7.3-bookworm, 2-7-bookworm, 2-bookworm

• 2.7-7.3.20-slim-bookworm, 2.7-7.3-slim-bookworm, 2.7-7-slim-bookworm, 2.7-slim-bookworm, 2-7.3.20-slim-bookworm, 2-7.3-slim-bookworm, 2-7-slim-bookworm, 2-slim-bookworm

共享标签

• 3.11-7.3.20, 3.11-7.3, 3.11-7, 3.11, 3-7.3.20, 3-7.3, 3-7, 3, latest:

  • 3.11-7.3.20-trixie

• 2.7-7.3.20, 2.7-7.3, 2.7-7, 2.7, 2-7.3.20, 2-7.3, 2-7, 2:

  • 2.7-7.3.20-trixie

快速参考（续）

• 提交issue的途径：
  [***]

• 支持的架构：(更多信息)
  amd64, arm64v8, i386, windows-amd64

• 已发布镜像的详细信息：
  repo-info仓库的repos/pypy/目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images仓库的library/pypy标签
  official-images仓库的library/pypy文件（历史记录）

• 本描述的来源：
  docs仓库的pypy/目录（历史记录）

什么是PyPy？

PyPy是一个Python解释器和即时编译器。PyPy专注于速度、效率以及与原始CPython解释器的兼容性。

PyPy最初是一个用Python语言本身编写的Python解释器。当前的PyPy版本从RPython翻译为C代码并进行编译。PyPy即时编译器（JIT）能够在运行时将Python代码转换为机器码。

***.org/wiki/PyPy

!logo

如何使用本镜像

在Python应用项目中创建Dockerfile

FROM arm64v8/pypy:3

WORKDIR /usr/src/app

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

COPY . .

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

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

FROM arm64v8/pypy:2

WORKDIR /usr/src/app

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

COPY . .

CMD [ "pypy", "./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 arm64v8/pypy:3 pypy3 your-daemon-or-script.py

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

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

镜像变体

arm64v8/pypy镜像有多种版本，每种版本针对特定用例设计。

arm64v8/pypy:<version>

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

这些标签中可能包含bookworm或trixie等名称，这些是Debian的发行版代号，表示镜像基于哪个Debian版本构建。如果镜像需要安装除自带包之外的其他包，建议显式指定这些代号，以减少Debian新版本发布时可能出现的问题。

此标签基于buildpack-deps。buildpack-deps面向普通Docker用户，包含大量极常见的Debian包，减少了派生镜像需要安装的包数量，从而减小系统中所有镜像的总体大小。

arm64v8/pypy:<version>-slim

此镜像不包含默认标签中的常见包，仅包含运行arm64v8/pypy所需的最小包。除非在仅部署arm64v8/pypy镜像且有空间限制的环境中，否则强烈建议使用本仓库的默认镜像。

许可证

查看许可证信息了解本镜像中包含的软件的许可证。

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

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

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