jtencioc/netbox

镜像概述

本镜像基于Alpine Linux构建，是一个轻量级网络故障排查工具集合。它集成了多种常用网络诊断工具，旨在为用户提供便捷的网络问题排查环境，适用于快速定位和解决网络连接、数据包传输、DNS解析等相关问题。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，启动速度快
• 工具集成：预装以下网络诊断工具：
  • net-tools：包含ifconfig、netstat等网络接口和连接状态查看工具
  • curl：HTTP/HTTPS请求工具，用于测试网络服务连通性
  • tcpdump：网络数据包捕获与分析工具
  • nmap：网络扫描工具，用于检测端口开放状态和服务信息
  • bind-tools：DNS查询工具集，包含dig、nslookup等

使用场景

• 网络连接故障排查（如无法访问特定服务）
• 网络数据包捕获与分析（如异常流量检测）
• 目标主机端口开放情况扫描
• DNS解析问题诊断
• 网络服务可用性验证

使用方法

基本使用

通过docker run命令启动容器并进入交互式shell环境：

bash
docker run -it --rm --name network-troubleshoot alpine-network-tools

参数说明：

• -it：以交互式终端模式运行
• --rm：容器退出后自动删除（适合临时排查任务）
• --name：指定容器名称（可选）

工具使用示例

1. 查看网络接口信息（使用net-tools）：

   bash
   ifconfig
   

2. 测试HTTP服务连通性（使用curl）：

   bash
   curl -I https://example.com  # 仅获取响应头
   curl https://example.com     # 获取完整响应内容
   

3. 捕获网络数据包（使用tcpdump）：

   bash
   tcpdump -i eth0  # 捕获eth0接口的所有数据包
   tcpdump port 80  # 仅捕获80端口的数据包
   

4. 扫描目标主机端口（使用nmap）：

   bash
   nmap example.com          # 基本端口扫描
   nmap -p 1-100 example.com # 扫描1-100端口范围
   

5. DNS查询测试（使用bind-tools）：

   bash
   dig example.com          # 查询A记录
   nslookup example.com     # 另一种DNS查询方式
   dig example.com MX       # 查询MX记录（邮件交换）
   

高级配置

如需在容器中持久化数据或共享主机网络命名空间（适用于更深入的网络排查），可使用以下命令：

bash
# 共享主机网络命名空间
docker run -it --rm --net=host --name network-troubleshoot alpine-network-tools

# 挂载本地目录（用于保存捕获的数据包文件）
docker run -it --rm -v $(pwd):/data --name network-troubleshoot alpine-network-tools

注意事项

• 部分工具（如tcpdump）可能需要额外的系统权限，建议在排查时根据需要添加--cap-add=NET_RAW等权限参数
• 容器默认以非root用户运行，如需执行需要root权限的操作，可使用--user root参数
• 完成排查后，建议使用exit命令退出容器，配合--rm参数确保资源清理