sjourdan/toolbox

Toolbox Docker容器

![Circle CI]([***]

镜像概述

本镜像基于Alpine Linux构建，是一个轻量级容器工具箱，包含多种系统调试和网络工具，主要用于CoreOS环境下的容器调试。镜像体积约70MB，拉取速度快，便于快速部署使用。

核心功能

包含以下常用工具：

• 进程跟踪：strace
• DNS查询：dig
• 网络连接：netcat（nc）
• 网络配置：ifconfig
• 网络扫描：nmap
• HTTP请求：curl
• 路由跟踪：traceroute
• 网络抓包：tcpdump
• 系统监控：htop、iftop、iotop、dstat、iostat
• 网络诊断：mtr、ping
• 速度测试：speedtest-cli
• 磁盘性能测试：hdparm

使用场景

适用于以下容器调试场景：

• 容器网络问题排查（DNS解析、端口连通性）
• 进程性能分析（系统调用跟踪）
• 系统资源监控（CPU、内存、磁盘IO）
• 网络链路诊断（路由跟踪、丢包检测）
• 磁盘性能验证

配置说明

部分工具需特定权限或配置：

• 附加到其他容器进程：使用--pid=container:<容器名>参数
• 共享容器网络：使用--net=container:<容器名>参数
• 特权操作（如磁盘测试）：使用--privileged参数
• 进程跟踪：需添加--cap-add sys_admin和--cap-add sys_ptrace权限

Docker部署示例

拉取镜像

bash
docker pull sjourdan/toolbox

常用命令示例

1. DNS查询github.com

bash
docker run -it --rm sjourdan/toolbox dig +short github.com

2. HTTP请求测试

bash
docker run -it --rm sjourdan/toolbox curl -IL https://google.com

3. 查看网络接口配置

bash
docker run -it --rm sjourdan/toolbox ifconfig eth0

4. 网络连接测试

bash
docker run -it --rm sjourdan/toolbox nc google.com 80

5. 速度测试

bash
docker run -it --rm sjourdan/toolbox speedtest-cli

6. 跟踪其他容器进程（容器名为web）

bash
docker run -t --pid=container:web --net=container:web --cap-add sys_admin --cap-add sys_ptrace sjourdan/toolbox strace -f -p 1

7. 监控主机进程

bash
docker run -it --rm --pid=host sjourdan/toolbox htop

8. 磁盘性能测试（需特权）

bash
docker run -it --rm --privileged sjourdan/toolbox hdparm -tT /dev/xvda

Windows系统注意事项

Windows系统中交互式命令需前缀winpty：

bash
winpty docker run -it --rm sjourdan/toolbox winmtr -s 1400 github.com

构建与测试

构建镜像

bash
make build

查看镜像更新日期

bash
docker inspect --format '{{json .Config.Labels}}' sjourdan/toolbox
{"version":"20170228"}

测试镜像

bash
make tests