cslev/debian_networking

docker_debian_networking 镜像文档

概述

docker_debian_networking 是一个基于 Debian 系统的 Docker 镜像，其核心特点是在基础 Debian 镜像上集成了多种常用网络工具，旨在为用户提供一个开箱即用的网络调试与分析环境，无需手动安装各类网络诊断工具。

核心功能和特性

• 基础环境可靠：基于 Debian 稳定版构建，提供稳定的操作系统基础
• 网络工具集成：包含多种常用网络调试工具，如：
  • tcpdump：网络数据包捕获工具
  • iperf/iperf3：网络带宽性能测试工具
  • tshark：命令行版网络协议分析工具（Wireshark 命令行实现）
• 轻量设计：在基础 Debian 镜像上最小化扩展，保持镜像体积精简
• 即开即用：无需额外配置，启动容器即可直接使用集成的网络工具

使用场景和适用范围

• 容器网络问题排查：诊断容器间或容器与主机间的网络连通性问题
• 网络性能测试：通过 iperf/iperf3 测试主机、容器或服务间的网络带宽
• 流量捕获与分析：使用 tcpdump 或 tshark 捕获并分析网络流量
• 开发环境验证：在开发阶段验证应用程序的网络功能与协议交互
• 运维日常诊断：辅助运维人员进行网络故障定位与分析

使用方法和配置说明

基本使用

通过以下命令启动容器并进入交互模式（退出后自动清理容器）：

bash
docker run -it --rm docker.xuanyuan.run/docker_debian_networking

网络调试示例

1. 网络流量捕获（tcpdump）

如需捕获主机网络接口流量，可使用主机网络命名空间运行容器：

bash
docker run -it --rm --net=host docker.xuanyuan.run/docker_debian_networking tcpdump -i eth0 port 80

说明：--net=host 使容器共享主机网络命名空间，-i eth0 指定监听网卡，port 80 过滤 HTTP 流量

2. 网络性能测试（iperf3）

• 启动服务端：

bash
docker run -d --name iperf-server -p 5201:5201 docker.xuanyuan.run/docker_debian_networking iperf3 -s

• 客户端连接测试（替换 <server-ip> 为服务端IP）：

bash
docker run -it --rm docker.xuanyuan.run/docker_debian_networking iperf3 -c <server-ip>

3. 协议分析（tshark）

捕获并分析特定协议流量（如 DNS）：

bash
docker run -it --rm --net=host docker.xuanyuan.run/docker_debian_networking tshark -i eth0 -Y "dns"

自定义配置

如需添加额外工具，可在容器内通过 apt 包管理器安装：

bash
# 进入容器
docker run -it --rm docker.xuanyuan.run/docker_debian_networking

# 更新包索引并安装工具（示例：安装 traceroute）
apt update && apt install -y traceroute