toolbox

Toolbox Docker 镜像

用于容器网络故障排查和测试的网络工具

4 次收藏下载次数: 0状态:社区镜像维护者:antrea仓库类型:镜像最近更新:
下载命令
点击查看

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 docker.xuanyuan.run/antrea/toolbox:latest

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

4.1.2 执行单次命令

无需进入终端,直接执行特定网络命令(如测试DNS解析):

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

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

# 跟踪路由
docker run --rm docker.xuanyuan.run/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 docker.xuanyuan.run/antrea/toolbox:latest

4.2 Docker Compose 配置示例

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

yaml
version: '3'
services:
  network-tool:
    image: docker.xuanyuan.run/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 常用工具使用示例

工具用途示例命令
ping测试网络连通性ping -c 4 10.0.0.1
traceroute跟踪数据包路由路径traceroute 8.8.8.8
tcpdump网络抓包tcpdump -i eth0 port 80
digDNS详细查询dig @8.8.8.8 example.com A
ss查看网络连接状态ss -tuln (TCP/UDP监听端口)

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提交issue或PR。

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

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 toolbox 镜像标签

docker pull docker.xuanyuan.run/antrea/toolbox:<标签>

DockerHub 原生拉取命令

docker pull antrea/toolbox:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告