如何在Golang中管理Docker容器_Golang Docker容器管理实践-Golang-PHP中文网

权限被拒应将用户加入docker组：sudo usermod -aG docker $USER；开发时可临时用TCP方式（DOCKER_HOST=tcp://localhost:2375），但生产禁用。

如何在golang中管理docker容器_golang docker容器管理实践

用 `docker-go` 连接 Docker Daemon 时权限被拒怎么办

直接调用 docker-go 客户端（如 github.com/docker/docker/api/types + github.com/docker/docker/client）失败，常见错误是 connection refused 或 permission denied。根本原因不是代码写错，而是 Go 进程没权限访问 Docker socket。

Linux 下默认 socket 路径是 /var/run/docker.sock，属主为 root:docker；你的 Go 程序若非 root 或未加入 docker 用户组，会拒绝连接
别硬改 socket 权限（比如 chmod 666 /var/run/docker.sock），这是安全隐患；正确做法是把运行 Go 程序的用户加进 docker 组：
```
sudo usermod -aG docker $USER
```
，然后重新登录终端
开发时可用 TCP 方式绕过 socket 权限问题（仅限测试）：启动 dockerd 时加 -H tcp://0.0.0.0:2375，Go 客户端设 DOCKER_HOST=tcp://localhost:2375；但生产环境禁用该方式，无 TLS 认证等于裸奔

启动容器时 `ContainerCreate` 返回 “no such image” 却已执行过 `docker pull`

调用 cli.ContainerCreate() 报错 No such image，即使 shell 里 docker images 明明能看到该镜像——这通常是因为 Go 客户端和 CLI 使用了不同上下文（context）或命名空间。

确认你用的是同一 DOCKER_CONTEXT；默认是 default，但如果你切换过（比如用 docker context use mycloud），Go 程序不会自动继承，需显式指定：
```
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation(), client.WithHost("unix:///var/run/docker.sock"))
```
镜像名必须带 tag；"nginx" 不等价于 "nginx:latest"，Docker daemon 默认只认带完整 tag 的引用；建议始终写全，比如 "nginx:1.25-alpine"
如果是私有 registry 镜像，确保已用 docker login 登录，并且 Go 进程能读取 ~/.docker/config.json（路径不可被 chroot 或容器隔离干扰）

容器日志实时流式读取卡住或丢数据

用 cli.ContainerLogs() 获取日志时，发现 io.Copy 阻塞、goroutine 挂起，或者前几行日志没出来就结束了——这不是 Go bug，而是 Docker 日志 API 的流式行为与 reader 缓冲机制不匹配。

JSON Toolkit

JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。

下载

必须设置 Follow: true 才能持续读；但光设这个不够，还要配 Timestamps: true 和 Stdout/Stderr: true，否则可能拿不到输出流
别直接用 io.Copy(os.Stdout, reader)；日志流没有 EOF，io.Copy 会一直等；应改用 bufio.Scanner 按行读，或用 io.ReadCloser 配合 context.WithTimeout 控制生命周期

示例关键片段：

options := types.ContainerLogsOptions{
    Follow:     true,
    Timestamps: true,
    Stdout:     true,
    Stderr:     true,
}
reader, err := cli.ContainerLogs(ctx, containerID, options)
if err != nil {
    log.Fatal(err)
}
scanner := bufio.NewScanner(reader)
for scanner.Scan() {
    fmt.Println(scanner.Text())
}
// 注意：scanner.Err() 可能非 nil，但 reader.Close() 仍需调用

Stop/Remove 容器时遇到 “container is not running” 或 “conflict: unable to remove repository reference”

调用 ContainerStop 后立刻 ContainerRemove，却报错说容器不存在或正被占用——这是因为 Stop 是异步触发，Remove 却同步执行，中间存在竞态窗口。

Stop 不等于立即终止；它发 SIGTERM，等默认 10 秒才发 SIGKILL；Remove 前必须确认状态已变成 exited，不能只靠 Stop 返回就认为完事
安全做法：Stop 后轮询 ContainerInspect，检查 .State.Status 是否为 "exited"，超时后强制 Remove；或直接用 Force: true 参数跳过等待，但会丢失 graceful shutdown 机会
“conflict” 错误常因镜像被多个容器引用；Remove 容器时加 RemoveVolumes: true 和 Force: true 通常可解，但注意 volume 数据会一并清掉

Docker API 的每个操作背后都有明确的状态机和时序约束，Golang 客户端只是薄封装；真正难的不是调哪个函数，而是理解 Stop/Start/Remove 在 daemon 内部触发了什么，以及如何用 Go 的并发原语守住这些边界。