gitlabhost/docker-network-test

Docker网络连接性测试容器

镜像概述

本镜像是一个轻量级Docker容器，专为测试Docker环境中的网络连接性而设计。它集成了常用的网络诊断工具，帮助开发者和运维人员快速验证容器间通信、外部网络访问及网络配置的正确性，简化Docker网络故障排查流程。

核心功能和特性

• 多协议网络测试：支持ICMP (ping)、TCP、UDP、HTTP/HTTPS等多种网络协议测试
• 端口可达性验证：可检测目标容器或主机的特定端口是否开放并响应
• DNS解析测试：提供域名解析功能，验证Docker环境中的DNS配置有效性
• 跨网络模式支持：兼容Docker默认bridge、host、overlay、macvlan等多种网络模式
• 轻量级设计：基于Alpine Linux构建，镜像体积小，启动速度快，资源占用低
• 丰富工具集：内置ping、curl、wget、nc (netcat)、dig、nslookup等网络诊断工具

使用场景和适用范围

• Docker容器网络故障排查（如容器间无法通信、外部网络访问失败等）
• 新部署容器的网络连通性快速验证
• 多容器应用（如微服务架构）的网络依赖关系测试
• Docker网络模式（bridge/host/overlay）配置正确性验证
• CI/CD流水线中容器网络连通性的自动化测试环节
• 网络策略（如iptables、Docker网络规则）生效验证

使用方法和配置说明

基本使用（docker run命令）

1. 简单网络连通性测试

bash
# 测试与目标主机的ICMP连通性（ping）
docker run --rm network-test-container ping -c 4 example.com

# 测试目标容器的TCP端口可达性（如测试web容器的80端口）
docker run --rm network-test-container nc -zv web-container 80

# 测试HTTP服务可用性
docker run --rm network-test-container curl -I http://web-container:80

2. 指定Docker网络模式

bash
# 使用host网络模式测试主机网络栈
docker run --rm --net=host network-test-container ping -c 4 192.168.1.1

# 连接到指定自定义网络测试容器通信
docker run --rm --net=my-custom-network network-test-container curl http://service-in-custom-network:3000

3. DNS解析测试

bash
# 验证容器内DNS解析功能
docker run --rm network-test-container nslookup docker.com
docker run --rm network-test-container dig @8.8.8.8 google.com

Docker Compose配置示例

在多容器应用中集成网络测试容器，验证服务间连通性：

yaml
version: '3'
services:
  web:
    image: nginx:alpine
    networks:
      - app-network

  # 网络测试容器
  network-tester:
    image: network-test-container
    depends_on:
      - web
    networks:
      - app-network
    command: ["curl", "-I", "http://web:80"]  # 启动时自动测试web服务连通性

networks:
  app-network:
    driver: bridge

环境变量配置

支持通过环境变量自定义测试行为：

• TIMEOUT：设置网络测试超时时间（秒），默认5秒

  bash
  docker run --rm -e TIMEOUT=10 network-test-container nc -zv slow-service 443
  

• TARGET_HOST：预设默认测试目标主机，简化命令

  bash
  docker run --rm -e TARGET_HOST=web-service network-test-container curl http://$TARGET_HOST:8080
  

注意事项

1. ICMP限制：部分Docker环境（如某些Linux发行版）默认禁用容器ICMP ping功能，需添加--cap-add=NET_RAW权限：

   bash
   docker run --rm --cap-add=NET_RAW network-test-container ping host.docker.internal
   

2. 网络模式权限：使用--net=host模式时需注意主机网络安全，避免不必要的权限暴露
3. 跨网络通信：测试跨Docker网络通信时，需确保网络间已配置正确的连接（如使用docker network connect）

常用工具列表

容器内置以下网络诊断工具，可直接通过命令调用：

• ping：ICMP网络可达性测试
• nc/netcat：TCP/UDP端口测试
• curl/wget：HTTP/HTTPS连接测试
• nslookup/dig：DNS解析测试
• ip/ifconfig：网络接口和IP配置查看
• traceroute：网络路径追踪（需添加--cap-add=NET_ADMIN权限）