tianon/network-toolbox

网络工具箱镜像 (network-toolbox)

镜像概述

网络工具箱镜像是基于Alpine和Debian构建的轻量级Docker镜像，旨在提供一站式网络诊断与管理工具集。该镜像集成了多种常用网络工具，可快速用于网络故障排查、容器网络诊断及网络配置验证等场景，无需在目标环境中单独安装工具。

核心功能与特性

• 多基础镜像支持：基于轻量级Alpine和Debian构建，兼顾不同用户对基础系统的偏好
• 丰富网络工具集：预装多种网络诊断和管理工具，包括但不限于：
  • 网络接口管理：ip（iproute2）
  • 连通性测试：ping、traceroute、mtr
  • DNS查询：dig、nslookup、host
  • 网络状态监控：netstat、ss、lsof
  • 数据包捕获：tcpdump
  • 端口扫描与测试：telnet、nc（netcat）
  • HTTP测试：curl、wget
• 轻量级设计：基于Alpine的版本保持极小镜像体积，适合资源受限环境
• 即开即用：无需额外配置，启动容器即可直接使用所有工具

使用场景与适用范围

• 网络故障排查：快速检测网络连通性、DNS解析异常、路由问题等
• 容器网络诊断：在Docker或Kubernetes环境中，诊断容器间网络通信问题
• 网络配置验证：验证网络接口配置、防火墙规则、DNS设置有效性
• 开发/测试环境：为开发和测试人员提供便捷的网络调试工具集
• 临时网络分析：在不影响目标系统的情况下，通过容器化方式进行网络分析

使用方法与配置说明

基本使用

通过docker run命令可直接启动交互式容器，使用预装工具：

Alpine版本（默认，体积更小）

bash
docker run -it --rm tianon/network-toolbox ash

Debian版本（如需Debian基础环境）

bash
docker run -it --rm tianon/network-toolbox:debian bash

高级使用：诊断容器网络

若需诊断特定容器的网络命名空间，可通过--net=container:<container_name_or_id>参数将工具箱容器接入目标容器网络：

bash
# 诊断名为"web-service"的容器网络
docker run -it --rm --net=container:web-service tianon/network-toolbox ash

高级使用：诊断主机网络

若需诊断Docker主机网络，可挂载主机网络命名空间：

bash
docker run -it --rm --net=host tianon/network-toolbox ash

工具使用示例

在容器内可直接运行预装工具，例如：

• 查看网络接口信息：

  bash
  ip addr show
  

• 测试到目标主机的连通性：

  bash
  ping example.com
  

• 解析域名并查看详细DNS信息：

  bash
  dig example.com +trace
  

• 查看活跃网络连接：

  bash
  ss -tuln
  

• 捕获网络数据包（需添加网络权限）：

  bash
  docker run -it --rm --cap-add=NET_RAW tianon/network-toolbox tcpdump -i eth0 port 80
  

镜像获取

可通过Docker Hub获取最新镜像：

bash
docker pull tianon/network-toolbox

注意事项

• 部分工具（如tcpdump）需要NET_RAW权限，运行时需添加--cap-add=NET_RAW参数
• Alpine版本默认使用ash shell，Debian版本默认使用bash shell
• 具体预装工具列表可参考https://github.com/tianon/dockerfiles/tree/master/network-toolbox%E4%B8%AD%E7%9A%84Dockerfile