rust-static-builder 镜像文档

镜像概述

rust-static-builder 是一个专为Rust项目设计的Docker镜像，旨在简化静态链接Linux可执行文件的构建流程。该镜像预配置了nightly Rust工具链及静态链接所需的依赖环境，帮助开发者快速生成独立、无动态依赖的Linux可执行文件，适用于各种部署场景。

核心功能与特性

• 预安装环境：内置nightly Rust工具链，无需手动配置Rust环境
• 静态链接支持：集成musl libc等系统库，支持Rust项目静态链接构建
• 依赖管理：包含常见静态链接所需的系统依赖（如libssl、zlib等）
• 简化构建：提供标准化构建流程，减少手动配置步骤
• 兼容性：生成的可执行文件可在大多数Linux发行版中运行，无需额外动态库

使用场景

• 独立可执行文件分发：需要向用户提供单一可执行文件的场景
• 服务器部署：在无依赖或受限Linux环境中部署Rust应用
• 容器化应用：构建最小化容器镜像时减少基础镜像体积
• 跨环境一致性：确保不同开发/构建环境下生成一致的可执行文件

使用方法与配置说明

基本使用（docker run）

通过挂载Rust项目目录并执行构建命令使用：

docker run --rm -v "$(pwd)":/project -w /project fornwall/rust-static-builder cargo build --release

构建完成后，静态可执行文件将位于项目的 target/x86_64-unknown-linux-musl/release/ 目录下。

自定义构建命令

可指定额外构建参数或命令：

# 构建并运行测试
docker run --rm -v "$(pwd)":/project -w /project fornwall/rust-static-builder cargo test --release

# 指定目标架构（如适用）
docker run --rm -v "$(pwd)":/project -w /project fornwall/rust-static-builder cargo build --target x86_64-unknown-linux-musl --release

环境变量

docker-compose 示例

创建 docker-compose.yml 文件简化构建流程：

version: '3'
services:
  builder:
    image: fornwall/rust-static-builder
    volumes:
      - ./:/project
    working_dir: /project
    command: cargo build --release

运行构建：

docker-compose run --rm builder

注意事项

• 该镜像使用nightly Rust工具链，可能包含实验性特性，生产环境使用前建议充分测试
• 部分Rust crate可能需要额外配置才能支持静态链接，可通过修改 Cargo.toml 或设置 RUSTFLAGS 解决
• 生成的可执行文件针对Linux x86_64架构，其他架构需确认镜像支持情况

更多信息

完整文档及更新说明请参见项目GitHub仓库：[***]