快速参考

• 维护者：FPC Docker团队
• 获取帮助：FPC社区论坛、Docker社区论坛 或 Stack Overflow

支持的标签及对应Dockerfile链接

• 主干开发版本
  • trunk-bookworm-full, nightly-bookworm-full
  • trunk-jammy-full, nightly-jammy-full
  • trunk-full, nightly-full
• Beta版本
  • beta-bookworm-full
  • beta-jammy-full
  • beta-full
• 稳定版本
  • 3.2.2-bookworm-full
  • 3.2.2-bullseye-full
  • 3.2.2-buster-full, latest-buster-full
  • 3.2.2-noble-full
  • 3.2.2-jammy-full
  • 3.2.2-focal-full, latest-focal-full
  • 3.2.2-alpine-3.19-full
  • 3.2.2-alpine-3.19-slim
  • 3.2.2-alpine-3.19-minimal
  • 3.2.2-full, latest-full
  • 3.2.2-slim, latest-slim
  • 3.2.2-minimal, latest-minimal
  • 3.2.0-focal-full
  • 3.2.0-full
  • 3.2.0-slim
  • 3.2.0-minimal

后续计划（需要帮助！）

• 3.2.x-x86_64-to-armv7（交叉编译二进制文件、RTL+所有包、示例和文档）
• 3.2.x-x86_64-to-arm64v8（交叉编译二进制文件、RTL+所有包、示例和文档）
• 3.2.x-x86_64-to-win64（交叉编译二进制文件、RTL+所有包、示例和文档）
• ...
• pas2js（Pascal到JavaScript转换器的二进制文件和包）

快速参考（续）

• 问题提交地址：[***]
• 支持的架构：(更多信息) amd64、arm32v7、arm64v8、i386
• 本描述来源：文档仓库目录 (历史记录)

什么是Free Pascal Compiler？

Free Pascal是一款成熟、多功能的开源Pascal编译器。它支持多种处理器架构：Intel x86（16位和32位）、AMD64/x86-64、PowerPC、PowerPC64、SPARC、SPARC64、ARM、AArch64、MIPS、Motorola 68k、AVR和JVM。支持的操作系统包括Windows（16/32/64位、CE和原生NT）、Linux、Mac OS X/iOS/iPhoneSimulator/Darwin、FreeBSD和其他BSD变体、DOS（16位或32位DPMI）、OS/2、AIX、Android、Haiku、Nintendo GBA/DS/Wii、AmigaOS、MorphOS、AROS、Atari TOS以及各种嵌入式平台。此外，开发版本还支持RISC-V（32/64位）、Xtensa和Z80架构，以及LLVM编译器基础设施。

!alt text

如何使用此镜像

启动运行应用的FPC实例

使用此镜像最直接的方式是将容器同时作为构建和运行时环境。在Dockerfile中，以下内容将编译并运行项目：

docker
FROM freepascal/fpc:3.2.2-focal-full

WORKDIR /usr/src/myapp
COPY . .

RUN fpc myapp.pas

CMD ["myapp"]

然后，构建并运行Docker镜像：

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

这将创建一个包含所有FPC工具的镜像。如果只需要编译后的应用：

docker
FROM freepascal/fpc:3.2.2-focal-full as builder
WORKDIR /usr/src/myapp
COPY . .
RUN fpc myapp.pas

FROM ubuntu:focal
RUN apt-get update && apt-get upgrade && rm -rf /var/lib/apt/lists/*
COPY --from=builder /usr/src/myapp/myapp /usr/local/bin/myapp
CMD ["myapp"]

此方法将创建仅包含程序可执行文件的镜像。如果切换到基于Alpine的FPC镜像，可能可以节省空间。
有关更多信息，请参见多阶段构建。

在Docker容器内编译应用

有时可能不适合在容器内运行应用。要在Docker实例内编译而非运行应用，可以使用以下命令：

console
$ docker run --rm --user "$(id -u)":"$(id -g)" -v "$PWD":/usr/src/myapp -w /usr/src/myapp freepascal/fpc:3.2.2-focal-full fpc -MDelphi myapp.lpr

这会将当前目录作为卷添加到容器，将工作目录设置为该卷，并运行命令fpc -MDelphi myapp.lpr。此命令指示FPC编译项目myapp以输出可执行文件。

镜像变体

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

Debian

Debian是一种Linux操作系统，是个人计算机和网络服务器最流行的Linux发行版之一，已被用作其他多个Linux发行版的基础。

<version>-<debian>-full

此镜像包含完整本地安装中的所有内容，包括文档和示例。

Ubuntu

Ubuntu是基于Debian的Linux操作系统，可从桌面运行到云端。它是公共云和OpenStack云中最受欢迎的操作系统，也是容器的首选平台；从Docker到Kubernetes再到LXD，Ubuntu都能大规模运行容器。快速、安全且简单，Ubuntu为全球数百万台PC提供支持。

<version>-<ubuntu>-full

此镜像包含完整本地安装中的所有内容，包括文档和示例。

Alpine Linux

这些镜像基于流行的Alpine Linux项目，可在alpine***镜像中获取。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常能生成更精简的镜像。

当最终镜像大小尽可能小是首要考虑因素时，此变体非常有用。主要注意事项是它使用musl libc而非glibc等，因此软件可能会根据其libc要求/假设的深度而遇到问题。有关可能出现的问题以及使用基于Alpine的镜像的优缺点比较，请参见此Hacker News评论线程。

为最小化镜像大小，基于Alpine的镜像通常不包含其他相关工具（如git或bash）。以此镜像为基础，可在自己的Dockerfile中添加所需工具（如果不熟悉如何安装包，请参见alpine镜像描述中的示例）。

<version>-full

此镜像包含使用***安装程序包正常安装FPC时的所有内容，但不包含示例和文档。

<version>-slim

此镜像通过移除大多数包并仅保留核心包（完整RTL）和所有二进制文件，进一步减小了大小。

<version>-minimal

此镜像包含所有二进制文件、最小RTL，可能仅用于编译新编译器和相应测试。

注意：镜像名称可能还包含Alpine Linux版本，格式为“<version>-alpine-<alpine_version>-(full|slim|minimal)”，表示它使用与Dockerfile中指定版本不同的Alpine版本。

Beta

这些镜像提供对FPC最新beta（修复）版本的便捷访问，即下一个稳定版本。它有Alpine Linux、Debian和Ubuntu版本，且预装了所有内容。

Trunk/Nightly

这些镜像提供对FPC最新开发（trunk）版本的便捷访问，该版本定期从FPC仓库的HEAD构建。它有Alpine Linux、Debian和Ubuntu版本，且预装了所有内容。

许可证

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

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

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