jonoh/sccache-rust

rust-sccache 镜像文档

镜像概述

rust-sccache 是一个基于官方 Rust 镜像构建的 Docker 镜像，在保留官方 Rust 环境所有功能的基础上，集成了最新版本的 sccache（编译缓存工具），旨在加速 Rust 项目的编译过程。镜像标签与官方 Rust 镜像保持一致（基于 Rust 版本号），便于用户根据项目所需的 Rust 版本选择对应镜像。

核心功能与特性

基于官方 Rust 镜像

构建自官方 Rust 基础镜像，确保与标准 Rust 开发环境的兼容性，可直接用于 Rust 项目的编译、测试等操作。

集成最新 sccache

自动集成构建时可用的最新版本 sccache，无需手动安装配置，开箱即可利用其编译缓存能力，显著减少重复编译时间。

标签对应 Rust 版本

镜像标签与官方 Rust 镜像版本一致（如 1.70, 1.75-slim 等），清晰对应 Rust 版本号，方便用户根据项目依赖选择合适镜像。

使用场景与适用范围

Rust 项目开发环境

适用于本地开发，通过缓存编译结果加速日常开发中的反复编译操作，提升开发效率。

CI/CD 流程编译环节

可集成到 CI/CD 流程中，在持续集成阶段利用 sccache 缓存跨构建的编译结果，缩短 pipeline 运行时间。

频繁编译的 Rust 应用

针对需要频繁修改并重新编译的 Rust 应用（如库开发、工具调试等），有效减少每次编译耗时。

使用方法与配置说明

基本使用方式

通过 docker run 命令启动容器，挂载项目目录和 sccache 缓存目录：

bash
docker run -it --rm \
  -v /本地项目路径:/app \
  -v /本地缓存路径:/root/.cache/sccache \
  rust-sccache:<rust版本标签> \
  bash -c "cd /app && cargo build"

• -v /本地项目路径:/app: 挂载本地 Rust 项目目录到容器内 /app 目录
• -v /本地缓存路径:/root/.cache/sccache: 挂载本地目录作为 sccache 缓存存储，确保缓存持久化
• <rust版本标签>: 替换为目标 Rust 版本（如 1.75）

sccache 配置（可选）

可通过环境变量自定义 sccache 行为，例如设置缓存大小、后端存储等：

bash
docker run -it --rm \
  -v /本地项目路径:/app \
  -v /本地缓存路径:/root/.cache/sccache \
  -e SCCACHE_MAX_SIZE=10G \  # 设置最大缓存大小
  -e SCCACHE_DIR=/root/.cache/sccache \  # 指定缓存目录（默认值）
  rust-sccache:1.75 \
  bash -c "cd /app && cargo build"

更多配置可参考 https://github.com/mozilla/sccache%E3%80%82

标签说明

镜像标签格式与官方 Rust 镜像一致，主要包含：

• 基础版本：如 1.70, 1.75（对应稳定版 Rust 版本）
• 变体标签：如 1.75-slim（基于 slim 版本基础镜像）、1.75-alpine（轻量 Alpine 版本）

可通过镜像仓库（如 Docker Hub）查询所有可用标签，选择时需匹配项目依赖的 Rust 版本及基础镜像类型。