munnerz/ddebug

ddebug（docker debug）

ddebug是一个超简单的脚本，用于调试运行中的Docker容器——这些容器可能具有只读根文件系统，或缺少必要的调试工具。

它会创建一个新容器，与目标容器共享网络、pid和ipc命名空间，并将目标容器的根文件系统挂载到调试容器的/containerfs目录下。默认使用Alpine镜像作为调试容器，你也可以通过指定第二个位置参数来替换为其他镜像。

核心功能

• 与目标容器共享网络、pid、ipc命名空间，确保调试环境与目标容器一致
• 挂载目标容器根文件系统到/containerfs，方便查看和修改文件
• 支持自定义调试镜像（默认Alpine）

使用场景

• 调试根文件系统为只读的容器
• 调试缺少ls、ps等基础工具的轻量级容器
• 在无需修改目标容器配置的前提下进行问题排查

配置说明

基础使用步骤

1. 登录到运行目标容器的主机，或配置本地Docker客户端连接远程主机的Docker守护进程。
2. 获取目标容器的ID或名称：

   bash
   $ docker ps
   CONTAINER ID        IMAGE                                   COMMAND                  CREATED             STATUS              PORTS                    NAMES
   a55225460627        gcr.io/cloudsql-docker/gce-proxy:1.10   "/cloud_sql_proxy ..."   2 days ago          Up 2 days           0.0.0.0:3306->3306/tcp   epic_kepler
   

3. 使用容器ID或名称运行ddebug：

   bash
   $ ddebug.sh epic_kepler
   

4. （可选）替换调试镜像：

   bash
   $ ddebug.sh epic_kepler debian:jessie
   

通过Docker镜像运行ddebug

若无需上传脚本到主机，或通过Kubernetes等环境执行，可直接使用Docker镜像：

bash
$ docker run --rm -it \
	-v $(which docker):/usr/bin/docker \
	-v /var/run/docker.sock:/var/run/docker.sock \
	munnerz/ddebug epic_kepler

注意：在Docker for Mac（OSX）环境下，需将$(which docker)替换为Moby VM内Docker二进制的绝对路径：

bash
$ docker run --rm -it \
	-v /usr/bin/docker:/usr/bin/docker \
	-v /var/run/docker.sock:/var/run/docker.sock \
	munnerz/ddebug epic_kepler

执行后会直接进入调试容器的shell环境。