donlinglok/network-multitool

镜像概述

本镜像是知名网络调试工具 wbitt/Network-MultiTool 的一个补丁与变通方案（Workaround）分支。它专为 Docker 和 Kubernetes 环境下的网络故障排除而设计。针对原项目中的特定问题（参考原项目 PR #3），此版本特意移除了 Nginx 相关功能，以确保在特定环境下的稳定性和兼容性，提供一个更纯粹的网络诊断工具集。

核心功能和特性

• 丰富的网络工具集：内置 curl、wget、ping、traceroute、dig、nslookup、netcat、iperf 等常用网络诊断工具。
• 移除 Nginx 功能：作为补丁版本，本镜像不包含原项目中的 Nginx Web 服务器特性，避免了因 Nginx 引起的特定冲突或兼容性问题。
• 跨平台支持：支持在多种容器编排平台（如 Docker、Kubernetes、OpenShift）中快速启动和运行。
• 轻量且专注：去除了不必要的 Web 服务组件，使镜像更加专注于底层网络连通性和协议诊断。

使用场景和适用范围

• 容器网络连通性测试：测试 Pod 或容器之间的网络互通情况。
• DNS 解析排查：使用 dig 或 nslookup 验证集群内部或外部的 DNS 解析是否正常。
• 路由与延迟分析：通过 ping 和 traceroute 排查网络丢包、延迟及路由节点问题。
• 端口与服务探测：使用 netcat (nc) 或 curl 测试特定端口的开放状态及 HTTP/TCP 服务响应。
• 带宽与性能测试：利用 iperf 进行容器间的网络吞吐量测试。

详细的使用方法和配置说明

Docker 部署示例

交互式运行（推荐用于临时调试）

bash
docker run -it --rm <image_name>:<tag> /bin/bash

后台运行并执行特定命令

bash
docker run -d --name net-tool <image_name>:<tag> sleep infinity
docker exec -it net-tool ping 8.8.8.8

Kubernetes 部署示例

在 Kubernetes 集群中，通常使用 kubectl run 快速启动一个调试 Pod：

bash
kubectl run network-multitool --image=<image_name>:<tag> --restart=Never -- sleep infinity
kubectl exec -it network-multitool -- /bin/bash

或者使用 Deployment 保持 Pod 常驻：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: network-multitool
spec:
  replicas: 1
  selector:
    matchLabels:
      app: network-multitool
  template:
    metadata:
      labels:
        app: network-multitool
    spec:
      containers:
      - name: network-multitool
        image: <image_name>:<tag>
        command: ["sleep", "infinity"]

常用网络诊断命令示例

进入容器后，可执行以下常见排查命令：

bash
# 测试 DNS 解析
dig kubernetes.default.svc.cluster.local

# 测试 HTTP 连通性及响应头
curl -I https://www.google.com

# 追踪路由节点
traceroute 8.8.8.8

# 测试 TCP 端口连通性
nc -zv kubernetes.default.svc.cluster.local 443

# 启动 iperf 服务端进行带宽测试
iperf -s

注意事项

• 无 Nginx 支持：本镜像不包含 Nginx 功能。如果您需要测试 HTTP 服务器响应或使用 Nginx 进行反向代理测试，请使用原版 wbitt/Network-MultiTool 镜像。
• 权限问题：部分网络工具（如 traceroute 或原始套接字 ping）可能需要 root 权限或特定的 Linux Capabilities（如 NET_RAW）。在 Kubernetes 中运行时，请确保 Pod 的安全上下文（SecurityContext）允许这些操作。