Docker 与 Rust：生产环境应用容器化

引言：为什么 Rust 开发者需要 Docker？

Rust 以其性能与内存安全著称，但即便是最高效的二进制文件，也需要正确的环境才能运行。Docker 通过将应用及其所有依赖打包到隔离的容器中，解决了这个问题。本文将详细讲解如何使用 Docker 容器化 Rust 应用，并采用多阶段构建、镜像体积最小化等现代技术。

容器化 Rust 项目尤其有利，因为 Rust 会编译成静态二进制文件——这使得您可以创建比 Python 或 Node.js 应用运行更快、更安全的最小化镜像（alpine 甚至 scratch）。

1. 基础：为简单 Rust 应用编写 Dockerfile

我们从一个使用 actix-web 框架的简单 Rust Web 服务器开始，并创建一个基础的 Dockerfile。

1.1. 项目结构

my_rust_app/├── Cargo.toml├── Cargo.lock└── src/    └── main.rs

1.2. 代码示例（main.rs）

use actix_web::{get, App, HttpResponse, HttpServer, Responder};

#[get("/")]async fn hello() -> impl Responder {    HttpResponse::Ok().body("Hello from Rust container!")}

#[actix_web::main]async fn main() -> std::io::Result<()> {    HttpServer::new(|| App::new().service(hello))        .bind("0.0.0.0:8080")?        .run()        .await}

1.3. 简单的 Dockerfile

FROM rust:1.77 AS builderWORKDIR /appCOPY Cargo.toml Cargo.lock ./RUN mkdir src && echo "fn main() {}" > src/main.rsRUN cargo build --releaseCOPY src/ src/RUN cargo build --release

FROM debian:bookworm-slimCOPY --from=builder /app/target/release/my_rust_app /usr/local/bin/EXPOSE 8080CMD ["my_rust_app"]

说明： 第一阶段（builder）编译应用，第二阶段仅将二进制文件复制到干净的 Debian 镜像中。这可将镜像从约 2 GB 减小至约 100 MB。

2. 多阶段构建：优化镜像体积

多阶段构建是面向 Rust 的关键技术。它允许将构建环境（包含编译器、依赖项）与运行环境分离。

2.1. 带缓存的高级 Dockerfile

为了加速重复构建，我们缓存依赖项：

FROM rust:1.77 AS builderWORKDIR /appCOPY Cargo.toml Cargo.lock ./RUN mkdir src && echo "fn main() {}" > src/main.rsRUN cargo build --release 2>/dev/null || trueCOPY src/ src/RUN cargo build --release && \    cp target/release/my_rust_app /app/rust_app

FROM gcr.io/distroless/cc-debian12COPY --from=builder /app/rust_app /app/rust_appEXPOSE 8080CMD ["/app/rust_app"]

为什么选择 distroless？ distroless 镜像仅包含 glibc 和基础库——没有 shell、apt、ls。这提升了安全性，并将体积减小至约 30 MB。

2.2. 基于 scratch 的最小化镜像

如果您的应用不使用 libc（例如使用 #![no_std] 编写），您可以使用 scratch：

FROM rust:1.77 AS builderWORKDIR /appCOPY . .RUN cargo build --release

FROM scratchCOPY --from=builder /app/target/release/my_rust_app /appEXPOSE 8080CMD ["/app"]

此类镜像重量不到 10 MB！

3. Docker Compose：多容器应用

Rust 应用常与 PostgreSQL、Redis 或 Nginx 配合使用。我们使用 docker-compose.yml：

3.1. docker-compose.yml 示例

version: '3.8'services:  app:    build: .    ports:      - "8080:8080"    environment:      - DATABASE_URL=postgres://user:pass@db:5432/mydb      - RUST_LOG=info    depends_on:      - db

  db:    image: postgres:16-alpine