cirocosta/netshoot

netshoot: Docker网络故障排查瑞士军刀容器

镜像概述

Docker网络故障排查对工程师来说具有挑战性，netshoot容器集成了一系列强大的网络诊断工具，帮助快速定位容器、主机及Docker网络层面的问题。它是nicolaka/netshoot的分支版本，额外包含bash。

核心功能

1. 网络命名空间支持: 可进入容器、主机或Docker网络（如overlay/bridge）的命名空间进行诊断。
2. 丰富工具集: 包含iperf、tcpdump、netstat、iftop、drill、nmap、iproute2等工具。
3. 无侵入性: 无需在主机或应用容器安装额外工具，通过netshoot即可完成诊断。

使用场景

• 容器网络问题: 容器间通信失败、DNS解析异常、延迟高等。
• 主机网络问题: 主机网络配置错误、端口占用等。
• Docker网络问题: overlay网络跨节点通信失败、bridge网络隔离问题等。

配置说明

进入容器的网络命名空间

共享目标容器的网络命名空间：

bash
docker run -it --net container:<容器名称> cirocosta/netshoot

进入主机的网络命名空间

使用主机网络命名空间：

bash
docker run -it --net host cirocosta/netshoot

进入Docker网络的命名空间

排查Docker网络本身问题：

bash
# 启动特权模式并挂载网络命名空间目录
docker run -it --rm -v /var/run/docker/netns:/var/run/docker/netns --privileged=true cirocosta/netshoot
# 进入目标网络命名空间（示例：overlay网络ID为9tp0f348donsdj75pktssd97b）
nsenter --net=/var/run/docker/netns/1-9tp0f348do sh

工具使用示例

iperf：测试网络性能

bash
# 创建overlay网络
docker network create -d overlay perf-test
# 启动服务端
docker service create --name perf-test-a --network perf-test cirocosta/netshoot iperf -s -p 9999
# 启动客户端
docker service create --name perf-test-b --network perf-test cirocosta/netshoot iperf -c perf-test-a -p 9999
# 查看服务端日志
docker logs <perf-test-a容器ID>

tcpdump：抓包分析

bash
docker run -it --net container:<目标容器名称> cirocosta/netshoot
# 抓eth0接口9999端口的包
tcpdump -i eth0 port 9999 -c 1 -Xvv

netstat：查看网络连接

bash
docker run -it --net container:<目标容器名称> cirocosta/netshoot
netstat -tulpn

反馈与贡献

欢迎通过提交PR提供反馈或贡献新的诊断工具及使用案例。