l7mp/net-debug

网络调试工具镜像

概述

本镜像为自包含的Docker镜像，集成了多种网络调试工具，旨在作为Kubernetes Pod的Sidecar容器，帮助排查网络连通性、性能瓶颈等网络相关问题。

核心功能和特性

• 集成工具：包含tcpdump（网络抓包）、socat/websocat（数据转发）、iperf（网络性能测试）、nmap（端口扫描）、tcpreplay（数据包重放）、ping/traceroute（网络连通性测试）等常用网络调试工具。
• 自包含设计：无需额外安装依赖，容器启动即可直接使用所有工具。
• 轻量便捷：专注于网络调试场景，镜像体积优化，适合快速部署。

使用场景和适用范围

• Kubernetes网络问题排查：作为Sidecar容器与业务Pod一同部署，诊断Pod间/内外网络连通性、端口可达性、流量延迟等问题。
• 独立网络调试：在Docker环境中独立运行，用于测试主机网络、容器网络的性能和连通性。
• 网络性能验证：通过iperf测试网络带宽，tcpreplay模拟流量场景，验证网络承载能力。

使用方法

Docker独立运行

启动容器并进入交互终端，直接使用工具：

bash
docker run -it --rm l7mp/net-debug sh

进入容器后，可直接执行工具命令，例如：

bash
# 测试网络连通性
ping <目标IP>

# 抓包分析
tcpdump -i eth0 port 80

# 网络性能测试（服务端）
iperf -s

# 网络性能测试（客户端）
iperf -c <服务端IP>

Kubernetes Sidecar部署

在Pod配置中添加本镜像作为Sidecar容器，示例：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: app-with-debug
spec:
  containers:
  - name: app
    image: your-app-image:latest
  - name: net-debug  # Sidecar调试容器
    image: l7mp/net-debug:latest
    command: ["sleep", "infinity"]  # 保持容器运行

部署后，通过kubectl exec进入调试容器：

bash
kubectl exec -it app-with-debug -c net-debug -- sh

随后即可使用工具诊断与业务容器（app）相关的网络问题。

来源和许可证

• 源码地址：https://github.com/l7mp/net-debug
• 许可证：MIT License