** 注意：**这是rust官方镜像的i386架构构建版本的"per-architecture"仓库——更多信息，请参见官方镜像文档中的"除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

快速参考（续）

-** 问题提交地址：[*]

-** 支持的架构：**(更多信息)
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 i386/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实例内编译而非运行应用，可执行如下命令：

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

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

镜像变体

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

i386/rust:<version>

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

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

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

i386/rust:<version>-slim

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

许可证

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

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

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

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