weibeld/ubuntu-networking

weibeld/ubuntu-networking

镜像概述

weibeld/ubuntu-networking 是一个基于 Ubuntu 18.04 LTS 构建的 Docker 镜像，内部预装了大量常用的 TCP/IP 网络诊断、管理和抓包工具。该镜像旨在为开发者和运维人员提供一个开箱即用的网络调试环境，无需在基础镜像中手动安装各类网络依赖。

核心功能与预装工具

镜像通过 APT 包管理器集成了以下核心网络工具包及其对应的命令行工具：

使用场景

• 容器网络调试：排查 Kubernetes 或 Docker 环境中的 Pod/容器网络连通性问题。
• 故障排查：在缺乏网络工具的精简版生产镜像（如 Distroless 或 Alpine）旁运行此镜像，进行 DNS 解析、端口连通性或路由追踪测试。
• 网络抓包分析：利用 tcpdump 捕获容器网络命名空间内的流量并进行分析。
• 防火墙规则测试：测试和验证 iptables 规则对容器网络流量的影响。

使用方法

基本运行

对于大多数常规网络诊断工具（如 ping, curl, dig, netstat 等），可以直接以交互模式启动容器：

bash
docker run -it --rm weibeld/ubuntu-networking /bin/bash

特权模式运行（重要）

部分底层网络管理工具（如 iptables、tcpdump 的某些高级功能、修改网络命名空间等）需要 Linux 内核的特权权限。在使用这些工具时，必须添加 --privileged 参数启动容器：

bash
docker run -it --rm --privileged weibeld/ubuntu-networking /bin/bash

直接执行命令

如果不进入交互式 Shell，可以直接在 docker run 命令后追加需要执行的网络命令：

bash
# 测试 DNS 解析
docker run --rm weibeld/ubuntu-networking dig google.com

# 扫描目标主机的开放端口
docker run --rm weibeld/ubuntu-networking nmap -p 80,443 example.com

# 抓取指定接口的网络包
docker run --rm --privileged weibeld/ubuntu-networking tcpdump -i eth0 -n port 80

Docker Compose 配置示例

若需在 Docker Compose 环境中作为辅助调试服务运行，可参考以下配置：

yaml
version: '3.8'

services:
  network-debug:
    image: weibeld/ubuntu-networking
    container_name: net-debug
    privileged: true
    stdin_open: true
    tty: true
    # 可选：加入特定的自定义网络以调试该网络内的其他容器
    # networks:
    #   - app-network
    command: /bin/bash

# networks:
#   app-network:
#     external: true

注意事项

• 镜像基于 Ubuntu 18.04 LTS，部分预装工具（如 net-tools 中的 ifconfig）在现代 Linux 发行版中已被 iproute2（如 ip 命令）取代，建议优先使用现代工具。
• 在进行网络抓包或修改防火墙规则时，请确保您了解 --privileged 模式带来的安全风险，避免在不受信任的环境中滥用特权容器。