praqma/network-multitool

Network-MultiTool

镜像概述和主要用途

wbitt/network-multitool 是一款多架构的容器网络测试与故障排查工具，前身为 praqma/network-multitool。该镜像基于Alpine Linux（也提供Fedora变体），集成了丰富的网络诊断工具和Nginx Web服务器（默认监听80和443端口），旨在为容器和网络环境提供便捷的测试与故障排查能力。

重要名称变更说明：2022年1月5日起，原 praqma/network-multitool 迁移至 wbitt/network-multitool。旧镜像 praqma/network-multitool 将在未来数月内继续可用，但建议使用新镜像。

核心功能和特性

支持平台

• linux/386
• linux/amd64
• linux/arm/v7
• linux/arm64

镜像变体（标签）

OpenShift变体注意事项

• 以非root用户运行，部分工具（如traceroute）可能不可用
• 监听端口为1180（HTTP）和***（HTTPS），非默认80/443
• 以下工具通过setuid配置保持可用性：apk、arping、busybox、mii-tool、tcpdump、tcptraceroute、traceroute、tshark

工具列表

minimal系列（latest, minimal, alpine-minimal, openshift, openshift-minimal）

• 包管理：apk
• Web服务：Nginx（可自定义端口）
• 基础工具：awk, cut, diff, find, grep, sed, vi, wc
• 网络工具：curl, wget, dig, nslookup, ip, ifconfig, route, traceroute, tracepath, mtr, tcptraceroute, ping, arp, arping, netstat, tcpdump
• 其他：ps, gzip, cpio, tar, telnet client, jq, bash
• 大小：压缩16MB，未压缩38MB

extra系列（extra, alpine-extra, openshift-extra）

包含minimal系列所有工具，额外增加：

• iperf3, ethtool, mii-tool, route, nmap, ss, tshark, ssh client, lftp client, rsync, scp, netcat(nc), socat, ApacheBench(ab), mysql client, postgresql client, git
• 大小：压缩64MB，未压缩220MB

fedora系列（fedora, fedora-minimal）

• 包管理：YUM
• Web服务：Nginx（可自定义端口）
• 工具：wget, curl, dig, nslookup, ip, ifconfig, route, traceroute, tracepath, mtr, ping, arp, arping, ps, netstat, gzip, cpio, tar, telnet client, awk, cut, diff, find, grep, sed, vi, wc, jq
• 大小：未压缩72MB

使用场景和适用范围

• 容器网络连通性测试
• Kubernetes/OpenShift集群网络故障排查
• 主机网络环境诊断
• 多架构环境下的网络工具统一部署
• 临时网络工具集快速部署

使用方法和配置说明

镜像拉取

bash
docker pull docker.xuanyuan.run/wbitt/network-multitool

基础使用（容器网络环境）

Docker

bash
# 启动容器
docker run -d docker.xuanyuan.run/wbitt/network-multitool

# 进入容器
docker exec -it <container-name> /bin/bash

Kubernetes

bash
# 创建独立Pod
kubectl run multitool --image=wbitt/network-multitool

# 创建Deployment
kubectl create deployment multitool --image=wbitt/network-multitool

# 进入Pod
kubectl exec -it <pod-name> /bin/bash

OpenShift

bash
# 创建项目
oc new-project test-project-1

# 部署OpenShift变体
oc new-app wbitt/network-multitool:openshift --name multitool-openshift

# 查看状态和Pod
oc status
oc get pods

# 进入Pod
oc exec -it <pod-name> /bin/sh

# 端口转发
oc port-forward <pod-name> 1180:1180 11443:11443

主机网络环境使用

Docker

bash
# 使用主机网络
docker run --network host -d docker.xuanyuan.run/wbitt/network-multitool

# 若80/443端口被占用，自定义端口
docker run --network host -e HTTP_PORT=1180 -e HTTPS_PORT=11443 -d docker.xuanyuan.run/wbitt/network-multitool

Kubernetes

通过DaemonSet在所有节点部署（使用主机网络）：

bash
# 应用DaemonSet配置（需从GitHub获取multitool-daemonset.yaml）
kubectl apply -f kubernetes/multitool-daemonset.yaml

注：默认使用1180/***端口避免冲突，可在YAML中修改端口。

自定义HTTP/HTTPS端口

通过环境变量HTTP_PORT和HTTPS_PORT自定义Nginx监听端口：

bash
docker run -e HTTP_PORT=1180 -e HTTPS_PORT=11443 \
  -p 1180:1180 -p 11443:11443 -d docker.xuanyuan.run/wbitt/network-multitool

验证：

bash
curl http://localhost:1180
curl -k https://localhost:11443  # -k忽略自签名证书警告

常见问题（FAQs）

为什么工具中包含Web服务器？

为避免容器因无后台进程而退出，Nginx作为默认进程使容器保持运行状态，便于直接exec进入容器使用工具，同时也可作为网络测试的目标服务。

缺少需要的工具怎么办？

该镜像聚焦常用核心工具，若需特殊工具，建议基于此镜像构建自定义镜像，添加所需工具。

为什么使用自签名SSL证书而非Let's Encrypt？

作为测试工具，证书有效性不影响功能，自签名证书可满足测试需求。

为何在Kubernetes中使用DaemonSet排查主机网络？

• 避免在节点安装工具，保持基础设施不可变性
• 无需SSH登录节点，通过exec直接访问
• 便于跨节点统一部署和管理
• 可集成存储卷用于数据包捕获等场景

如何贡献？

欢迎贡献“必要的、核心的、轻量的、多场景适用”的工具，但需保持镜像精简，避免膨胀为完整Linux发行版。

相关链接

• GitHub仓库：https://github.com/wbitt/Network-MultiTool
• Docker Hub：https://hub.docker.com/r/wbitt/network-multitool