如何通过GoLang Docker SDK配置本地目录到容器的卷挂载点？

你之前的问题出在挂载配置的位置不对：container.Config里的Volumes字段只是用来声明容器内需要存在的目录（相当于告诉Docker“这个目录要预留出来”），但真正的宿主机-容器路径绑定，需要在container.HostConfig的Binds字段里配置。

正确的代码示例 #

import (
    "context"
    "github.com/docker/docker/api/types/container"
    "github.com/docker/docker/client"
)

func main() {
    ctx := context.Background()
    cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
    if err != nil {
        panic(err)
    }
    defer cli.Close()

    testImageName := "your-image-name"
    localPath := "/host/local/absolute/path" // 注意这里必须用绝对路径
    containerPath := "/pathInDocker"

    // 1. 配置容器基础信息（Volumes可选，但声明后逻辑更清晰）
    config := &container.Config{
        Image: testImageName,
        Volumes: map[string]struct{}{
            containerPath: {}, // 声明容器内要预留的目录
        },
        Cmd: []string{"ls", "/pathInDocker"},
    }

    // 2. 配置宿主机挂载绑定（这才是实现本地目录挂载的关键！）
    hostConfig := &container.HostConfig{
        Binds: []string{
            // 格式：宿主机绝对路径:容器内路径[:权限]
            localPath + ":" + containerPath,
            // 如果需要只读挂载，可以写成：localPath + ":" + containerPath + ":ro"
        },
    }

    // 3. 创建容器时传入HostConfig（之前你传的是nil，这就是挂载失效的核心原因）
    res, err := cli.ContainerCreate(ctx, config, hostConfig, nil, nil, "")
    if err != nil {
        panic(err)
    }

    // 别忘了启动容器
    if err := cli.ContainerStart(ctx, res.ID, container.StartOptions{}); err != nil {
        panic(err)
    }
}

为什么你之前的写法不对 #

你之前尝试把"localPath:/pathInDocker"这类字符串放到Volumes的键里，Docker会把这个整个字符串当作容器内的目录名（比如创建一个叫localPath:/pathInDocker的奇怪文件夹），而不是解析成宿主机和容器的路径绑定——因为Volumes字段的作用只是声明容器内的目录，不处理挂载逻辑。

额外提示 #

• 宿主机路径必须用绝对路径，相对路径会直接导致挂载失败
• 可以在绑定字符串后加权限标识：:ro表示只读挂载，:rw表示读写（默认是读写权限）
• 如果不需要提前声明容器内目录，甚至可以省略Config.Volumes的配置，只要HostConfig.Binds配置正确，Docker会自动在容器内创建对应的目录

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