someguy123/net-tools

Docker Networking Toolkit 镜像文档

镜像概述和主要用途

这是一个基于Ubuntu 18.04 LTS构建的Docker镜像，预装了多种网络工具，专为网络调试设计。由于官方Ubuntu Docker镜像不包含任何网络工具（甚至基础的ifconfig、route或ip），使其在基本网络任务中几乎无用，因此创建了此镜像。最初为网络原型工具GNS3开发，特别适合通过GNS3的Docker支持进行拓扑故障排除和测试，无需设置臃肿的Linux虚拟机。

核心功能和特性

• 增强的终端体验：包含bash-completion（提升bash选项卡补全）和command-not-found（当输入不存在的命令时，提示该命令所在的包），以及带时间戳的彩色bash提示符。
• 常用工具集成：包含tmux、screen（多终端会话管理）、vim和nano（文本编辑器），使镜像体验更接近普通虚拟机而非精简容器。
• 全面的网络工具集：涵盖从基础网络诊断到高级数据包分析的完整工具链。

包含内容

• bash-completion - 提升bash的选项卡补全功能
• command-not-found - 当输入不存在的命令时，提示该命令所在的包
• mtr-tiny - 快速易读的实时IPv4和IPv6跟踪路由（精简版，无GTK冗余）
• dnsutils - 提供dig和nslookup等DNS调试工具
• net-tools - 基础网络工具，如ifconfig、netstat、route、arp
• nmap - 端口扫描和其他网络侦察工具
• traceroute - 跟踪路由工具，mtr的替代方案
• netcat - nc工具，多功能TCP/UDP/UNIX套接字客户端和服务器
• iproute2 - 提供ip和bridge工具，用于高级网络配置
• tcpdump - 类似Wireshark的命令行网络数据包分析工具
• iputils-ping - ping命令工具，同一二进制文件支持IPv4和IPv6（无需分别使用ping和ping6）
• openssh - SSH服务器和客户端，用于测试SSH连接，可通过SSH进入容器获得更好体验
• tmux - 在单个终端会话中运行多个任务，支持标签和分屏
• screen - 类似tmux，用于在后台运行任务
• vim/nano - 文本编辑器（注意：容器内文件不持久化，建议使用卷）

使用场景和适用范围

• GNS3网络拓扑调试：作为GNS3的Docker节点，测试和排除网络拓扑中的连接问题
• 容器网络故障排除：调试Docker容器之间或容器与外部网络的连接问题
• 临时网络测试环境：快速部署包含完整网络工具集的环境，进行网络诊断、DNS测试、路由分析等

使用方法和配置说明

基本用法

建议通过SSH连接容器以获得更好的终端体验，需转发SSH端口。

注意：SSH密码仅为3个字符（net），容器内无防火墙，也无fail2ban等速率限制。若将SSH端口随意暴露到互联网，容器可能面临安全风险。

启动容器并转发SSH端口

bash
docker run --name nettools -p 127.0.0.1:2222:22 -itd someguy123/net-tools

通过SSH连接容器

使用用户名root和密码net连接：

bash
ssh root@127.0.0.1 -p 2222

root@127.0.0.1's password:
Welcome to Ubuntu 18.04.1 LTS

04:05:59 32b9bd38c2f9:~ # ping 8.8.4.4
PING 8.8.4.4 (8.8.4.4) 56(84) bytes of data.
64 bytes from 8.8.4.4: icmp_seq=1 ttl=37 time=16.8 ms
64 bytes from 8.8.4.4: icmp_seq=2 ttl=37 time=16.3 ms

不使用SSH直接进入容器

若无需SSH，可移除端口转发参数，直接通过docker exec进入：

bash
docker exec -it nettools bash

更多信息

有关最新说明、包内容以及在GNS3中的使用等更多详细信息，请查看项目GitHub：https://github.com/Someguy123/docker-networktools