ericwastakenondocker/network-multitool

增强型网络多工具（Network Multi-Tool Enhanced）

本Docker镜像基于优秀的wbitt/network-multitool扩展而来，集成了丰富的网络诊断工具，以及Python3、pip、jq、curl和Microsoft Azure CLI等实用组件，专为日常运维和脚本自动化场景优化。

核心功能

• 网络诊断与故障排查（curl、nc、dig、nslookup、traceroute等）
• 基于Python3的脚本编写与自动化（支持pip安装依赖包）
• 通过Azure CLI（az）管理Azure云资源
• 内置轻量Web服务器保持容器持续运行
• 支持本地文件与容器的便捷交换（通过卷映射）

使用场景

• 快速定位网络连通性问题
• 编写并执行Python自动化脚本
• 管理Azure云服务资源
• 作为轻量级工具箱进行日常运维操作

配置说明

环境变量

• HTTP_PORT: 内置HTTP服务器端口（默认参考基础镜像，示例使用8080）
• HTTPS_PORT: 内置HTTPS服务器端口（示例使用1443）

卷映射

将本地文件夹映射到/root/host-volume，实现文件交换：

sh
-v $(pwd)/host-volume:/root/host-volume

Docker CLI运行示例

sh
docker run -d \
  --name network-multitool \
  --network host \
  -e HTTP_PORT=8080 \
  -e HTTPS_PORT=1443 \
  -v $(pwd)/host-volume:/root/host-volume \
  --restart unless-stopped \
  docker.xuanyuan.run/ericwastakenondocker/network-multitool:latest

说明：使用主机网络确保工具直接访问主机网络环境，内置Web服务器维持容器活跃。

Docker Compose运行示例

创建compose.yml文件：

yaml
services:
  network-multitool:
    image: docker.xuanyuan.run/ericwastakenondocker/network-multitool:latest
    container_name: network-multitool
    hostname: network-multitool
    restart: unless-stopped
    network_mode: "host"
    environment:
      - HTTP_PORT=8080
      - HTTPS_PORT=1443
    volumes:
      - ./host-volume:/root/host-volume

启动服务：

sh
# 新版Docker
docker compose up -d
# 旧版Docker
docker-compose up -d

常用命令

• 停止容器：

  sh
  docker compose down
  # 或
  docker stop network-multitool && docker rm network-multitool
  

• 查看日志：

  sh
  docker logs -f network-multitool
  

• 进入容器终端：

  sh
  docker exec -it network-multitool /bin/bash
  

• 执行单条命令：

  sh
  # 获取公网IP
  docker exec -i network-multitool curl https://ifconfig.co
  # 查看Azure账户信息（需先az login）
  docker exec -it network-multitool az account show
  

工作原理

本镜像在基础镜像上新增以下功能：

1. Python3与pip，支持脚本运行和依赖安装
2. 隔离环境安装的Azure CLI（已加入PATH）
3. jq和curl等JSON处理与HTTP工具
4. /root/host-volume卷映射实现文件共享 内置Web服务器维持容器持续运行，用户可通过exec进入容器使用工具。

使用注意事项

• 需安装Docker（可选Docker Compose）
• 主机网络模式确保网络测试结果与主机一致
• 通过卷映射可在主机编辑脚本并在容器内运行
• 可通过构建上下文预安装Python包（详见GitHub仓库）

GitHub仓库

更多信息、辅助脚本及示例请参考： https://github.com/ericwastaken/network-multitool