nasqueron/rust-musl-builder

rust-musl-builder：用于轻松构建静态Rust二进制文件的Docker容器

本仓库是https://github.com/emk/rust-musl-builder镜像的分叉版本，依赖已更新至2022年12月。

镜像概述

该镜像允许你使用diesel、sqlx或openssl构建静态Rust二进制文件。这些文件可作为无依赖的单一可执行文件分发，适用于任何现代Linux系统。

核心功能

• 基于musl-libc、musl-gcc和rustup target支持构建静态Rust二进制
• 内置静态库：musl-libc、OpenSSL、libpq、libz、SQLite3
• 支持armv7架构基础编译
• 集成实用工具：mdbook（Markdown文档生成）、cargo about（依赖许可证收集）、cargo deb（Debian包构建）、cargo deny（安全问题检查）

使用场景

• 生成无依赖的Linux可执行文件
• 通过TravisCI和GitHub发布静态版本
• 基于Alpine Linux容器部署Rust应用
• 构建包含Diesel或SQLx的数据库驱动应用

配置说明

快速开始

设置别名并构建发布版本：

sh
alias rust-musl-builder='docker run --rm -it -v "$(pwd)":/home/rust/src nasqueron/rust-musl-builder'
rust-musl-builder cargo build --release

注意：当前目录需允许uid 1000、gid 1000读写。

缓存优化

添加卷挂载加速构建：

sh
alias rust-musl-builder='docker run --rm -it -v "$(pwd)":/home/rust/src -v cargo-git:/home/rust/.cargo/git -v cargo-registry:/home/rust/.cargo/registry -v target:/home/rust/src/target nasqueron/rust-musl-builder'
# 修复卷权限
rust-musl-builder sudo chown -R rust:rust /home/rust/.cargo/git /home/rust/.cargo/registry /home/rust/src/target

OpenSSL配置

若应用使用OpenSSL，需添加openssl-probe crate并初始化证书环境变量：

rust
fn main() {
    openssl_probe::init_ssl_cert_env_vars();
    // 你的业务代码
}

Diesel配置

在Cargo.toml添加依赖：

toml
[dependencies]
diesel = { version = "1", features = ["postgres", "sqlite"] }
libsqlite3-sys = { version = "*", features = ["bundled"] } # SQLite依赖
openssl = "*" # Postgres依赖

Postgres需按顺序引入库：

rust
extern crate openssl;
#[macro_use]
extern crate diesel;

部署示例

TravisCI+GitHub发布

1. 运行travis setup releases配置GitHub发布
2. 修改.travis.yml：

yaml
language: rust
sudo: required
os: [linux, osx]
rust: stable
services: [docker]
before_deploy: "./build-release myapp ${TRAVIS_TAG}-${TRAVIS_OS_NAME}"
deploy:
  provider: releases
  api_key: { secure: "你的加密密钥" }
  file_glob: true
  file: "myapp-${TRAVIS_TAG}-${TRAVIS_OS_NAME}.*"
  skip_cleanup: true
  on: { rust: stable, tags: true }

3. 添加build-release脚本和Dockerfile：

Dockerfile
FROM docker.xuanyuan.run/nasqueron/rust-musl-builder
ADD --chown=rust:rust . ./
CMD cargo build --release

Alpine Linux容器部署

使用多阶段构建：

Dockerfile
# 构建阶段
FROM docker.xuanyuan.run/nasqueron/rust-musl-builder AS builder
ADD --chown=rust:rust . ./
RUN cargo build --release

# 部署阶段
FROM docker.xuanyuan.run/alpine:latest
COPY --from=builder /home/rust/src/target/x86_64-unknown-linux-musl/release/myapp /usr/local/bin/
CMD ["myapp"]

许可证

采用Apache 2.0许可证或MIT许可证。