calacaly/netbox

netbox 网络测试工具镜像

镜像概述

netbox是基于Alpine Linux的轻量级网络测试工具镜像，提供两个版本（v1和v2），集成了多种常用网络诊断与测试工具，适用于网络连通性验证、端口扫描、流量分析、性能测试等场景，满足开发调试与运维诊断需求。

核心功能与特性

基础特性

• 基于Alpine Linux，镜像体积小、启动快速
• 包含基础网络工具，支持多种网络诊断场景
• 两个版本（v1/v2）提供差异化工具集，适应不同测试需求

版本工具对比

netbox:v1

• 基础网络工具：net-tools、netcat、tcpdump
• 数据传输工具：wget、curl
• DNS诊断工具：dig、nslookup
• 端口与服务测试：telnet、nmap
• TCP连通性测试：
  • tcping-cloverstd（来自https://github.com/cloverstd/tcping%EF%BC%89
  • tcping-i3h（来自https://github.com/i3h/tcping%EF%BC%89

netbox:v2（在v1基础上增强）

• 保留v1核心工具（net-tools、netcat、tcpdump、wget、curl、dig、nslookup、telnet、nmap）
• 新增性能测试工具：iperf3
• 新增加密工具：openssl
• 优化TCP测试工具：tcping（来自https://github.com/calacaly/tcping%EF%BC%89
• 新增网络路径跟踪工具：trip（来自https://github.com/fujiapple852/trippy%EF%BC%89

使用场景

• 开发环境网络连通性调试（如容器间通信、服务端口可达性）
• 运维场景网络故障排查（如DNS解析异常、端口阻塞、流量异常）
• 网络性能测试（带宽测试、延迟测量、路径跟踪）
• 临时网络工具环境（无需在主机安装完整工具链）

使用方法

拉取镜像

bash
# 拉取v1版本
docker pull netbox:v1

# 拉取v2版本（推荐，工具更全面）
docker pull netbox:v2

基本使用（交互模式）

bash
# 启动容器并进入交互式shell
docker run -it --rm netbox:v2 sh

常用工具示例

1. 端口连通性测试（v2使用tcping）

bash
# 测试目标主机80端口连通性
tcping example.com 80

2. 网络性能测试（v2使用iperf3）

bash
# 作为服务端（监听5201端口）
iperf3 -s

# 作为客户端（连接服务端）
iperf3 -c 192.168.1.100

3. 流量捕获（使用tcpdump）

bash
# 捕获eth0接口流量并保存到文件
tcpdump -i eth0 -w capture.pcap

4. 网络路径跟踪（v2使用trip）

bash
# 跟踪到目标主机的网络路径
trip example.com

5. DNS解析测试（使用dig）

bash
# 解析域名A记录
dig example.com A

注意事项

• 部分工具（如nmap、tcpdump）可能需要额外权限，运行容器时可添加--cap-add=NET_RAW参数获取网络原始套接字权限
• v2版本在v1基础上优化了工具集，推荐优先使用v2版本
• 工具使用方法可通过工具名 --help查看详细参数