Docker Volume挂载含无效字符报错：绝对路径为何不生效？

问题描述 #

使用Docker Go SDK配置Volume类型挂载时出现报错，而Bind挂载可正常工作。相关Go代码如下：

defaultCfg.Mounts = append(ContainerHostConfig.Mounts, mount.Mount{
    Type:   mount.TypeVolume,
    Source: fmt.Sprintf("/root%s", tmp),
    Target: fmt.Sprintf("%s", tmp),
})

报错信息：

"failed to create container: Error response from daemon: create /root/tmp/metrics-60-1990068486: "/root/tmp/metrics-60-1990068486" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]" are allowed. If you intended to pass a host directory, use absolute path"

If you intended to pass a host directory, use absolute path

疑问：使用的/root/tmp/metrics-60-1990068486是绝对路径，为何报错？

问题原因 #

Docker的Volume挂载和Bind挂载是完全不同的机制，这是问题核心：

• Bind挂载的Source是主机上的绝对路径，直接映射容器内路径；
• Volume挂载的Source是Docker管理的卷名称，不是主机路径。卷名称只能包含[a-zA-Z0-9][a-zA-Z0-9_.-]字符，不能包含/，这就是报错的直接原因——你把主机路径当作了卷名称传入，违反了卷命名规则。

错误提示里的内容是在提示：如果要映射主机目录，应该用Bind挂载而非Volume挂载，此时才需要传入绝对路径。

解决方法 #

根据需求选择对应方案：

1. 如果要映射主机目录（双向同步）：将挂载类型改为mount.TypeBind，保持Source为绝对路径即可，和之前正常工作的Bind挂载逻辑一致：

defaultCfg.Mounts = append(ContainerHostConfig.Mounts, mount.Mount{
    Type:   mount.TypeBind,
    Source: fmt.Sprintf("/root%s", tmp),
    Target: fmt.Sprintf("%s", tmp),
    BindOptions: &mount.BindOptions{
        CreateMountpoint: true, // 保留原配置
    },
})

2. 如果要使用Docker管理的Volume：将Source改为符合命名规则的卷名称（比如去掉路径前缀，用metrics-60-1990068486这类名称），Docker会自动在其管理路径下创建该卷：

defaultCfg.Mounts = append(ContainerHostConfig.Mounts, mount.Mount{
    Type:   mount.TypeVolume,
    Source: strings.TrimPrefix(fmt.Sprintf("/root%s", tmp), "/root/"), // 提取合法卷名称
    Target: fmt.Sprintf("%s", tmp),
})

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