modem7/network-multitool

Network-Multitool

镜像概述

Network-Multitool 是一款专为容器和网络环境测试与故障排除设计的多架构（multi-arch）多功能工具镜像。该镜像主要基于 Alpine Linux 构建（同时提供适用于 RedHat 衍生环境的 Fedora 变体）。镜像内置了大量常用的网络和系统诊断工具，并默认运行一个监听 80 和 443 端口的 Nginx Web 服务器，确保容器能够以守护进程方式稳定运行，方便用户直接通过 exec 进入容器进行调试。

核心功能和特性

• 多架构支持：原生支持 linux/amd64 和 linux/arm64 平台。
• 内置 Web 服务器：默认运行 Nginx（监听 80 和 443 端口），避免容器因无前台进程而退出，同时支持自定义端口以防冲突。
• 丰富的诊断工具：涵盖网络抓包、连通性测试、DNS 解析、路由追踪等常用命令行工具。
• 轻量化设计：最小化版本压缩后仅 16 MB，额外工具版本压缩后 64 MB。
• 云原生友好：非常适合在 Kubernetes 环境中以 DaemonSet 形式部署，用于节点级别的网络排查，保持宿主机环境的不可变性。

镜像变体与包含工具

1. 最小化版本 (latest, alpine-minimal)

默认的基础镜像，体积小巧（压缩 16 MB / 解压 38 MB），包含核心排查工具：

• 包管理：apk
• Web 服务：Nginx (端口 80, 443)
• 文本处理：awk, cut, diff, find, grep, sed, vi, wc
• 网络请求：curl, wget
• DNS 工具：dig, nslookup
• 网络配置：ip, ifconfig, route
• 路由追踪：traceroute, tracepath, mtr, tcptraceroute
• 连通性测试：ping, arp, arping, telnet
• 系统监控：ps, netstat, tcpdump
• 其他工具：gzip, cpio, tar, jq, bash

2. 扩展版本 (alpine-extra)

在最小化版本基础上增加了更多高级网络和数据库工具（压缩 64 MB / 解压 220 MB）：

• 网络测试：iperf3, nmap, netcat (nc), socat, ApacheBench (ab)
• 抓包与分析：tshark
• 网络配置：ethtool, mii-tool, ss
• 远程与传输：ssh client, lftp client, rsync, scp
• 数据库客户端：mysql, postgresql
• 版本控制：git

使用场景和适用范围

• 容器网络调试：在 Docker 或 Kubernetes 集群中排查 Pod/容器间的网络连通性、DNS 解析和路由问题。
• 宿主机网络排查：通过挂载宿主机网络命名空间（Host Network），排查节点级别的网络故障，而无需在宿主机上安装额外软件。
• 端口冲突排查：利用自定义端口功能，与现有的 Web 服务器或反向代理共享同一 IP 命名空间进行对比测试。

详细使用方法和配置说明

环境变量配置

镜像支持通过环境变量自定义 Nginx 监听的端口，以解决与同一网络命名空间内其他 Web 服务（如 Nginx, Traefik, HAProxy）的端口冲突问题：

• HTTP_PORT：自定义 HTTP 监听端口（默认为 80）。
• HTTPS_PORT：自定义 HTTPS 监听端口（默认为 443）。

Docker 部署示例

1. 在普通容器网络中运行

启动容器并进入交互式 Shell 进行调试：

bash
# 后台启动容器
docker run -d --name network-debug docker.xuanyuan.run/modem7/network-multitool

# 进入容器
docker exec -it network-debug /bin/bash

2. 在宿主机网络中运行

使用宿主机网络命名空间进行节点级网络排查：

bash
docker run --network host -d --name network-debug-host docker.xuanyuan.run/modem7/network-multitool

注意：如果宿主机的 80 或 443 端口已被占用，请通过环境变量修改端口：

bash
docker run --network host -e HTTP_PORT=1180 -e HTTPS_PORT=11443 -d --name network-debug-host docker.xuanyuan.run/modem7/network-multitool

3. 自定义端口并映射（Docker Compose 示例）

当需要与其他容器共享网络或进行特定端口映射时，可使用以下 docker-compose.yml 配置：

yaml
version: '3.8'
services:
  multitool:
    image: docker.xuanyuan.run/modem7/network-multitool:alpine-extra
    container_name: network-multitool
    environment:
      - HTTP_PORT=1180
      - HTTPS_PORT=11443
    ports:
      - "1180:1180"
      - "11443:11443"
    restart: unless-stopped

Kubernetes DaemonSet 部署建议

在 Kubernetes 环境中，建议使用 DaemonSet 部署此镜像以排查节点网络。这种方式符合云原生理念，能够保持基础设施的不可变性，避免直接在 Worker 节点上安装工具导致的依赖冲突或系统破坏，同时支持通过 Volume 挂载持久化抓包文件。

常见问题 (FAQ)

Q: 为什么镜像内置并运行 Web 服务器？ A: 如果容器没有运行守护进程或前台服务，容器启动后会立即退出。内置 Nginx 作为默认前台进程，可以确保容器保持 UP 状态，方便用户随时通过 docker exec 或 kubectl exec 进入容器，而无需使用 sleep infinity 等非标准手段维持容器运行。

Q: 为什么不使用 LetsEncrypt 申请真实的 SSL 证书？ A: 这是一个用于测试和故障排除的工具，重点在于网络连通性和服务可用性，SSL 证书的有效性在此场景下并不重要，使用自签名证书即可满足 HTTPS 测试需求。