注意：这是rust镜像的arm64v8架构专用仓库——更多信息请参见镜像文档中的“除amd64外的架构？”和***镜像FAQ中的“镜像源在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

• 1-alpine3.20, 1.90-alpine3.20, 1.90.0-alpine3.20, alpine3.20

• 1-alpine3.21, 1.90-alpine3.21, 1.90.0-alpine3.21, alpine3.21

• 1-alpine3.22, 1.90-alpine3.22, 1.90.0-alpine3.22, alpine3.22, 1-alpine, 1.90-alpine, 1.90.0-alpine, alpine

快速参考（续）

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

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

• 镜像 artifact 详情：
  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中，编写如下内容可编译并运行项目：

dockerfile
FROM arm64v8/rust:1.67

WORKDIR /usr/src/myapp
COPY . .

RUN cargo install --path .

CMD ["myapp"]

然后构建并运行Docker镜像：

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

此方式创建的镜像包含所有Rust工具，大小约为1.8GB。若只需编译后的应用，可使用多阶段构建：

dockerfile
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容器内编译应用

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

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

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

镜像变体

arm64v8/rust镜像有多种变体，适用于不同场景。

arm64v8/rust:<version>

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

部分标签包含bookworm、bullseye或trixie等名称，这些是Debian的版本代号，指示镜像基于哪个Debian版本。若需安装额外包，建议显式指定这些代号以减少Debian版本更新带来的影响。

此标签基于buildpack-deps，包含大量常用Debian包，可减少衍生镜像的安装需求，从而减小整体镜像体积。

arm64v8/rust:<version>-slim

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

arm64v8/rust:<version>-alpine

此镜像基于流行的Alpine Linux项目（即alpine***镜像）。Alpine Linux比大多数基础镜像小得多（约5MB），因此生成的镜像更精简。

此变体适用于对最终镜像大小有严格要求的场景。需注意它使用musl libc而非glibc及相关库，软件可能因libc依赖而出现问题。更多讨论参见Hacker News评论线程。

为最小化镜像大小，Alpine-based镜像通常不含git或bash等额外工具。如需安装，可参考alpine镜像说明中的包安装示例。

许可证

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

与所有Docker镜像一样，此镜像可能包含其他软件，可能受其他许可证约束（如基础发行版中的Bash等，以及主要软件的直接或间接依赖）。

部分自动检测到的额外许可证信息可在repo-info仓库的rust/目录中找到。

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