注意：这是 官方 rust 镜像 的 arm32v7 架构专用仓库。有关更多信息，请参见官方镜像文档中的“非 amd64 架构？”以及官方镜像常见问题中的“Git 中镜像源已更改，该怎么办？”。

快速参考

• 维护者： Rust 项目开发者

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

支持的标签及对应 Dockerfile 链接

• 1-bullseye, 1.90-bullseye, 1.90.0-bullseye, bullseye

• 1-slim-bullseye, 1.90-slim-bullseye, 1.90.0-slim-bullseye, slim-bullseye

• 1-bookworm, 1.90-bookworm, 1.90.0-bookworm, bookworm

• 1-slim-bookworm, 1.90-slim-bookworm, 1.90.0-slim-bookworm, slim-bookworm

• 1-trixie, 1.90-trixie, 1.90.0-trixie, trixie, 1, 1.90, 1.90.0, latest

• 1-slim-trixie, 1.90-slim-trixie, 1.90.0-slim-trixie, slim-trixie, 1-slim, 1.90-slim, 1.90.0-slim, slim

快速参考（续）

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

• 支持的架构：(更多信息) amd64、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x

• 镜像制品详情： repo-info 仓库的 repos/rust/ 目录（历史记录） （包含镜像元数据、传输大小等）

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

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

什么是 Rust？

Rust 是由 Mozilla Research 赞助的系统编程语言。它旨在成为一种“安全、并发、实用的语言”，支持函数式和命令式-过程式范式。Rust 在语法上类似于 C++，但设计用于在保持性能的同时提供更好的内存安全。

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

!logo

如何使用此镜像

启动运行应用的 Rust 实例

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

FROM arm32v7/rust:1.67

WORKDIR /usr/src/myapp
COPY . .

RUN cargo install --path .

CMD ["myapp"]

然后构建并运行 Docker 镜像：

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

这将创建一个包含所有 Rust 工具的镜像，大小为 1.8GB。如果只需要编译后的应用，可使用多阶段构建：

FROM rust:1.67 as builder
WORKDIR /usr/src/myapp
COPY . .
RUN cargo install --path .

FROM debian:bullseye-slim
RUN apt-get update && apt-get install -y extra-runtime-dependencies && rm -rf /var/lib/apt/lists/*
COPY --from=builder /usr/local/cargo/bin/myapp /usr/local/bin/myapp
CMD ["myapp"]

注意：可能需要安装额外的共享库，如上述 extra-runtime-dependencies 行所示。这种方式创建的镜像大小不到 200MB，若使用 Alpine 基础的 Rust 镜像，可再减少约 60MB。更多信息参见 [***]

在 Docker 容器内编译应用

有时可能不需要在容器内运行应用，仅需编译。可执行如下命令：

$ docker run --rm --user "$(id -u)":"$(id -g)" -v "$PWD":/usr/src/myapp -w /usr/src/myapp arm32v7/rust:1.23.0 cargo build --release

该命令将当前目录挂载为容器卷，设置工作目录为该卷，并运行 cargo build --release。Cargo 会编译 myapp crate，并将可执行文件输出到 target/release/myapp。

镜像变体

arm32v7/rust 镜像有多种版本，适用于不同场景。

arm32v7/rust:<version>

默认镜像，适合大多数场景。既可作为临时容器（挂载源码并启动容器运行应用），也可作为构建其他镜像的基础。标签中可能包含 bookworm、bullseye 或 trixie 等名称，这些是 Debian 的发行版代号，指示镜像基于哪个 Debian 版本。若需安装额外包，建议显式指定这些代号以减少 Debian 版本更新带来的中断。该镜像基于 buildpack-deps，包含大量常见 Debian 包，可减少衍生镜像的安装需求，降低整体镜像大小。

arm32v7/rust:<version>-slim

精简版镜像，不含默认标签中的常见包，仅包含运行 arm32v7/rust 所需的最小依赖。除非在空间受限且仅部署该镜像的环境中，否则建议使用默认镜像。

许可

查看此镜像中包含软件的 许可信息。与所有 Docker 镜像一样，可能包含其他软件，这些软件可能采用其他许可（如基础发行版中的 Bash 等）。部分自动检测的许可信息位于 repo-info 仓库的 rust/ 目录。镜像用户需确保对该镜像的使用符合所有包含软件的相关许可。