woozymasta/network-multitool

Network-Multitool 镜像

这是一个基于Alpine Linux的容器/网络测试与故障排除多工具镜像。它包含大量网络工具，同时内置Nginx Web服务器（默认监听80和443端口），方便用户直接通过exec进入容器使用各类工具。该镜像基于https://github.com/Praqma/Network-MultiTool%E8%BF%9B%E8%A1%8C%E6%89%A9%E5%B1%95%E3%80%82

镜像下载地址

• Docker Hub: https://hub.docker.com/r/woozymasta/network-multitool/%EF%BC%88%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%EF%BC%89

核心功能

集成多种网络诊断工具，支持自定义HTTP/HTTPS端口，适用于容器环境下的网络连通性测试、端口扫描、数据包分析等场景。

包含的工具

• apk包管理器
• Nginx Web服务器（支持自定义端口）
• 网络测试工具：wget、curl、iperf3、dig、nslookup、drill、ip、ifconfig、ethtool、mii-tool、route、ping、nmap、arp、arping、fping、traceroute、tracepath、mtr、tcpdump、tshark、telnet客户端、ssh客户端、ftp客户端、rsync、scp、netcat（nc）、socat、ApacheBench（ab）
• 文本处理工具：awk、sed、grep、cut、diff、wc、find、vi编辑器
• 系统工具：ps、netstat、ss、gzip、cpio
• 数据库客户端：mysql、postgresql
• 其他工具：kafkacat、jq、yq、git

注意：SSL证书为自签名证书（针对localhost），存储于/certs/目录。测试时可忽略证书警告，使用curl时可添加-k参数跳过验证。

配置说明

自定义HTTP/HTTPS端口

当需要将工具容器加入其他容器的IP命名空间时，若目标容器占用80/443端口，可通过环境变量HTTP_PORT和HTTPS_PORT修改端口：

bash
docker run -e HTTP_PORT=1180 -e HTTPS_PORT=1443 -p 1180:1180 -p 1443:1443 -d woozymasta/network-multitool

使用场景

• Docker/Kubernetes环境下的容器网络连通性测试
• 端口扫描与服务可用性检查
• 网络数据包捕获与分析
• 文本处理与日志分析
• 数据库连接测试

部署示例

Docker部署

bash
# 启动容器（默认端口）
docker run -d woozymasta/network-multitool
# 进入容器使用工具
docker exec -it <容器ID> bash

Kubernetes部署

bash
# 创建Pod
kubectl run multitool --image=woozymasta/network-multitool --replicas=1
# 进入Pod
kubectl exec -it <Pod名称> bash

贡献指南

欢迎贡献必要、核心、轻量且通用的工具包，以保持镜像的实用性和小巧性。

常见问题

为什么内置Web服务器？

内置Nginx可简化容器启动流程，无需额外配置即可在Docker/Kubernetes中保持容器存活，之后通过exec进入容器使用工具。Web服务器本身也可用于测试端口可达性。

找不到需要的工具怎么办？

若需特殊工具，建议基于该镜像构建自定义镜像，添加所需工具。

为什么不使用LetsEncrypt证书？

该镜像为测试工具，证书有效性无关紧要，使用自签名证书即可满足需求。