markeijsermans/debug

Docker Debug Containers

https://github.com/markeijsermans/docker-debug

Kitchen Sink（全功能版本）

docker pull markeijsermans/debug:kitchen-sink

该镜像基于ubuntu:16.04构建，包含丰富的网络和系统调试工具（工具列表见Dockerfile），适用于生产环境中极简容器（如scratch基础镜像）的问题诊断（尤其是K8s/Mesos编排场景）。此版本为默认镜像，标签为latest。

使用技巧

sh
# 特权+主机网络模式（便于深度调试）
docker run --privileged --net=host --rm -ti markeijsermans/debug

# 启动轻量HTTP服务器（仅返回"OK"，用于负载测试）
docker run --rm -ti -p 8080:8080 markeijsermans/debug simple-server

# 启动Python文件服务器
docker run --rm -ti -p 8080:8080 markeijsermans/debug python3 -m http.server

待办

• 筛选并移除未使用的工具包

Bootstrap（轻量版本）

docker pull markeijsermans/debug:alpine

基于Alpine（~5MB轻量镜像）构建，保留包管理系统的同时支持临时安装调试工具。运行debug命令会自动安装基础工具（见bootstrap-debug/debug列表）、配置.bashrc并进入bash子shell；退出时自动清理新增包，保持容器原状态。

可指定需安装的工具（bash会自动安装）：

sh
debug vim tcpdump

使用技巧

Alpine默认安装wget，可通过以下命令快速使用：

sh
wget https://git.io/vAKxa -O - | sh

也可直接将debug脚本加入Dockerfile：

dockerfile
FROM alpine
ADD https://raw.githubusercontent.com/markeijsermans/docker-debug/master/bootstrap-debug/debug /bin/debug

注意：不建议将此脚本设为镜像的入口点或默认命令。