Go语言操作DockerAPI实现容器管理：语言学习中的运维自动化-Golang-PHP中文网

根本原因是当前用户无权访问 /var/run/docker.sock，需将用户加入 docker 用户组并重启终端或系统；也可临时用 sudo docker 执行命令。

go语言操作dockerapi实现容器管理：语言学习中的运维自动化

根本原因不是代码写错，而是进程没权限访问 /var/run/docker.sock。SDK 不会自动读取 DOCKER_HOST，也不默认连 Unix socket，必须显式指定 host。

Linux/macOS：用 unix:///var/run/docker.sock，运行 Go 程序的用户必须在 docker 用户组，否则报 permission denied while trying to connect to the Docker daemon socket
macOS（Docker Desktop）：实际路径是 unix:///Users/$USER/.docker/run/docker.sock，别硬写 /var/run
WSL2：推荐开启 Docker Desktop 的 “WSL integration”，仍可用 unix:///var/run/docker.sock；若走 TCP，需设 tcp://localhost:2375 并在 Docker Desktop 中启用 “Expose daemon”（仅限开发）

初始化客户端示例：client.NewClientWithOpts(client.WithHost("unix:///var/run/docker.sock"), client.WithAPIVersionNegotiation())

这不是网络或权限问题，而是配置结构体字段不合法——SDK 不校验、不补全、不提示，出错就是 HTTP 400。

Dolphindb Docker

自动化 DolphinDB Docker 部署，支持自动架构检测（ARM64/x86_64），智能内存分配（50% 规则）以及完整数据持久化。

下载

Config.Image 必须带 tag，写 "nginx" 会失败，得写 "nginx:alpine" 或 "nginx:1.25"
Cmd 和 Entrypoint 类型是 []string，传 "sh -c 'echo hello'" 这种字符串会静默失败，得拆成 []string{"sh", "-c", "echo hello"}
HostConfig 不能为 nil，必须显式初始化：&container.HostConfig{AutoRemove: true}，否则端口映射、挂载卷等全失效
端口映射要两步：先在 Config.ExposedPorts 声明 map[string]struct{}{"80/tcp": {}}，再在 HostConfig.PortBindings 填 map[string][]nat.PortBinding{"80/tcp": {{HostPort: "8080"}}}

这些看似独立的问题，本质都是流式接口未消费完或参数冲突导致的阻塞/校验失败。

client.ImagePull 返回 io.ReadCloser，必须消费全部流：io.Copy(io.Discard, resp) 或逐行解码 JSON，否则后续调用（如 ContainerCreate）会卡死
client.ContainerLogs 默认 Follow: true，不设 Follow: false 就会一直阻塞，直到容器退出；还要注意日志是带 ANSI 控制符的字节流，直接转 string 可能乱码
HostConfig.NetworkMode = "host" 时，client.ContainerStart 调用中不能传 types.ContainerStartOptions{Platform: ""}，Docker SDK 1.14+ 会校验并报错；真正需要平台时，应在 ImagePull 阶段用 image.PullOptions{Platform: "linux/amd64"}

不是容器不存在，而是你用了截断的 ID 或误判了创建结果。

ContainerCreate 返回的是 container.ContainerCreateCreatedBody，里面只有 ID 字段；ID 返回即表示已注册，可立刻 ContainerStart，无需轮询
别取 CreatedBody.ID[:12] 当 ID 用——daemon 返回的是完整 64 位 hash，截断后匹配不上，ContainerStop 或 ContainerRemove 就会报 No such container
销毁前建议加一层防护：client.ContainerInspect(ctx, id) 检查是否存在；删除时用 ContainerRemoveOptions{Force: true, RemoveVolumes: true} 避免残留