Rust API容器无法调用Docker套接字启动容器的问题求助

你遇到的错误核心原因是：最终运行的gcr.io/distroless/cc-debian11镜像属于极简镜像，完全不包含Docker CLI工具。虽然你在builder阶段安装了docker.io，但该阶段的内容不会自动传递到最终镜像，导致容器内找不到docker命令。

提供两种可行方案，你可以根据场景选择：

方案1：更换基础镜像并安装Docker CLI #

改用包含基础系统工具的镜像（比如debian:11-slim），在最终镜像中安装Docker客户端，这样就能直接执行docker命令：

修改后的Dockerfile：

FROM lukemathwalker/cargo-chef:latest-rust-1.70.0 as chef
WORKDIR app

FROM chef AS planner
COPY . .
RUN cargo chef prepare --recipe-path recipe.json

FROM chef AS builder
COPY --from=planner /app/recipe.json recipe.json
RUN cargo chef cook --release --recipe-path recipe.json
COPY . .
RUN cargo build --release

# 替换为debian slim镜像，保留基础系统工具
FROM debian:11-slim
WORKDIR /app

# 仅安装Docker客户端（无需服务端），清理apt缓存减小体积
RUN apt-get update && \
    apt-get install -y --no-install-recommends docker-cli && \
    rm -rf /var/lib/apt/lists/*

# 复制编译好的API二进制文件
COPY --from=builder /app/target/release/blue_traktor_api .

ENV DOCKER_HOST unix:///var/run/docker.sock

CMD ["./blue_traktor_api"]

运行容器时仍需挂载宿主机Docker套接字：

docker run -v /var/run/docker.sock:/var/run/docker.sock your-image-name

方案2：使用Rust Docker SDK替代CLI调用 #

放弃在容器内安装Docker CLI，改用Rust官方生态的Docker SDK（比如bollard）直接通过套接字调用Docker API，更轻量且符合容器化最佳实践：

步骤1：添加依赖到Cargo.toml #

[dependencies]
bollard = "0.16.0"
tokio = { version = "1.0", features = ["full"] }

步骤2：修改Rust代码替换CLI调用 #

use bollard::Docker;
use bollard::container::ListContainersOptions;
use std::collections::HashMap;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 连接到宿主机Docker套接字
    let docker = Docker::connect_with_unix("/var/run/docker.sock", None, None)?;

    // 等价于`docker ps -a`的参数配置
    let list_options = Some(ListContainersOptions {
        all: true,
        filters: HashMap::new(),
        ..Default::default()
    });

    // 获取容器列表
    let containers = docker.list_containers(list_options).await?;

    // 处理返回结果（示例：打印容器ID和名称）
    for container in containers {
        println!("容器ID: {}", container.id.unwrap_or_default());
        println!("容器名称: {:?}", container.names.unwrap_or_default());
    }

    Ok(())
}

步骤3：保持原Dockerfile不变 #

此时最终镜像可以继续使用gcr.io/distroless/cc-debian11，因为不需要依赖任何外部CLI工具，仅需挂载套接字即可运行。

• 方案1：简单直接，无需修改业务代码，但镜像体积会增大（约增加100MB左右）。
• 方案2：镜像体积更小，代码集成度更高，适合生产环境，但需要熟悉Docker API和Rust SDK的使用。

内容的提问来源于stack exchange，提问作者Exdet