stagex/rust

Rust 编程语言工具链 Docker 镜像

镜像概述

本镜像包含 Rust 编程语言的完整工具链，基于官方基础镜像构建，旨在为 Rust 开发提供便捷、一致的环境。镜像整合了 Rust 开发所需的核心组件，支持从代码编写、编译、测试到文档生成的全流程开发工作，无需在本地系统单独配置 Rust 环境。

核心功能与特性

• 完整工具链：包含 rustc 编译器、Cargo 包管理器、Rustup 版本管理工具及 Rust 标准库
• 多版本支持：提供不同 Rust 版本标签（如 latest、stable、beta、nightly），满足不同开发需求
• 开发辅助工具：集成文档生成工具（cargo doc）、代码格式化工具（rustfmt）、静态分析工具（clippy）
• 跨平台能力：支持通过配置实现基础的跨平台编译（需额外安装目标平台组件）
• 轻量与兼容：基于精简基础镜像，同时保持与主流 Linux 发行版的兼容性

使用场景与适用范围

• 本地开发环境：为开发者提供隔离的 Rust 开发环境，避免系统级依赖冲突
• CI/CD 流程：集成到自动化构建 pipeline，用于 Rust 项目的编译、测试和打包
• 临时开发/演示：快速启动临时环境进行代码调试或技术演示
• 教学与培训：标准化的 Rust 学习环境，确保学员环境一致性
• 多版本测试：在同一系统中测试不同 Rust 版本下的代码兼容性

详细使用方法

基本使用

通过以下命令可快速验证镜像及工具链版本：

bash
docker run --rm -it docker.xuanyuan.run/rustlang/rust:latest rustc --version
docker run --rm -it docker.xuanyuan.run/rustlang/rust:latest cargo --version

挂载本地项目目录

将本地 Rust 项目目录挂载到容器中进行开发：

bash
# 进入项目目录
cd /path/to/your/rust/project

# 运行容器并挂载当前目录
docker run --rm -it -v $(pwd):/app -w /app docker.xuanyuan.run/rustlang/rust:latest bash

# 在容器内执行 Cargo 命令
cargo build   # 构建项目
cargo run     # 运行项目
cargo test    # 执行测试
cargo doc     # 生成文档

指定 Rust 版本

通过镜像标签指定所需 Rust 版本（如稳定版、测试版或 nightly 版）：

bash
# 使用稳定版
docker run --rm -it docker.xuanyuan.run/rustlang/rust:stable cargo --version

# 使用测试版
docker run --rm -it docker.xuanyuan.run/rustlang/rust:beta cargo --version

# 使用 nightly 版
docker run --rm -it docker.xuanyuan.run/rustlang/rust:nightly cargo --version

环境变量配置

支持通过环境变量自定义工具链行为：

• RUSTUP_HOME：指定 rustup 数据目录（默认 /usr/local/rustup）
• CARGO_HOME：指定 Cargo 缓存目录（默认 /usr/local/cargo）
• RUSTFLAGS：传递额外的 Rust 编译器标志（如 -C target-cpu=native）

示例：

bash
docker run --rm -it -e RUSTFLAGS="-C opt-level=3" -v $(pwd):/app -w /app docker.xuanyuan.run/rustlang/rust:latest cargo build --release

Docker Compose 配置示例

创建 docker-compose.yml 文件管理开发环境：

yaml
version: '3.8'
services:
  rust-dev:
    image: docker.xuanyuan.run/rustlang/rust:latest
    volumes:
      - ./:/app                # 挂载本地项目目录
      - cargo-cache:/usr/local/cargo  # 持久化 Cargo 缓存
    working_dir: /app
    tty: true
    stdin_open: true
    environment:
      - RUSTFLAGS="-C debuginfo=0"  # 禁用调试信息以减小二进制体积

volumes:
  cargo-cache:  # 持久化卷存储 Cargo 缓存，加速后续构建

启动服务：

bash
docker-compose up -d
docker-compose exec rust-dev bash  # 进入容器环境

高级配置

安装额外目标平台

通过 rustup 安装跨平台编译目标：

bash
# 在容器内执行
rustup target add x86_64-unknown-linux-musl  # 添加 MUSL 目标（静态链接）
rustup target add wasm32-unknown-unknown     # 添加 WebAssembly 目标

自定义工具链组件

安装额外工具链组件（如 clippy、rustfmt）：

bash
# 在容器内执行
rustup component add clippy  # 代码静态分析工具
rustup component add rustfmt # 代码格式化工具

构建自定义镜像

如需添加额外系统依赖，可基于本镜像构建自定义 Dockerfile：

dockerfile
FROM rustlang/rust:latest

# 安装系统依赖（示例：添加 OpenSSL 开发库）
RUN apt-get update && apt-get install -y libssl-dev && rm -rf /var/lib/apt/lists/*

# 设置工作目录
WORKDIR /app

# 预缓存常用 Cargo 依赖（加速后续构建）
COPY Cargo.toml Cargo.lock ./
RUN mkdir src && echo "fn main() {}" > src/main.rs && cargo build && rm -rf src

# 复制项目源代码
COPY . .

# 构建项目
RUN cargo build --release

# 运行入口
CMD ["./target/release/your-app-name"]