rust-musl-cross

🚀 欢迎通过https://github.com/***/messense%E6%94%AF%E6%8C%81%E6%88%91%E6%88%90%E4%B8%BA%E5%85%A8%E8%81%8C%E5%BC%80%E6%BA%90%E5%BC%80%E5%8F%91%E8%80%85

用于使用https://github.com/richfelker/musl-cross-make编译静态Rust二进制文件的Docker镜像，灵感来源于https://github.com/emk/rust-musl-builder

预构建镜像

目前我们在https://hub.docker.com/r/messense/rust-musl-cross/%EF%BC%8C%E6%94%AF%E6%8C%81x86_64(amd64)%E5%92%8Caarch64(arm64)%E6%9E%B6%E6%9E%84%E3%80%82

例如，要使用armv7-unknown-linux-musleabihf目标，首先拉取镜像：

docker pull ghcr.io/rust-cross/rust-musl-cross:armv7-musleabihf
# 也可在Docker Hub获取
# docker pull messense/rust-musl-cross:armv7-musleabihf

然后可以执行：

alias rust-musl-builder='docker run --rm -it -v "$(pwd)":/home/rust/src ghcr.io/rust-cross/rust-musl-cross:armv7-musleabihf'
rust-musl-builder cargo build --release

此命令假设$(pwd)是可读写的。它将在armv7-unknown-linux-musleabihf目录中输出二进制文件。目前，它不会尝试在构建之间缓存库，因此最适合用于制作最终发布版本。

Docker约定别名标签

部分镜像还以符合Docker约定的标签名称发布，这些标签与Docker的TARGETARCH构建参数（例如amd64、arm64）匹配。别名标签格式为<TARGETARCH>-musl：

这使得多平台Dockerfile可以直接使用TARGETARCH，无需任何显式构建参数：

ARG TARGETARCH=amd64
FROM ghcr.io/rust-cross/rust-musl-cross:${TARGETARCH}-musl AS builder

Docker会根据原生运行平台自动设置TARGETARCH，因此相同的docker buildx build --platform linux/amd64,linux/arm64命令会在每个平台上选择正确的镜像，无需额外配置。

[!NOTE] arm变体（arm-musleabi、arm-musleabihf、armv7-musleabi、armv7-musleabihf、armv5te-musleabi）没有别名，因为它们都映射到GOARCH=arm，导致单一规范的arm-musl别名存在歧义。

工作原理

rust-musl-cross借助https://github.com/richfelker/musl-cross-make，使用musl-libc、musl-gcc简化编译过程，并支持新版rustup的target功能。

使用beta/nightly Rust

我们默认安装stable Rust，若需切换到beta/nightly Rust，可基于我们的Docker镜像扩展，例如为目标x86_64-unknown-linux-musl使用beta Rust：

FROM ghcr.io/rust-cross/rust-musl-cross:x86_64-musl
RUN rustup update beta && \
rustup target add --toolchain beta x86_64-unknown-linux-musl

剥离二进制文件

可在镜像内使用musl-strip命令剥离二进制文件，例如：

docker run --rm -it -v "$(pwd)":/home/rust/src ghcr.io/rust-cross/rust-musl-cross:armv7-musleabihf musl-strip /home/rust/src/target/release/example

许可证

基于MIT许可证授权