Rust Docker 镜像文档

概述与主要用途

本镜像为 amd64 架构的 Rust 官方 Docker 镜像 的特定架构仓库，用于提供 Rust 编程语言的开发、构建与运行环境。Rust 是由 Mozilla Research 赞助的系统编程语言，专注于安全性、并发性和实用性，语法类似 C++，在保证内存安全的同时维持高性能。

注意：如需其他架构支持（如 arm64v8、i386 等），请参考 官方镜像文档中的“非 amd64 架构”说明。

核心功能与特性

• 多版本支持：包含 Rust 稳定版（如 1.90.0）及对应 Debian/Alpine 基础系统版本（如 bullseye、bookworm、trixie、alpine3.22 等）。
• 镜像变体：提供三种变体以满足不同场景需求：默认（含完整依赖）、slim（最小化依赖）、alpine（基于 Alpine Linux，体积更小）。
• 工具链完整：内置 Rust 编译器（rustc）、包管理器（cargo）及相关开发工具，开箱即可用于 Rust 项目构建。
• 多阶段构建支持：支持通过多阶段构建分离编译环境与运行环境，显著减小最终镜像体积（可从 1.8GB 缩减至 200MB 以下）。
• 跨架构兼容：除 amd64 外，还支持 arm32v7、arm64v8、i386、ppc64le、riscv64、s390x 等架构（需使用对应架构标签镜像）。

支持的标签

以下为 amd64 架构支持的主要标签及对应基础系统（完整标签列表可参考 官方仓库）：

使用场景与适用范围

• 开发环境：快速搭建隔离的 Rust 开发环境，避免本地依赖冲突。
• 生产构建：通过多阶段构建生成轻量级运行镜像，适用于容器化部署。
• CI/CD 流程：作为自动化流水线的编译环境，确保构建一致性。
• 临时编译：在无本地 Rust 环境的机器上，通过容器临时编译项目。

使用方法与配置说明

1. 通过 Dockerfile 构建应用

1.1 单阶段构建（含完整工具链）

适用于开发环境或需要直接在容器内运行的场景，镜像体积较大（约 1.8GB）：

FROM amd64/rust:1.90

WORKDIR /usr/src/myapp
COPY . .

# 编译并安装应用
RUN cargo install --path .

CMD ["myapp"]

构建并运行：

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

1.2 多阶段构建（轻量级运行镜像）

通过多阶段构建分离编译与运行环境，最终镜像体积可缩减至 200MB 以下：

# 阶段 1：编译阶段（使用完整 Rust 工具链）
FROM rust:1.90 as builder
WORKDIR /usr/src/myapp
COPY . .
RUN cargo install --path .

# 阶段 2：运行阶段（使用最小化基础镜像）
FROM debian:bullseye-slim
# 安装运行时依赖（根据应用需求调整）
RUN apt-get update && apt-get install -y libssl-dev && rm -rf /var/lib/apt/lists/*
# 从编译阶段复制可执行文件
COPY --from=builder /usr/local/cargo/bin/myapp /usr/local/bin/myapp

CMD ["myapp"]

说明：若使用 Alpine 基础镜像（如 alpine:3.22），需注意应用可能依赖 musl libc，部分 C 库需重新编译适配。

2. 在容器内编译应用（不运行）

适用于仅需编译项目而无需在容器内运行的场景（如本地无 Rust 环境时）：

docker run --rm \
  --user "$(id -u):$(id -g)" \  # 使用当前用户权限，避免文件权限问题
  -v "$PWD":/usr/src/myapp \     # 挂载本地项目目录到容器
  -w /usr/src/myapp \            # 设置工作目录为项目目录
  amd64/rust:1.90 \              # 指定 Rust 镜像及版本
  cargo build --release          # 执行编译命令（生成 target/release/myapp）

编译产物将输出至本地项目的 target/release/ 目录。

镜像变体详解

默认变体（amd64/rust:<version>）

• 基础系统：基于 Debian（如 trixie、bookworm）的 buildpack-deps 镜像，包含大量常用 Debian 包。
• 特点：内置完整 Rust 工具链及丰富依赖，无需额外安装基础库，适合开发环境或依赖复杂的项目。
• 体积：约 1.8GB。

Slim 变体（amd64/rust:<version>-slim）

• 基础系统：基于 Debian Slim 镜像，仅包含运行 Rust 所需的最小依赖。
• 特点：体积小于默认变体，适合对镜像大小有要求且依赖较少的场景。
• 体积：约 500-800MB。

Alpine 变体（amd64/rust:<version>-alpine）

• 基础系统：基于 Alpine Linux（轻量级 Linux 发行版）。
• 特点：体积最小（约 300-500MB），使用 musl libc 替代 glibc，需注意部分依赖（如 openssl）可能需要适配 musl。
• 适用场景：对镜像大小敏感且无复杂 glibc 依赖的项目。

支持与反馈

• 维护者：Rust Project 开发者
• 获取帮助：Docker 社区 Slack、Server Fault、Stack Overflow
• 提交 Issue：GitHub 仓库
• 镜像元数据：repo-info 仓库（包含镜像大小、更新历史等）

许可信息

• Rust 软件许可信息参见 官方文档。
• 镜像包含的其他软件（如 Debian 基础包、Bash 等）可能具有独立许可，用户需自行确保使用合规性。
• 更多许可详情可参考 repo-info 仓库的 rust 目录。