antrea/toolbox

Docker 网络工具镜像文档

1. 镜像概述和主要用途

该Docker镜像基于Ubuntu系统构建，集成了多种网络诊断与测试工具，专为容器网络环境的故障排查和连通性测试设计。其核心目标是提供一个开箱即用的网络工具集，帮助用户快速定位和解决容器网络相关问题。

2. 核心功能和特性

2.1 核心功能

• 提供容器网络故障排查能力，支持网络连通性、DNS解析、路由跟踪等场景。
• 集成常用网络测试工具，满足基础网络诊断需求。

2.2 主要特性

• 基于Ubuntu：依托Ubuntu系统的稳定性和兼容性，确保工具运行环境可靠。
• 工具集丰富：包含ping、traceroute、nslookup、dig、tcpdump、netstat、ss、curl、wget等主流网络工具（完整列表可参考源码仓库）。
• 可扩展性：支持通过源码仓库反馈工具需求，持续优化工具覆盖范围。

3. 使用场景和适用范围

3.1 典型使用场景

• 容器网络故障排查：诊断容器间通信失败、外部服务访问异常、DNS解析错误等问题。
• 网络连通性测试：验证容器与主机、容器与容器、容器与外部网络的连通性。
• 网络配置验证：检查容器网络模式（如bridge、host、overlay）下的路由、IP、端口映射等配置。
• 临时网络环境测试：在无本地工具的环境中快速执行网络命令（如临时测试Kubernetes Pod网络）。

3.2 适用范围

• 容器化应用开发/测试环境
• 生产环境容器网络问题诊断
• 运维人员日常网络故障处理

4. 使用方法和配置说明

4.1 基础使用（Docker Run）

4.1.1 交互式运行（推荐故障排查）

启动容器并进入交互式终端，直接使用工具：

bash
docker run -it --rm antrea/toolbox:latest

参数说明：-it 启用交互式终端，--rm 退出后自动删除容器，避免残留。

4.1.2 执行单次命令

无需进入终端，直接执行特定网络命令（如测试DNS解析）：

bash
# 测试DNS解析
docker run --rm antrea/toolbox:latest nslookup kubernetes.default.svc.cluster.local

# 测试网络连通性
docker run --rm antrea/toolbox:latest ping -c 3 example.com

# 跟踪路由
docker run --rm antrea/toolbox:latest traceroute example.com

4.1.3 接入目标容器网络命名空间

通过--net=container:<container_id>进入其他容器的网络命名空间，诊断目标容器的网络环境：

bash
# 获取目标容器ID
CONTAINER_ID=$(docker ps -qf "name=<target_container_name>")

# 进入目标容器网络命名空间执行命令
docker run -it --rm --net=container:$CONTAINER_ID antrea/toolbox:latest

4.2 Docker Compose 配置示例

在docker-compose.yml中集成该镜像，用于服务网络测试：

yaml
version: '3'
services:
  network-tool:
    image: antrea/toolbox:latest
    tty: true  # 保持终端活跃
    networks:
      - app-network  # 接入目标网络

networks:
  app-network:  # 与待测试服务共享网络
    external: true  # 假设已存在外部网络

启动：docker-compose up -d，进入容器：docker-compose exec network-tool bash。

4.3 常用工具使用示例

5. 配置参数和环境变量

该镜像无需额外环境变量或配置参数，默认集成所有工具。若需自定义网络环境，可通过Docker运行参数调整：

• --net：指定网络模式（如host、container:<id>、自定义网络）。
• -v：挂载主机网络配置文件（如-v /etc/resolv.conf:/etc/resolv.conf测试DNS配置）。

6. 注意事项

• 镜像大小：工具完整性优先于镜像大小，体积可能略大于极简基础镜像。
• 工具更新：工具版本随Ubuntu基础镜像更新，如需特定版本工具，可通过源码仓库构建自定义镜像。
• 反馈与建议：缺失关键工具时，可通过https://github.com/antrea-io/image-utils/tree/main/images/toolbox%E6%8F%90%E4%BA%A4issue%E6%88%96PR%E3%80%82

更多细节请参考https://github.com/antrea-io/image-utils/tree/main/images/toolbox%E3%80%82