Docker 镜像调试最佳实践

当你已经构建了一个 Docker 镜像，但运行它的容器启动后立即退出（通常是因为服务异常或配置错误），你仍然可以通过以下几种方式进入镜像内部进行调试。

✅ 最佳实践：如何对一个“启动即退出”的镜像进行命令行调试？

🧭 目标

进入容器的命令行环境，即使它默认运行的服务会失败。

✅ 方法一：使用 `docker run` 覆盖 CMD，直接进入 shell

这是最推荐的方式。

🔧 命令：

docker run -it --rm openeuler/dns:22.03-lts-sp4 /bin/sh

💡 说明：

-it：启用交互式终端。
--rm：退出后自动删除容器（临时调试用）。
/bin/sh：覆盖镜像的默认 CMD，不运行服务，而是进入 shell。
如果你的镜像中没有 bash，[sh](file://e:\docker_workspaces（svn.home）\base_systems\openEuler_dns\CreateContainer.sh) 通常是存在的。

👇 示例输出：

/ # ls /etc/named.conf
/etc/named.conf

你可以在这个 Shell 中检查配置文件、权限、用户是否存在等问题。

✅ 方法二：使用 `docker run` + `--entrypoint` 进入（适用于自定义 ENTRYPOINT 的情况）

如果你的镜像设置了 ENTRYPOINT（比如总是运行某个脚本），你可以通过 --entrypoint 覆盖它。

🔧 命令：

docker run -it --rm --entrypoint /bin/sh openeuler/dns:22.03-lts-sp4

💡 说明：

--entrypoint 会忽略 Dockerfile 中定义的 ENTRYPOINT 和 CMD
然后你再手动执行你想测试的命令，例如：
```
/usr/sbin/named -g -c /etc/named.conf
```

✅ 方法三：创建一个新的调试镜像（适合复杂场景）

如果你经常需要调试这个镜像，可以新建一个用于调试的镜像，修改其行为。

1. 创建 [debug.Dockerfile](file://e:\docker_workspaces（svn.home）\base_systems\openEuler_dns\debug.Dockerfile) 文件：

FROM openeuler/dns:22.03-lts-sp4# 覆盖原 CMD，改为进入 Shell
CMD ["/bin/sh"]

2. 构建调试镜像：

docker build -f debug.Dockerfile -t openeuler/dns:debug .

3. 启动并调试：

docker run -it --rm openeuler/dns:debug

这样你就可以在一个和原镜像几乎一致的环境中进行排查了。

✅ 方法四：查看日志 + inspect 日志文件 + 挂载目录分析

如果你只是想快速查看出错原因，可以结合以下命令定位问题：

🔍 查看容器日志：

docker logs <container_name_or_id>

🔍 进入容器文件系统（即使没运行）：

docker create --name debug-container openeuler/dns:22.03-lts-sp4
docker cp debug-container:/var/log/messages ./messages.log
cat ./messages.log

或者挂载目录后查看文件：

docker run -it --rm -v ./debug:/mnt openeuler/dns:22.03-lts-sp4 /bin/sh
ls /mnt

✅ 方法五：使用 scratch 容器复制文件出来分析

有时你只需要看看里面的文件内容而不运行服务本身。

docker create --name temp openeuler/dns:22.03-lts-sp4
docker cp temp:/etc/named.conf ./named.conf
docker rm temp

然后在宿主机上编辑、检查配置。

✅ 方法六：使用 `nsenter` 进入容器命名空间（高级）

如果你有运行过的容器（哪怕只运行了几秒），可以用 nsenter 进入其命名空间。

1. 查看容器 PID：

docker inspect <container_id> | grep HostPid

2. 使用 nsenter 进入：

sudo nsenter -t <PID> -m -u -i -n -p

这可以让你看到容器内完整的进程、网络、挂载信息。

✅ 总结：不同场景下的调试策略

场景	推荐方法
容器启动后立刻退出	使用 `docker run ... /bin/sh` 替换 CMD
使用了 ENTRYPOINT	使用 `--entrypoint /bin/sh`
需要保留容器状态	使用 `docker create` + `docker cp`
想复用原有逻辑调试	创建 debug.Dockerfile 并重新构建
分析配置文件	使用 `docker cp` 或 mount volume
高级调试（pid/ns）	使用 `nsenter` 或 `docker inspect`

✅ 附注：如何查看容器退出原因？

docker inspect <container_id> | grep -i "exit_code"
# 或者
docker inspect <container_id> | grep -A 10 "State"

输出示例：

"State": {"ExitCode": 1,"Error": "","FinishedAt": "2025-05-20T12:00:00Z","Running": false,"Paused": false,"Restarting": false,"OOMKilled": false,"Dead": false,"Pid": 0,"ExitCode": 1,"Error": "","StartedAt": "2025-05-20T11:59:59Z","FinishedAt": "2025-05-20T11:59:59Z"
}

如果 ExitCode != 0，表示非正常退出，结合日志进一步查错。

✅ 最终建议流程

# 1. 进入容器 shell
docker run -it --rm openeuler/dns:22.03-lts-sp4 /bin/sh# 2. 手动运行 DNS 服务以调试
/usr/sbin/named -g -c /etc/named.conf# 3. 检查文件权限
ls -l /var/named# 4. 查看日志文件
cat /var/log/messages# 5. 检查 named 用户是否存在
id named