Go程序挂载Docker volume必须用HostConfig.Mounts而非Binds，Type需设为"volume"，Source为volume名，且需预先创建volume；SELinux场景须设SELinuxRelabel:true；volume生命周期独立，需主动清理。
Go 程序调用 Docker API 挂载 volume 时，HostConfig.Binds 格式必须严格匹配
Go 程序通过 docker/api 创建容器时，若想挂载已存在的 Docker volume（比如名为 mydata），不能只写 "mydata:/app/data" —— 这会被 Docker 守护进程当作 bind mount 解析，而非 volume 引用。正确做法是把 volume 名称放在 HostConfig.VolumesFrom 或更常用的是用 HostConfig.Mounts 字段显式声明。
使用 Mounts 更可靠，因为它是 v1.40+ API 推荐方式，支持 volume、bind、tmpfs 多种类型，并能明确指定 driver 和选项：
mounts := []types.Mount{
{
Type: "volume",
Source: "mydata",
Target: "/app/data",
// ReadOnly: true, // 可选
},
}
config.HostConfig.Mounts = mounts
常见错误包括：
- 误用
Binds：写成[]string{"mydata:/app/data"}→ Docker 会尝试在宿主机找路径mydata，报错invalid mount config for type "bind": bind source path does not exist - 漏设
Type：Mount结构体中Type为空会导致默认为bind，即使Source是 volume 名 - volume 不存在时未提前创建：Go 程序需先调用
Client.VolumeCreate()，否则ContainerCreate会失败
用 Go 创建命名 volume 并设置 driver-opt 需手动传 VolumeCreateOptions
Docker volume 默认使用 local driver，但若需控制底层行为（如指定 uid/gid、启用 compression），得通过 DriverOpts 传参。Go SDK 不会自动解析 docker volume create --opt 命令的 shorthand，必须显式构造 map。
立即学习“go语言免费学习笔记（深入）”；
例如创建一个挂载到 /mnt/nvme 并启用 uid=1001 的 volume：
opts := volume.VolumeCreateOptions{
Driver: "local",
DriverOpts: map[string]string{
"type": "none",
"o": "bind,uid=1001",
"device": "/mnt/nvme",
},
}
vol, err := client.VolumeCreate(context.Background(), opts)
注意点：
-
DriverOpts键名必须小写，且与mount(8)手册中选项一致；"o"是必需 key，用于传递挂载参数 - 若 driver 是
local且device指向块设备或目录，Docker 不会校验路径是否存在，但运行时挂载会失败 - volume 名称不能含
/或大写字母，否则VolumeCreate返回InvalidVolumeName
docker run -v 与 Go SDK 中 Mounts 行为不等价，尤其涉及 SELinux 或 user namespace
命令行 docker run -v mydata:/app/data:z 的 :z 标签，在 Go SDK 中不会自动转换为 SELinux 上下文设置。它实际影响的是 Mount 结构体的 SELinuxRelabel 字段（对应 :z）或 Propagation（对应 :rshared 等）。
若宿主机启用了 SELinux，且容器需读写 volume，必须显式开启重标：
mounts := []types.Mount{
{
Type: "volume",
Source: "mydata",
Target: "/app/data",
SELinuxRelabel: true, // 对应 :z
// Propagation: "rshared", // 对应 :rshared
},
}
没设 SELinuxRelabel: true 时，容器内进程可能因上下文不匹配被拒绝访问，日志里出现 Permission denied 但 ls -Z 显示路径有读权限——这是典型 SELinux 上下文未重标导致的静默失败。
容器退出后 volume 数据仍在，但 Go 程序需主动清理避免磁盘泄漏
Docker volume 生命周期独立于容器，ContainerRemove 不会删 volume，哪怕该 volume 只被这一个容器引用。Go 程序若频繁创建测试 volume（如 CI 场景），必须配套清理逻辑，否则 docker volume ls 会越积越多。
安全清理方式是先检查 volume 是否被其他容器使用：
vols, _ := client.VolumeList(context.Background(), filters.NewArgs())
for _, vol := range vols.Volumes {
if strings.HasPrefix(vol.Name, "test-") {
// 检查是否被任何容器引用（需额外调用 ContainerList + inspect）
// 或直接删除并忽略 "volume is in use" 错误
client.VolumeRemove(context.Background(), vol.Name, true)
}
}
关键细节：
-
VolumeRemove第二个参数force设为true可绕过“in use”检查，但可能引发后续容器启动失败 - volume 删除是同步操作，但底层文件系统释放可能延迟，
df -h不会立刻反映空间回收 - 不要依赖
Anonymousvolume（即-v /app/data不指定 name）做持久化——它的名字由 Docker 随机生成，Go 程序难以追踪和复用
volume 的真正持久性不在于“存在”，而在于你能否在下次启动时准确引用它。名字、driver、driver opts、挂载点三者缺一不可，任意一项变更都可能导致数据不可见。
