juroapp/toolbox

调试工具容器镜像文档

镜像概述和主要用途

本镜像为容器环境提供集成化的调试工具集，包含多种常用系统诊断、网络排查和问题定位工具。无需在目标容器中安装额外依赖，即可快速启动并进行各类调试操作，适用于容器化应用的日常维护、故障排查和问题诊断场景。

核心功能和特性

核心功能

• 集成网络调试工具：支持网络连接测试、数据包捕获、端口检测和DNS解析
• 提供系统监控工具：可查看进程状态、资源占用、文件系统使用情况
• 包含文件操作工具：支持文件编辑、查看和搜索功能
• 内置诊断分析工具：用于进程跟踪、系统调用监控和应用调试

主要特性

• 工具丰富：涵盖网络、系统、文件、诊断等多维度调试工具
• 轻量便捷：基于精简基础镜像构建，启动快速，资源占用低
• 即开即用：无需预先配置，启动容器即可直接使用所有工具
• 兼容性强：适用于主流Linux容器运行时环境（Docker、containerd等）

使用场景和适用范围

典型使用场景

• 容器网络故障排查：诊断跨容器/跨主机网络连接问题、端口不通、DNS解析异常等
• 系统资源问题分析：定位容器CPU/内存/磁盘占用异常、进程卡死等问题
• 文件系统检查：查看容器内文件结构、权限配置和日志内容
• 跨容器环境诊断：在多容器应用中快速切换进行多节点问题排查
• 临时诊断环境：为生产/测试环境提供临时调试环境，不影响目标容器

适用范围

• Docker/containerd容器环境
• Kubernetes集群节点和Pod诊断
• CI/CD流水线中的问题定位环节
• 开发/测试/生产环境的日常维护
• 各类Linux基础镜像的容器（如Alpine、Ubuntu、CentOS等）

使用方法和配置说明

基本使用方法

交互式运行容器

通过以下命令启动交互式调试环境：

bash
docker run -it --rm [镜像名称] /bin/sh

说明：--rm 参数表示退出后自动删除容器，避免残留；-it 提供交互式终端

访问宿主机网络

如需排查宿主机网络问题，可使用host网络模式：

bash
docker run -it --rm --net=host [镜像名称] /bin/sh

挂载宿主机文件系统

如需访问宿主机文件系统进行诊断：

bash
docker run -it --rm -v /:/host [镜像名称] /bin/sh

进入容器后可通过 /host 目录访问宿主机根文件系统

常用工具示例

网络调试

bash
# 测试网络连接
curl http://example.com
wget https://example.com

# 查看网络连接状态
netstat -tulpn
ss -lntu

# 捕获网络数据包
tcpdump -i eth0 port 80

# DNS解析测试
nslookup example.com
dig example.com

系统监控

bash
# 查看进程列表
ps aux
top
htop

# 查看资源占用
df -h  # 磁盘使用情况
du -sh /tmp  # 目录大小
free -m  # 内存使用情况

# 查看打开的文件
lsof -p <进程ID>

文件操作

bash
# 编辑文件
vim /etc/hosts
nano /var/log/app.log

# 查看文件内容
cat /proc/cpuinfo
less /var/log/syslog

配置说明

本镜像无需特殊配置，所有工具均已预安装并配置完成。可通过以下方式自定义使用：

• 通过命令行参数指定启动命令（默认 /bin/sh）
• 通过 -v 参数挂载外部目录/文件进行分析
• 通过 --user 参数指定运行用户（默认root用户，便于完整权限调试）

注意事项

• 生产环境使用时建议限制容器权限，避免过度授权
• 调试完成后及时清理容器，避免资源占用
• 部分工具可能需要特定系统权限，运行时可根据需要添加 --cap-add 参数获取必要能力（如 --cap-add=NET_RAW 用于tcpdump）