Golang Docker SDK怎么用_Golang Docker SDK教程【深入】-Golang-PHP中文网

golang docker sdk需严格按结构体契约配置：hostconfig必须显式初始化，image需带tag，端口映射须同时设exposedports和portbindings，containercreate返回的id必须用完整64位hash，日志读取需设follow:false并及时close。

golang docker sdk怎么用_golang docker sdk教程【深入】

直接说结论：Golang Docker SDK 不是“调一个函数就跑起来”，而是必须按结构体契约拼配置，漏掉 HostConfig 初始化、Image 缺 tag、端口映射两步不全，容器大概率创建成功但启动失败或没网络——错误还静默，debug 全靠打印 CreatedBody.ID 手动 docker ps -a 对照。

ContainerCreate 为什么返回 ID 却 start 报 “No such container”

这不是异步延迟问题，而是 ID 被误截断或误读。Docker daemon 返回的是完整 64 位 hash（如 "c6b7e2f9a1d0..."），但有人习惯取前 12 位当 ID 传给 ContainerStart，而 daemon 只认全量 ID。

ContainerCreate 是同步 API，CreatedBody.ID 返回即注册完成，可立刻 ContainerStart
别看 CreatedBody.Warnings——拉镜像慢时会有 warning，但创建仍成功；真正要检查的是 err == nil
调试时直接 fmt.Println(resp.ID)，再手动执行 docker ps -a | grep c6b7e2f9a1d0 确认是否存在
如果用 resp.ID[:12] 传参，且 daemon 版本较新（API v1.41+），会直接返回 404，不是“找不到”，是“ID 格式不匹配”

端口映射必须两步走：ExposedPorts + PortBindings

只设 PortBindings 不生效，只设 ExposedPorts 也不行——Docker 引擎要求声明和绑定分离，缺一不可，否则容器跑起来但宿主机访问不到。

Golang Samber Do

使用 samber/do 在 Golang 中实现依赖注入 — 服务容器、生命周期管理、作用域、健康检查、优雅关闭和模块组织

下载

在 container.Config.ExposedPorts 中声明：map[string]struct{}{"80/tcp": {}}（注意 value 是空 struct）
在 container.HostConfig.PortBindings 中绑定：map[string][]nat.PortBinding{"80/tcp": {{HostPort: "8080"}}}
Type 字段必须小写：Mount.Type = "bind"，写成 "Bind" 或 "volume" 写成 "Volume" 会被静默忽略
如果想让容器走宿主机网络（比如连本地 PostgreSQL），设 HostConfig.NetworkMode = "host"，但此时 ContainerStart 的 Platform 字段必须完全不传，否则报错 "configured for host network"

日志读取不设 `Follow: false` 就会卡死

ContainerLogs 默认是流式连接，Follow: true（默认值）会让 HTTP 连接一直挂着，不主动 close 就泄露 goroutine，大日志还可能 OOM。

必须显式传 types.ContainerLogsOptions{ShowStdout: true, ShowStderr: true, Timestamps: true, Follow: false}
用 io.Copy + bytes.Buffer 接收，别用 io.ReadAll —— 日志超 10MB 就容易内存暴涨
原始日志含 ANSI 控制符，直接 string(logBytes) 可能显示乱码；需要清洗可用 github.com/moby/term 的 EscapeNonPrintable
记得对 logsReader 调用 Close()，否则 fd 泄露

销毁容器前不检查状态就 panic

ContainerRemove 默认行为是“不存在就 panic”，但容器可能已退出未清理、或根本没创建成功，直接删会崩。

安全做法是先 ContainerInspect 查状态，或用 ContainerList 过滤目标容器
删的时候务必加 types.ContainerRemoveOptions{Force: true, RemoveVolumes: true}，否则残留卷和僵尸容器一堆
HostConfig.AutoRemove: true 和 RestartPolicy 互斥，设了前者再设后者会触发 API 400 错误，别混用
自定义网络下删容器，得先 NetworkDisconnect，否则 NetworkRemove 会报 "network xxx has active endpoints"