antrea查看 Docker Hub 原文页
用于容器网络故障排查和测试的网络工具
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 交互式运行(推荐故障排查)
启动容器并进入交互式终端,直接使用工具:
bashdocker 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中集成该镜像,用于服务网络测试:
yamlversion: '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 |
dig | DNS详细查询 | 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。
antrea 命名空间的其他可用镜像:
antrea/antrea-ubuntu
Antrea Ubuntu 网络插件,适合 Kubernetes CNI 与网络策略
antrea/golang
Antrea Golang 构建环境,适合 Kubernetes 网络插件开发
antrea/antrea-migrator
Antrea 迁移工具,适合 Calico 到 Antrea CNI 迁移
antrea/antrea-ubuntu-arm
Antrea Ubuntu Arm 容器镜像,适合 antrea 维护的 Antrea Ubuntu Arm 工作负载部署
antrea/antrea-controller-ubi
Antrea Controller Ubi 容器镜像,适合 antrea 维护的 Antrea Controller Ubi 工作负载部署
antrea/antrea-agent-ubuntu
Antrea Agent Ubuntu 容器镜像,适合 antrea 维护的 Antrea Agent Ubuntu 工作负载部署
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull antrea/toolbox:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务