halfcrazy/toolbox

halfcrazy/toolbox 镜像文档

镜像概述

halfcrazy/toolbox 是一款专为网络问题诊断设计的调试镜像，集成了 nginx 服务器及多种网络诊断工具，可用于快速排查网络连接、IP 配置、流量分析等问题。

核心功能与特性

1. nginx 服务功能

• 提供两个 URI 接口：
  • /remote_addr：返回客户端 IP 地址（$remote_addr）
  • /server_addr：返回服务器 IP 地址（$server_addr）

2. 网络诊断工具集

集成多种常用网络调试工具，包括：

• iptables：防火墙规则管理
• ipvsadm：IP 虚拟服务器管理工具
• tcpdump：网络数据包捕获与分析
• iperf：网络带宽测试工具
• ab（Apache Bench）：HTTP 性能测试工具

3. 端口自定义配置

支持通过环境变量 PORT 覆盖默认 nginx 端口（默认端口为 80）。

使用场景

• 网络连通性测试：验证客户端与服务器之间的网络可达性
• IP 地址验证：快速获取客户端与服务器的 IP 地址信息
• 网络流量分析：使用 tcpdump 捕获和分析网络数据包
• 性能测试：通过 iperf 和 ab 测试网络带宽及 HTTP 服务性能
• 防火墙与负载均衡调试：利用 iptables 和 ipvsadm 排查规则配置问题

使用方法

基本运行命令

bash
docker run -d --name network-toolbox -p 80:80 halfcrazy/toolbox

自定义端口配置

如需修改默认端口（例如改为 8080），通过 -e PORT 指定环境变量：

bash
docker run -d --name network-toolbox -p 8080:8080 -e PORT=8080 halfcrazy/toolbox

访问 nginx 接口

容器运行后，可通过以下 URL 访问接口：

• 获取客户端 IP：http://<容器IP或主机IP>:<端口>/remote_addr
• 获取服务器 IP：http://<容器IP或主机IP>:<端口>/server_addr

进入容器使用工具

通过以下命令进入容器内部，直接使用集成的网络工具：

bash
docker exec -it network-toolbox /bin/sh

进入后可直接执行工具命令，例如：

• 捕获网络包：tcpdump -i eth0
• 测试带宽：iperf -s（服务端）或 iperf -c <目标IP>（客户端）
• HTTP 性能测试：ab -n 1000 -c 10 http://<目标URL>/