arm64v8/rust

注意：这是https://hub.docker.com/_/rust%E7%9A%84%60arm64v8%60%E6%9E%B6%E6%9E%84%E4%B8%93%E7%94%A8%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%E3%80%82

快速参考

• 维护者：
  https://github.com/rust-lang/docker-rust

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

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

• https://github.com/rust-lang/docker-rust/blob/3aad80112be66bf796c202713029d7ba93dff7fa/stable/bullseye/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/3aad80112be66bf796c202713029d7ba93dff7fa/stable/bullseye/slim/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/3aad80112be66bf796c202713029d7ba93dff7fa/stable/bookworm/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/3aad80112be66bf796c202713029d7ba93dff7fa/stable/bookworm/slim/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/3aad80112be66bf796c202713029d7ba93dff7fa/stable/trixie/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/3aad80112be66bf796c202713029d7ba93dff7fa/stable/trixie/slim/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/3aad80112be66bf796c202713029d7ba93dff7fa/stable/alpine3.20/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/3aad80112be66bf796c202713029d7ba93dff7fa/stable/alpine3.21/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/3aad80112be66bf796c202713029d7ba93dff7fa/stable/alpine3.22/Dockerfile

快速参考（续）

• 问题反馈地址：
  https://github.com/rust-lang/docker-rust/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/rust/%E3%80%81https://hub.docker.com/r/arm32v7/rust/%E3%80%81https://hub.docker.com/r/arm64v8/rust/%E3%80%81https://hub.docker.com/r/i386/rust/%E3%80%81https://hub.docker.com/r/ppc64le/rust/%E3%80%81https://hub.docker.com/r/riscv64/rust/%E3%80%81https://hub.docker.com/r/s390x/rust/

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/rust%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/rust%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Frust
  https://github.com/docker-library/official-images/blob/master/library/rust%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/rust%EF%BC%89

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/rust%EF%BC%88https://github.com/docker-library/docs/commits/master/rust%EF%BC%89

什么是Rust？

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

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

!https://raw.githubusercontent.com/docker-library/docs/a11c341c57de07fbccfed7b21ea92d4bc40130a2/rust/logo.png

如何使用此镜像

启动运行应用的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版本更新带来的影响。

此标签基于https://hub.docker.com/_/buildpack-deps/%EF%BC%8C%E5%8C%85%E5%90%AB%E5%A4%A7%E9%87%8F%E5%B8%B8%E7%94%A8Debian%E5%8C%85%EF%BC%8C%E5%8F%AF%E5%87%8F%E5%B0%91%E8%A1%8D%E7%94%9F%E9%95%9C%E5%83%8F%E7%9A%84%E5%AE%89%E8%A3%85%E9%9C%80%E6%B1%82%EF%BC%8C%E4%BB%8E%E8%80%8C%E5%87%8F%E5%B0%8F%E6%95%B4%E4%BD%93%E9%95%9C%E5%83%8F%E4%BD%93%E7%A7%AF%E3%80%82

arm64v8/rust:<version>-slim

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

arm64v8/rust:<version>-alpine

此镜像基于流行的Alpine Linux项目（即https://hub.docker.com/_/alpine%EF%BC%89%E3%80%82Alpine Linux比大多数基础镜像小得多（约5MB），因此生成的镜像更精简。

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

为最小化镜像大小，Alpine-based镜像通常不含git或bash等额外工具。如需安装，可参考https://hub.docker.com/_/alpine/%E4%B8%AD%E7%9A%84%E5%8C%85%E5%AE%89%E8%A3%85%E7%A4%BA%E4%BE%8B%E3%80%82

许可证

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

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

部分自动检测到的额外许可证信息可在https://github.com/docker-library/repo-info/tree/master/repos/rust%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82

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