docker-netutils 镜像文档

概述

docker-netutils 是一个预装常用网络工具的 Docker 镜像，旨在提供便捷的网络诊断与调试能力。该镜像基于 Ubuntu 或 Alpine 系统构建，包含 ping、ifconfig、curl、traceroute 等网络工具，适用于快速排查容器网络问题、测试网络连通性及执行临时网络操作。

核心功能与特性

预装网络工具

包含多种网络诊断与调试工具，主要包括：

• ping：测试网络连通性
• ifconfig/ip：网络接口配置与信息查询
• curl：HTTP/HTTPS 请求测试
• traceroute：路由路径跟踪
• nslookup/dig：DNS 解析测试
• netstat：网络连接状态查看
• telnet：远程端口连通性测试

多基础镜像支持

提供两种基础镜像版本，满足不同场景需求：

• Ubuntu 版本（latest/ubuntu 标签）：基于 Ubuntu 系统，工具兼容性好，功能全面
• Alpine 版本（alpine 标签）：基于 Alpine Linux，镜像体积更小（约 10MB 级别），资源占用低

使用场景与适用范围

典型使用场景

• 容器网络故障排查：测试容器与外部服务、其他容器的网络连通性
• 网络配置验证：检查 DNS 解析、路由规则、端口映射有效性
• 临时网络工具需求：无需在主机或目标容器中安装工具，直接通过该镜像执行临时网络操作
• 跨网络环境测试：指定 Docker 网络（--network）测试容器在特定网络中的网络行为

适用人群

• 开发人员：调试容器化应用的网络连接问题
• 运维人员：排查容器集群或主机的网络故障
• DevOps 工程师：验证容器网络配置与服务发现功能

使用方法

交互式运行

通过交互式终端运行镜像，可连续执行多个网络命令：

docker run -it --rm --network=MYNETWORK dersimn/netutils

参数说明：

• -it：启用交互式终端（-i 保持标准输入打开，-t 分配伪终端）
• --rm：容器退出后自动删除，避免残留
• --network=MYNETWORK：指定容器连接的 Docker 网络（替换 MYNETWORK 为实际网络名称，如 bridge、host 或自定义网络）
• dersimn/netutils：默认使用 latest 标签（Ubuntu 版本）

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

ping 8.8.8.8          # 测试与 Google DNS 的连通性
curl [***]  # 测试 HTTP 请求
ifconfig              # 查看容器网络接口信息
nslookup github.com   # 解析域名

单命令运行

直接执行单个网络命令，无需进入交互式终端：

docker run --rm --network=MYNETWORK dersimn/netutils ping 8.8.8.8

常用命令示例：

• 测试 DNS 解析：

  docker run --rm dersimn/netutils nslookup docker.com
  

• 跟踪路由路径：

  docker run --rm --network=my_custom_network dersimn/netutils traceroute 192.168.1.1
  

• 测试 TCP 端口连通性：

  docker run --rm dersimn/netutils telnet example.com 80
  

指定镜像标签

使用 Alpine 版本（轻量级）：

# 交互式运行 Alpine 版本
docker run -it --rm dersimn/netutils:alpine

# 单命令运行 Alpine 版本
docker run --rm dersimn/netutils:alpine curl ifconfig.me

配置参数说明

镜像标签

源代码与反馈

镜像的 Dockerfile 及构建细节可在 GitHub 查看：
[***]

如有问题或功能建议，欢迎通过 GitHub Issues 提交反馈。